Get token balances of addresses

/v4/data/balances

50 credits per API call

📘

Note for v3 API users:

As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/balances. Users can refer to GET /v4/data/balances for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.

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.