Wallet - Tokens Balance
curl --request POST \
--url https://public-api.birdeye.so/wallet/v2/token-balance \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"wallet": "GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6",
"token_addresses": [
"8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump"
]
}
'import requests
url = "https://public-api.birdeye.so/wallet/v2/token-balance"
payload = {
"wallet": "GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6",
"token_addresses": ["8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
wallet: 'GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6',
token_addresses: ['8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump']
})
};
fetch('https://public-api.birdeye.so/wallet/v2/token-balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"address": "8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump",
"decimals": 9,
"price": 0.0020303701828560256,
"balance": "4998929789571623824",
"amount": 4998929789.571624,
"network": "solana",
"name": "BIGIFTRUE",
"symbol": "BIGIFTRUE",
"logo_uri": "https://ipfs.io/ipfs/bafkreihgbhs4sumfhvdcquud7mvggjjbidfuoisytxqnpafrx6ukrh4hlm",
"value": "10149677.99093697"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Balance & Transfer
Wallet - Tokens Balance
Retrieve the balances of a list of tokens in a wallet.
POST
/
wallet
/
v2
/
token-balance
Wallet - Tokens Balance
curl --request POST \
--url https://public-api.birdeye.so/wallet/v2/token-balance \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"wallet": "GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6",
"token_addresses": [
"8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump"
]
}
'import requests
url = "https://public-api.birdeye.so/wallet/v2/token-balance"
payload = {
"wallet": "GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6",
"token_addresses": ["8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
wallet: 'GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6',
token_addresses: ['8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump']
})
};
fetch('https://public-api.birdeye.so/wallet/v2/token-balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"address": "8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump",
"decimals": 9,
"price": 0.0020303701828560256,
"balance": "4998929789571623824",
"amount": 4998929789.571624,
"network": "solana",
"name": "BIGIFTRUE",
"symbol": "BIGIFTRUE",
"logo_uri": "https://ipfs.io/ipfs/bafkreihgbhs4sumfhvdcquud7mvggjjbidfuoisytxqnpafrx6ukrh4hlm",
"value": "10149677.99093697"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
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 ⚙️
Compute Unit ⚙️
- Batch CU is calculated as
ceil(10 * wallet_count^0.8).
Use Cases 💡
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 🛠️
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.
Best Practices ✅
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 ⚠️
Limitations ⚠️
- Solana only.
- Maximum
50tokens per request.
Authorizations
API key for authentication
Headers
Solana network only.
Available options:
solana Body
application/json
Was this page helpful?

