Skip to main content
POST
Token - Holder (Batch)

Check one token across many wallet owners.

  • Request body accepts token_address and wallets.
  • wallets must contain 1 to 500 wallet addresses.
  • Response returns balance rows for wallets that hold the requested token.
  • ui_amount_mode=scaled applies 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.

  • Batch CU is calculated as ceil(30 * wallet_count^0.8).
  • 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.
  • Send a JSON body with token_address and a wallets array.
  • Keep each request between 1 and 500 wallet addresses.
  • Set ui_amount_mode=raw for raw decimal-adjusted amounts, or ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when supported.
  • Match each returned owner back to your submitted wallet list.
  • 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.
  • 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.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

Solana network only.

Available options:
solana

Query Parameters

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

Body

application/json

Request body for retrieving one token balance across multiple wallet owners.

wallets
string[]
required

Wallet owner addresses to check. Supports 1 to 500 wallets per request.

Wallet owner address.

Example:
token_address
string
required

Token mint address to check in each wallet.

Example:

"So11111111111111111111111111111111111111112"

Response

JSON object containing token balances held by a list of wallet owners

Response containing token balances for a list of wallet owners.

success
boolean
required

Indicates whether the request was successful.

data
object
required

Token balances for the requested wallet owners.