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": "0x63C12667638f2Ae6fC6ae09B43D98Ec84a8586eA",
  "token_addresses": [
    "0xb773ec2c326b7f98a5a83fc098825492f020a4c7"
  ]
}
'

{
  "success": true,
  "data": [
    {
      "address": "0xb773ec2c326b7f98a5a83fc098825492f020a4c7",
      "decimals": 9,
      "balance": "10000000000",
      "amount": 10,
      "price": 500,
      "valuation_price": 200,
      "value": "2000",
      "network": "robinhood",
      "name": "Staked NET",
      "symbol": "SNET",
      "logo_uri": ""
    }
  ]
}

POST

wallet

token-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": "0x63C12667638f2Ae6fC6ae09B43D98Ec84a8586eA",
  "token_addresses": [
    "0xb773ec2c326b7f98a5a83fc098825492f020a4c7"
  ]
}
'

{
  "success": true,
  "data": [
    {
      "address": "0xb773ec2c326b7f98a5a83fc098825492f020a4c7",
      "decimals": 9,
      "balance": "10000000000",
      "amount": 10,
      "price": 500,
      "valuation_price": 200,
      "value": "2000",
      "network": "robinhood",
      "name": "Staked NET",
      "symbol": "SNET",
      "logo_uri": ""
    }
  ]
}

Usage Note
Accessibility
Chain Supported

Batch token-balance lookup for one Solana wallet.

Maximum request size is 500 token addresses.
Response is ordered by the submitted token list and returns one balance snapshot per requested token.
ui_amount_mode=scaled applies 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.

Compute Unit ⚙️

Batch CU is calculated as ceil(10 * wallet_count^0.8).

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 50 token mints in the POST body.
Use ui_amount_mode=raw for raw-decimal output or ui_amount_mode=scaled for Token-2022 scaled UI amounts when supported.

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 ⚠️

Robinhood returns raw balances as decimal strings; missing holdings may be returned as null entries.
Maximum 50 tokens per request.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana or Robinhood. Robinhood supports balance-change, current-net-worth, V1/V2 token balance and /defi/v3/token/holder. Other wallet history and transfer endpoints have separate chain support.

Available options:

solana,

robinhood

Body

application/json

wallet

string

required

Example:

"GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6"

token_addresses

string[]

required

Token mint/contract addresses; use x-chain to select Solana or Robinhood. This release does not accept tokens/token_id entries.

Required array length: 1 - 500 elements

Example:

[
  "8i42ZVsjEGVhZ6spj4Z5aB36Msh9Vq4nnBaw5kq4pump"
]

Response

JSON object containing a wallet token balance

success

boolean

required

Whether the request succeeded.

data

(object | null)[] | null

required

Requested token holdings. Missing holdings may be null entries; data may be null when no requested holding exists.

Show child attributes