Wallet - Token Balance (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/token_balance \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/token_balance"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/token_balance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "decimals": 9,
    "balance": 130718,
    "uiAmount": 0.000130718,
    "chainId": "solana-mainnet",
    "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
    "name": "Wrapped SOL",
    "symbol": "SOL",
    "priceUsd": 186.17611361160655,
    "valueUsd": 0.024336569219081984,
    "isScaledUiToken": false,
    "multiplier": null
  }
}

GET

wallet

token_balance

Wallet - Token Balance (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/token_balance \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/token_balance"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/token_balance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "decimals": 9,
    "balance": 130718,
    "uiAmount": 0.000130718,
    "chainId": "solana-mainnet",
    "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
    "name": "Wrapped SOL",
    "symbol": "SOL",
    "priceUsd": 186.17611361160655,
    "valueUsd": 0.024336569219081984,
    "isScaledUiToken": false,
    "multiplier": null
  }
}

Usage Note
Accessibility
Chain Supported

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=scaled applies 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.

Compute Unit ⚙️

This endpoint consumes 20 CU per 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 wallet and the mint in token_address.
Use ui_amount_mode=raw for raw-decimal output or ui_amount_mode=scaled for Token-2022 scaled UI amounts when supported.

Best Practices ✅

Use this endpoint for single-token checks; use Wallet - Tokens Balance when you already have a list of many mints.
Keep ui_amount_mode consistent 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.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

required

A chain name listed in supported networks.

Available options:

solana

Query Parameters

wallet

string

required

The address of a wallet.

token_address

string

required

Token mint address.

ui_amount_mode

enum<string>

default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled

Response

JSON object containing the balance and USD value for a single token holding.

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes