curl --request POST \
--url https://aropay.aro.media/api/v1/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "custodial"
}
'{
"ok": true,
"data": {
"wallet": {
"id": "ckwlt0001abcd",
"address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
"type": "CUSTODIAL",
"label": "<string>",
"isPrimary": true,
"createdAt": "2023-11-07T05:31:56Z"
}
}
}{
"ok": false,
"error": {
"code": "wallet_limit_reached",
"message": "You already have 10 wallets."
}
}{
"ok": false,
"error": {
"code": "invalid_api_key",
"message": "Invalid API key."
}
}{
"ok": false,
"error": {
"code": "account_disabled",
"message": "This account is disabled."
}
}{
"ok": false,
"error": {
"code": "wallet_exists",
"message": "This address is already registered in the sandbox."
}
}{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Too many requests. Try again shortly."
}
}{
"ok": false,
"error": {
"code": "internal_error",
"message": "An unexpected error occurred."
}
}Wallets
Create wallet
Create a custodial wallet (server-generated EOA, key encrypted at
rest) or register an external watch-only address. For external
wallets pass either address or nota (a Notareum address
card), never both. Accounts can hold at most 10 wallets; the first
becomes primary.
POST
/
wallets
curl --request POST \
--url https://aropay.aro.media/api/v1/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "custodial"
}
'{
"ok": true,
"data": {
"wallet": {
"id": "ckwlt0001abcd",
"address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
"type": "CUSTODIAL",
"label": "<string>",
"isPrimary": true,
"createdAt": "2023-11-07T05:31:56Z"
}
}
}{
"ok": false,
"error": {
"code": "wallet_limit_reached",
"message": "You already have 10 wallets."
}
}{
"ok": false,
"error": {
"code": "invalid_api_key",
"message": "Invalid API key."
}
}{
"ok": false,
"error": {
"code": "account_disabled",
"message": "This account is disabled."
}
}{
"ok": false,
"error": {
"code": "wallet_exists",
"message": "This address is already registered in the sandbox."
}
}{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Too many requests. Try again shortly."
}
}{
"ok": false,
"error": {
"code": "internal_error",
"message": "An unexpected error occurred."
}
}Authorizations
apiKeyAuthsessionCookie
AroPay API key, sent as Authorization: Bearer aro_sk_…. Created in
the dashboard under Settings → API keys. Takes precedence over a
session cookie when both are present.
Body
application/json