Get balances

Return the balance triple of normal (public stablecoin), confidential (cAROUSD; decrypted server-side for custodial wallets), and total, plus gas ETH, for every wallet or one wallet.

Confidential reads involve FHE decryption and are comparatively heavy; for frequent polling use GET /gas instead.

GET /balances

Get balances

cURL

curl --request GET \
  --url https://aropay.aro.media/api/v1/balances \
  --header 'Authorization: Bearer <token>'

200

{
  "ok": true,
  "data": {
    "balances": [
      {
        "wallet": {
          "id": "ckwlt0001abcd",
          "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
          "type": "CUSTODIAL",
          "label": "Payouts",
          "isPrimary": true,
          "createdAt": "2026-08-13T09:30:00.000Z"
        },
        "eth": {
          "amount": "0.05"
        },
        "normal": {
          "token": "AROUSD",
          "amount": "890.00"
        },
        "confidential": {
          "token": "cAROUSD",
          "amount": "65.00",
          "encrypted": false,
          "handle": "0x1f8e…"
        },
        "total": {
          "amount": "955.00",
          "currency": "USD"
        }
      }
    ]
  }
}

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.

Query Parameters

walletId · string

Restrict to a single wallet.

Response

200

application/json

Balance triples.

ok · any · required

data · object · required

Show child attributes