List token balances

List the token balances of an address, with their USD values. Set refresh=true to read the balances from the chain. Page forward with limit and cursor: pass the previous response's nextCursor as cursor. This list does not page backward. Returns 400 on chains without token balances; check the token-balances feature on GET /v2/treasury/chains.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Chain family: evm (Ethereum and EVM chains), svm (Solana), tvm (Tron), utxo (Bitcoin and other UTXO chains), or xrp (XRP Ledger). The chain must belong to it. Not every endpoint accepts every ecosystem; see the operation description.

string
required

Chain alias, such as ethereum, avalanche-c, solana, tron, bitcoin or ripple, not a numeric chain ID. GET /v2/treasury/chains lists the canonical aliases of the chains you can use, and includes testnets with includeTestnets=true. Older aliases such as btc are also accepted.

string
required
length ≥ 1

On-chain address in the format of the chain the request names, in the path or the body: EVM 0x hex, Solana base58, Tron T… base58, Bitcoin bc1… or legacy (testnets tb1…), XRP r….

Query Params
integer
-9007199254740991 to 100
Defaults to 25

Number of token balances to return, 1 to 100. Defaults to 25.

string
length ≥ 1

Return the page after this cursor. Pass nextCursor from the previous page; omit it for the first page.

boolean
Defaults to false

Set to true to read the balances on this page from the chain instead of the last recorded balances. Defaults to false. A token with no recorded balance is always read from the chain.

boolean
Defaults to false

Set to true to include hidden tokens, marked hidden: true. Defaults to false.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json