Skip to main content
GET
GET /v1/search · 5 credits Token search by address, name or ticker, across any number of chains in one call. Results are ranked by relevance: the most significant token behind the text comes first. Native coins (ETH, SOL, BNB…) are part of the results. Optional sorting (liquidity, market cap, volume, newest) and filters. Results carry the token’s decimals, price, liquidity, market cap, 24h volume, 1h/24h price change and socials.

​
What you can type

​
Ranking

By default results are ranked by relevance. Relevance weighs how closely the text matches the ticker or the name with the depth and the 24h activity of the token’s market. A well-known token is found by its name as well as by its ticker: tether returns USDT, jupiter returns JUP. sortBy replaces the ranking with a plain sort. It applies to the whole search, not to a page already cut, so it changes which tokens come back. order=asc reverses any of them.

​
Chains

chain takes a list: chain=evm:1,evm:56,solana. EVM chains and Solana can be mixed in the same call. Without chain the search covers every chain.

​
Filters

liquidityMin, liquidityMax, marketCapMin, marketCapMax, volumeMin and volumeMax are USD bounds, inclusive. isOG=true keeps only the first token that used its ticker on its chain.

​
Native coins

ETH, SOL, BNB and the other native coins come back as rows of their chain, with the same price, market cap, liquidity, volume and socials as /v1/token for the coin. They are served under the chain’s native address: 0x0000000000000000000000000000000000000000 on EVM chains (0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee is accepted as input) and the SOL mint So11111111111111111111111111111111111111112 on Solana. A native coin has no market of its own, so its pool is null. With a chain list, every chain listed that carries the coin gets its row; without chain, a coin present on several chains (ETH) comes back once, on its home chain.

​
Socials

Every row carries socials: website, twitter and telegram, https links or null, the same links as /v1/token/metadata. No extra call, no extra credit.
volume24hUsd and priceChange1hPct/priceChange24hPct are token-wide - aggregated across every pool of the token - and referenced to the token’s close before each window.
pool is the token’s main market (canonical priority ranking: the deepest pool where the token is the priced asset, measured on both sides), the same pool /v1/token serves and the first row of /v1/token/pools. pool.factory is the launchpad key of the registry, the same value as on /v1/token and /v1/pulse. pool is null on a native coin.

Authorizations

​
Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

​
q
string
required

Token or pool address, name or ticker. Prefix a ticker with $ to match it exactly: $PEPE returns the tokens whose ticker is PEPE and nothing else.

Required string length: 1 - 100
​
chain
string

CSV of chain ids, EVM and Solana mixable. Omit to search every chain.

​
sortBy
string

relevance (default), liquidity, marketCap, volume (last 24h) or newest. The sort applies to the whole search, not to a page already cut: it changes which tokens come back.

​
order
string

desc (default) or asc.

​
limit
integer
default:12

1-50, default 12.

Required range: 1 <= x <= 50
​
liquidityMin
number

Minimum liquidity, USD.

Required range: x >= 0
​
liquidityMax
number

Maximum liquidity, USD.

Required range: x >= 0
​
marketCapMin
number

Minimum market cap, USD.

Required range: x >= 0
​
marketCapMax
number

Maximum market cap, USD.

Required range: x >= 0
​
volumeMin
number

Minimum 24h volume, USD.

Required range: x >= 0
​
volumeMax
number

Maximum 24h volume, USD.

Required range: x >= 0
​
isOG
boolean

true keeps only the first token that used its ticker on its chain.

​
chains
string
​
sort
string

Response

200

Standard { data, meta } envelope.