Get Available Tokens

Returns supported tokens across all chains or filtered by chain. Use this to discover tokens available for swaps.

Endpoint: GET /api/v1/tokens Auth: Required (Authorization: Bearer YOUR_API_KEY)

Query parameters

Parameter	Type	Required	Description	Example
chainRef	string	No	Filter by chain	eth-mainnet
q	string	No	Search by symbol or name	USDC
limit	integer	No	Max tokens to return (1–50000, default: 500)	50
cursor	string	No	Opaque cursor for pagination	next_cursor_value
supportedOnly	string	No	1 or true — only tokens supported for trading	1
requireLogo	string	No	1 or true — only tokens with a logo URL	true
sort	string	No	top, marketcap, trending, or asc	top
debug	string	No	1 or true — include debug info in response	1

Example

cURL

curl -X GET 'https://api.gateway.zert.com/api/v1/tokens?chainRef=eth-mainnet&limit=10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

Token fields

Field	Type	Description
chain	string	Chain identifier for the token
symbol	string	Canonical token symbol
name	string	Human-readable token name
address	string	EVM contract address when applicable
decimals	integer	Token decimals
mint	string	Solana mint address when applicable
logoUrl	string	Token logo URL when available
nextCursor	string or null	Cursor for the next page

Responses

Code	Description
200	List of tokens
400	Invalid request (e.g. invalid params)
401	Unauthorized (missing or invalid API key)
502	Quote-service token discovery unavailable

Zert APIsapi.gateway.zert.com

Zert API — Tokens