Skip to main content

Token balance RPC calls

GET 
/v1/data/token/balances/rpc-call

Prepares raw JSON-RPC eth_calls for fetching token balances using a batched balance-fetcher contract. Returns an rpcCallId and an array of rpcCalls that the integrator executes against their own RPC provider(s). The raw responses are then submitted to /token/balances/parse together with the rpcCallId. Two modes: single-chain (chainId + required assets; rpcCalls is a bare call array) and multi-chain (chains CSV, max 30; rpcCalls entries are { chainId, call }). In multi-chain mode assets is optional — it defaults to each chain's curated mainTokens from the token lists, keeping balance scans small even where full lists hold tens of thousands of tokens (max 200 assets per chain). Chains without any known main tokens are reported in skippedChains.

Plain-text reference — GET /v1/data/token/balances/rpc-call

Parameters

ParameterInTypeRequiredDescription
chainIdquerystringnoChain ID to fetch balances on (single-chain mode; required unless chains is given) See the ChainId schema for the full set of supported chains.
chainsquerystringnoComma-separated chain IDs (multi-chain mode, max 30). Takes precedence over chainId.
accountquerystringyesEVM account address (0x-prefixed, 40 hex chars)
assetsquerystringnoComma-separated token addresses. Required in single-chain mode; optional in multi-chain mode (defaults to each chain’s mainTokens; when given, applied to every chain).
blockTagquerystringnoBlock tag for the RPC call

Response 200

FieldTypeDescription
successTrue
dataobject
data.dataobjectInformational payload. null when the endpoint only builds calldata.
data.data.rpcCallIdstringUnique ID referencing the server-side cached context. Pass this to /parse together with the raw responses. Valid for 5 minutes.
data.data.rpcCallsobject[]Ordered list of JSON-RPC calls to execute against the target chain RPC. Each call uses multicall3 aggregate3.
data.data.rpcCalls[].methodstringJSON-RPC method name
data.data.rpcCalls[].paramsany[]JSON-RPC parameters (call object and block tag)
actionsnull

Example response

{
  "success": true,
  "data": {
    "data": {
      "rpcCallId": "string",
      "rpcCalls": [
        {
          "method": "eth_call",
          "params": []
        }
      ]
    }
  }
}

Request​

Responses​

Prepared RPC calls with a context ID for parsing