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

custodial

curl --request POST \
  --url https://aropay.aro.media/api/v1/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "custodial"
}
'

201

{
  "ok": "<unknown>",
  "data": {
    "wallet": {
      "id": "<string>",
      "address": "<string>",
      "label": "<string>",
      "isPrimary": true,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  }
}

Authorizations

apiKeyAuthsessionCookie

Authorization · string · header · default: aro_sk_your_key_here · required

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

Custodial

External (raw address)

External (.nota address card)

type · any · required

label · string

Optional display label.

Response

201

application/json

Wallet created or registered.

ok · any · required

data · object · required

Show child attributes