Skip to main content

Get token balances for an account

GET 
/v1/data/token/balances

Fetches token balances for a given account on a specific chain, including USD values.

Features:

  • Automatically includes native token balance (ETH, BNB, etc.)
  • Fetches current prices for USD conversion
  • Returns both raw and formatted balance values

Response Structure:

  • balances: Array of balance entries for each token
  • count: Total number of balance entries

Balance Entry includes:

  • address: Token contract address (zeroAddress for native)
  • symbol: Token symbol
  • name: Token name
  • decimals: Token decimals
  • balanceRaw: Raw balance as string (wei/smallest unit)
  • balance: Formatted balance as decimal string
  • balanceUSD: Balance value in USD

Note: The native token balance is always included with address 0x0000000000000000000000000000000000000000.

Request​

Responses​

Token balances with USD values