Skip to main content

​
Returns

​
Arguments

For EVM wallets, native balances are only available on networks with traces enabled.

EVM networks with traces enabled:Ethereum
BNB Chain (BSC)
Unichain
Polygon
Base
Story
Meld
Yominet
Ham
Berachain
Avalanche
Sanko
Arbitrum
Superposition
Optimism
Abstract
Monad

Balances are also unavailable on Sui (Network 101).

​
Usage Guidelines

  • Use walletAddress with the wallet address (ENS names are not supported)
  • Specify networks array to filter balances to specific chains (e.g., [1] for Ethereum)
  • Use tokens array to request specific token balances (max 200 tokens)
  • Use removeScams: true to filter out tokens flagged as scams
  • Use the cursor parameter for pagination through large token holdings

​
Troubleshooting Tips

Native balances (ETH, BNB, etc.) are only available on EVM networks with traces enabled. Check the list above to see if your network is supported. For Solana, native SOL balances are available.
balanceUsd may be null if we don’t have price data for that token. This can happen with very new or low-liquidity tokens. The raw balance and shiftedBalance fields will still be available.
Use the tokens parameter with an array of token IDs (address:networkId) or addresses. When using addresses only, you must also provide the networks parameter. Max 200 tokens per request.
No, balances queries a single wallet. To get balances for multiple wallets, make separate requests for each wallet address.
Wallets often receive airdropped scam tokens. Use removeScams: true to filter these out. You can also check the token.isScam field on individual results.