Get token list for a chain
GET/v1/data/token/list
Fetches the complete token list for a given chain, including metadata such as symbol, name, decimals, and asset group.
Response Structure:
tokens: Object keyed by token address (lowercase) containing token metadatacount: Total number of tokens in the list
Token Metadata includes:
symbol: Token symbol (e.g., "USDC")name: Full token name (e.g., "USD Coin")decimals: Token decimals (e.g., 6 for USDC)assetGroup: Asset grouping for price lookupslogoURI: Optional logo URL
Plain-text reference — GET /v1/data/token/list
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
chainId | query | string | yes | Chain ID to fetch token list for See the ChainId schema for the full set of supported chains. |
Response 200
| Field | Type | Description |
|---|---|---|
success | True | |
data | object | |
data.chainId | string | EVM chain id, as a decimal string. See the ChainId schema. |
data.count | integer | Total number of tokens |
data.tokens | object | Map of token address (lowercase) → token metadata |
actions | null |
Example response
{
"success": true,
"data": {
"chainId": "1",
"count": 1,
"tokens": {}
}
}
Request
Responses
- 200
- 400
- 429
- 500
- 502
Token list for the chain
Validation error
Rate limited. Unauthenticated callers share a per-IP budget; send an x-api-key header to lift it. Retry with exponential backoff.
Unexpected server error. Safe to retry with backoff.
An upstream data source or protocol origin failed (error.code is ORIGIN_FAILED). error.details carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.