get
https://public-api.birdeye.so/v1/wallet/token_balance
Retrieve the balance of a token in a wallet.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Current balance of one token in one wallet.
- Provide one wallet address and one token mint address.
- Response is a current balance snapshot, not a historical balance series.
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 token balance in base units. amount is the decimal-adjusted balance, or the scaled UI amount when requested and supported. price is the latest token price in USD, and value is the wallet position value in USD.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
- This endpoint consumes
10 CUper request.
Use Cases 💡
- Show the exact balance of one token in one wallet.
- Build portfolio widgets, treasury views, or token-position popovers.
- Check current exposure before deeper PnL or transfer analysis.
How to Use 🛠️
- Set
x-chain=solana. - Pass the wallet in
walletand the mint intoken_address. - Use
ui_amount_mode=rawfor raw-decimal output orui_amount_mode=scaledfor Token-2022 scaled UI amounts when supported.
Best Practices ✅
- Use this endpoint for single-token checks; use
Wallet - Tokens Balancewhen you already have a list of many mints. - Keep
ui_amount_modeconsistent across token balance, holder, and transfer analysis for scaled UI tokens. - Cache responses briefly if multiple views in the same screen need the same balance snapshot.
Limitations ⚠️
- Solana only.
- Beta endpoint.
- Returns the current balance only, not balance history.