v1
latestOpenAPI 3.1.02026-07-13570316.1 KBGet Balance
Get native or ERC20 token balance for a wallet address. Can retrieve live balances for any ERC20 token on a signle chain, or native token balances across multiple chains.
Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.
Path parameters
A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
Query parameters
Chain ID(s) to request balance data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137
Chain ID(s) to request balance data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137
The token contract address. Omit for native token (ETH, MATIC, etc.).
The token contract address. Omit for native token (ETH, MATIC, etc.).
Response
Wallet native balances retrieved successfully. Returns detailed native token balance information for each chain including token metadata and formatted values.