post
https://public-api.birdeye.so/token/v1/holder/batch
Retrieve the token balance held by a list of wallet owners.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Check one token across many wallet owners.
- Request body accepts
token_addressandwallets. walletsmust contain 1 to 500 wallet addresses.- Response returns balance rows for wallets that hold the requested token.
ui_amount_mode=scaledapplies Solana Token-2022 scaled UI amount when the token supports scaled UI amount extension.
Reading the numbers. balance is the raw token balance before decimals. amount is the balance after decimals or Token-2022 scaled UI amount when requested and supported.
- Premium
- Business
- Enterprise
Solana
Use Cases 💡
- Check whether a curated wallet list holds a specific token without calling the single-holder endpoint repeatedly.
- Power holder verification workflows for watchlists, KOL wallets, smart wallets, or internal risk lists.
- Enrich wallet cohorts with token balances before ranking exposure or deciding who to monitor.
- Build batch screens that compare which tracked wallets accumulated or still hold a token.
How to Use 🛠️
- Send a JSON body with
token_addressand awalletsarray. - Keep each request between 1 and 500 wallet addresses.
- Set
ui_amount_mode=rawfor raw decimal-adjusted amounts, orui_amount_mode=scaledfor Solana Token-2022 scaled UI amounts when supported. - Match each returned
ownerback to your submitted wallet list.
Best Practices ✅
- Use batch holder checks when the wallet list is already known; use top-holder APIs when you need to discover holders.
- Deduplicate wallet addresses before calling the API to avoid wasted request size.
- Store zero or missing holders separately if your workflow needs to track wallets that do not currently hold the token.
- Pair batch balances with wallet PnL or transfer APIs when you need behavior, not just current exposure.
Limitations ⚠️
- Solana only.
- Requires Premium, Business, or Enterprise access.
- This endpoint checks one token per request; it is not a multi-token balance endpoint.
- Response includes current balances, not historical balance changes.