get_balances_v4
Retrieve token balances (fungible, NFTs, multitokens) for specified wallet addresses across multiple blockchains. Use chain name and addresses to fetch detailed token information and metadata.
Instructions
[blockchain_data] /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: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addresses | Yes | The blockchain public wallet addresses. It is possible to enter list of up to 10 addresses as a comma separated string. | |
| chain | Yes | The blockchain to work with. | |
| excludeMetadata | No | The option to exclude metadata from the response. | |
| offset | No | The offset to obtain next page of the data. | |
| pageSize | No | The number of items per page (default is 50). | |
| tokenTypes | No | The option to select only specific token types. It is possible to enter list of multiple types as a comma separated string. Use fungible (ERC-20), nft (includes ERC-721 and ERC-1155) or multitoken (ERC-1155 only). |