List Tokens
List all registered canonical token definitions. Filter the result set by CAIP-2 chain using the chain-id query parameter.
GET /tokens
GET /tokens?chain-id=eip155:1
Query Parameters
| Parameter | Type | Required | Description |
|---|
chain-id | string | No | Filter by CAIP-2 chain identifier. |
Response
Returns an array of TokenDefinition objects.
[
{
"symbol": "USDC",
"chainId": "eip155:1",
"address": "eip155:1:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6,
"metadata": null
}
]
Response Fields
| Field | Type | Description |
|---|
symbol | string | Canonical token symbol. |
chainId | string | CAIP-2 chain identifier. |
address | string | CAIP-10 account address for the token contract. |
decimals | integer | Token decimal places. |
metadata | string | null | Optional metadata URI or serialized payload. |
Errors
