List tokens

GET /tokens

List every token in the catalog, optionally filtered to one chain. Note the snake_case chain_id query parameter — this differs from GET /search-token, which takes camelCase chainId.

Authentication

Send your API key in the api-key header.

Parameters

Name	In	Type	Required	Description
chain_id	query	integer	no	Restrict results to this chain id. Note the snake_case name.

Responses

Status	Description
200	The token catalog (possibly filtered).
401	Missing or invalid API key. Plausible catalog codes behind the numeric status are AUTH_001 (unauthorized access) and AUTH_002 (invalid API key).
500	Unexpected server-side failure. Plausible catalog codes behind the numeric status include SYSTEM_002 (internal server error) and SYSTEM_001 (database operation failed).

200 response

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "chainId": 8453,
      "decimals": 6,
      "logoUrl": "https://assets.example.com/tokens/usdc.png",
      "name": "USD Coin",
      "symbol": "USDC"
    },
    {
      "address": "0x4200000000000000000000000000000000000006",
      "chainId": 8453,
      "decimals": 18,
      "logoUrl": "https://assets.example.com/tokens/weth.png",
      "name": "Wrapped Ether",
      "symbol": "WETH"
    }
  ]
}

401 response

{
  "code": 401,
  "data": null,
  "message": "missing api-key header"
}

500 response

{
  "code": 500,
  "data": null,
  "message": "internal server error"
}