v1
latestOpenAPI 3.1.02026-07-13570316.1 KBGet Wallet Tokens
Retrieves token balances for a specific wallet address across one or more blockchain networks. This endpoint provides comprehensive token data including ERC-20 tokens with their balances, metadata, and price information. Results can be filtered by chain, sorted by balance or USD value, and customized to include/exclude spam tokens, native tokens, and tokens without price data. Supports pagination and metadata resolution options.
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 token 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 token data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137
Token addresses to filter by. If provided, only tokens with these addresses will be returned.
Token addresses to filter by. If provided, only tokens with these addresses will be returned.
The number of tokens to return per chain (default: 20, max: 500).
The number of tokens to return per chain (default: 20, max: 500).
The page number for pagination (default: 1, max: 20).
The page number for pagination (default: 1, max: 20).
Whether to include token metadata (default: true).
Whether to include token metadata (default: true).
Whether to resolve metadata links to fetch additional token information (default: true).
Whether to resolve metadata links to fetch additional token information (default: true).
Whether to include tokens marked as spam (default: false).
Whether to include tokens marked as spam (default: false).
Whether to include native tokens (e.g., ETH, MATIC) in the results (default: true).
Whether to include native tokens (e.g., ETH, MATIC) in the results (default: true).
Field to sort tokens by: 'balance' for token balance, 'token_address' for token address, 'token_price' for token price, 'usd_value' for USD value (default: usd_value).
Field to sort tokens by: 'balance' for token balance, 'token_address' for token address, 'token_price' for token price, 'usd_value' for USD value (default: usd_value).
Sort order: 'asc' for ascending, 'desc' for descending (default: desc).
Sort order: 'asc' for ascending, 'desc' for descending (default: desc).
Whether to include tokens without price data (default: true).
Whether to include tokens without price data (default: true).
Response
Wallet tokens retrieved successfully. Returns token data with metadata including pagination information and chain details. Includes token balances, metadata, and price information when available. Results are sorted by the specified criteria (default: USD value descending) and filtered according to the provided parameters.