post
https://public-api.birdeye.so/wallet/v2/token-balance
Retrieve the balances of a list of tokens in a wallet.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Batch token-balance lookup for one Solana wallet.
- Maximum request size is
500token addresses. - Response is ordered by the submitted token list and returns one balance snapshot per requested token.
ui_amount_mode=scaledapplies Solana Token-2022 scaled UI amount when the token supports the scaled UI extension.
Reading the numbers. balance is the raw balance in base units. amount is the decimal-adjusted balance, or scaled UI amount when requested and supported. price is the latest token price in USD, and value is the wallet holding value in USD.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
- Batch CU is calculated as
ceil(10 * token_count^0.8).- With the maximum
500tokens per request
- With the maximum
Use Cases 💡
- Load many token balances for one wallet in one request.
- Power portfolio pages, treasury views, and token-watch grids.
- Join wallet balances with prices for fast position-value displays.
How to Use 🛠️
- Set
x-chain=solana.- Send the wallet address and up to
50token mints in the POST body. - Use
ui_amount_mode=rawfor raw-decimal output orui_amount_mode=scaledfor Token-2022 scaled UI amounts when supported.
- Send the wallet address and up to
Best Practices ✅
- Deduplicate token mints before sending the batch.
- Use this batch endpoint for known token sets; use broader wallet portfolio endpoints when discovery matters more than exact token selection.
- Reuse one batch response across multiple UI components during the same refresh cycle.
Limitations ⚠️
- Solana only.
- Maximum
50tokens per request.
- Maximum