Skip to main content
POST
Wallet - Tokens Balance

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.

  • Batch CU is calculated as ceil(10 * wallet_count^0.8).
  • 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.
  • 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.
  • 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.
  • Solana only.
  • Maximum 50 tokens per request.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

Solana network only.

Available options:
solana

Body

application/json
wallet
string
Example:

"GbrNi5tsbViArzsiE2WX94rMCCGz87w9cVVWVqcPEyx6"

token_addresses
string[]
Example:

Response

JSON object containing a wallet token balance

success
boolean
required

Whether the request succeeded.

data
object[]
required

Token balances returned for the requested wallet and token filter.