Search tokens

GET /search-token

Search the token catalog by symbol, name, or exact address. Matching is case-insensitive; symbol and name match on substrings, while an address must match exactly. Optionally restrict results to one chain with chainId (camelCase here, unlike GET /tokens which takes chain_id).

Authentication

Send your API key in the api-key header.

Parameters

Name	In	Type	Required	Description
query	query	string	yes	Search text — a symbol or name fragment, or a full token address.
chainId	query	integer	no	Restrict results to this chain id.

Responses

Status	Description
200	Matching tokens (possibly empty).
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"
    }
  ]
}

401 response

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

500 response

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