Get user token balances

get

Get token balances for the authenticated user from private balance sources. Requires the user session token (JWT) issued by the authenticate endpoint, passed as Authorization: Bearer <token>.

Path parameters

apiKeystringRequired

API key generated at https://studio.aurora.dev

Query parameters

tokenIdsstringOptional

Comma-separated list of token IDs to query. If empty, returns all non-zero balances.

Example: nep141:wrap.near,nep141:usdc.near

Responses

200

Token balances retrieved successfully

application/json

Token balances retrieved successfully

400

Default Response

application/json

401

User session token is invalid or expired

application/json

500

Internal Server Error - Failed to reach the account service

application/json

get/api/account/balances/{apiKey}

HTTPcURLJavaScriptPython

GET /api/account/balances/{apiKey} HTTP/1.1
Host: intents-api.aurora.dev
Accept: */*

{
  "balances": [
    {
      "tokenId": "nep141:wrap.near",
      "available": "1000000000000000000000000",
      "source": "private"
    }
  ]
}