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

HTTP	Type	When
500	TokenRegistryServiceError	Unexpected token registry error.