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.
Language
Credentials
Header
Click Try It! to start a request and see the response here!