Sign in
Search

Token Symbol Resolution

Resolves an exact token ticker symbol to likely contract address candidates on supported chains.

Use this before calling token endpoints that require a contract address. Pass a returned chain + address only to endpoints that support that chain.

Results are ranked by Surf registry, listing, and market signals. volume_usd is kept for response compatibility, always returns 0, and must not be used as a candidate ordering signal.

Included fields: symbol, chain, address, decimals, volume_usd.

Chains: Ethereum, Base, BSC, Arbitrum, Solana, Polygon, Optimism, Avalanche, Fantom, Tron, Linea, Mantle, Blast, Gnosis, zkSync, Scroll.

get/gateway/v1/search/token

Query parameters

qstring required

Exact token ticker symbol to resolve (case-insensitive), like USDC or PEPE. NOT a contract address, trading pair, or fuzzy token name.

Example:USDC

Exact token ticker symbol to resolve (case-insensitive), like USDC or PEPE. NOT a contract address, trading pair, or fuzzy token name.

chain'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'solana' | 'polygon' | 'optimism' | 'avalanche' | 'fantom' | 'tron' | 'linea' | 'mantle' | 'blast' | 'gnosis' | 'zksync' | 'scroll'

Restrict resolution to one supported chain. Omit to search all supported chains.

Example:solana

Restrict resolution to one supported chain. Omit to search all supported chains.

limitinteger

Results per page

Example:20

Results per page

offsetinteger

Pagination offset

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseSearchTokenItem.json"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.