Skip to main content
GET
Token - Search
Search tokens by name, symbol, or address across all supported chains. Supports fuzzy matching and pagination.
Related: MCP: token_search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor
string

Pagination cursor

limit
integer<int64>
default:20

Number of results per page

direction
enum<string>
default:next

Pagination direction

Available options:
next,
prev
chains
string[]

Chain filter

q
string

Search query string for token name, symbol or address

sort
enum<string>
default:desc

Sort direction Sort direction (case-insensitive: accepts "asc"/"ASC"/"Asc" etc.)

Available options:
asc,
desc
protocols
string[]

Protocol filter

sortBy
enum<string>

Field to sort by

Available options:
marketCapInUsd,
liquidityInUsd,
priceInUsd,
holderCount,
h24VolumeInUsd,
h24Transactions,
tokenCreatedAt
mode
enum<string>
default:fast

Search mode: fast (default, returns basic fields) or normal (returns full token details) Search mode: fast returns only OpenSearch fields (default), normal enriches with full data.

Available options:
fast,
normal

Response

200 - application/json

Search

Token search result page — mirrors TS TokenPage.

data
object[]
required

List of tokens

durationMs
integer<int64> | null

Search duration in milliseconds

Required range: x >= 0
endCursor
string | null

Cursor for the end of current page

Example:

"eyJpZCI6ImVuZCJ9"

hasNext
boolean

Whether there is a next page

Example:

false

hasPrev
boolean

Whether there is a previous page

Example:

false

searchId
string | null

Search session identifier (UUID)

startCursor
string | null

Cursor for the start of current page

Example:

"eyJpZCI6InN0YXJ0In0="