Skip to main content

Parse token balances

POST 
/v1/data/token/balances/parse

Accepts the raw hex RPC response obtained by executing the call from /token/balances/rpc-call and decodes it into structured token balance data with USD values.

Workflow:

  1. Call /token/balances/rpc-call to get prepared RPC calls and a rpcCallId
  2. Execute the RPC call against your own node
  3. Send rpcCallId + rawResponses to this endpoint for parsing

The rpcCallId ties the response back to the cached preparation context (valid for 5 minutes). After successful parsing the cached context is deleted.

Response Structure:

  • items: 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

Request​

Responses​

Token balances with USD values