Get token balances of addresses

/v4/data/balances

50 credits per API call

This endpoint is deprecated.

📘

Note:

We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoints - GET /v3/data/balances & GET /v4/data/balances - have been deprecated.
These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible.

Get balances of fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains:

• Celo - celo / celo-testnet
• Ethereum - ethereum / ethereum-sepolia / ethereum-holesky
• BNB (Binance) Smart Chain - bsc / bsc-testnet
• Polygon - polygon
• Tezos - tezos-mainnet
• Chiliz - chiliz-mainnet

To get started:

• Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more.
• Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true).
• If not specified, the API returns balances for all supported types of tokens (fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes.
• For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata.