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. Sort by liquidity, market cap, volume, holders, all-time high or any figure of the row, and filter with the Screener’s filters. Results carry the token’s price, liquidity, market cap, 1h and 24h figures (volume, fees, buys, sells, transactions, price change), socials, holders, bonding progress, creator, taxes and token flags, and all-time high.

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; a token whose sort value is unknown comes last in both orders. The volume sorts always consider the most traded tokens matching the text, whatever their liquidity: a small token with a large volume is not left out. top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount, the risk.* fields and the creator.* fields filter the results but are not sort keys (INVALID_PARAM on sortBy).

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. The list applies to an address as well: 0x4200000000000000000000000000000000000006 with chain=evm:57073 returns the WETH of Ink only.

Filters

filters takes the filter tree of the Screener, sent as URL-encoded JSON: { "<field>": { "<operator>": <value> } }, combined with AND, OR and NOT at any depth, with the same operators, the same field names and the same rule for unknown values (a token whose value is unknown never passes a numeric bound). The flat filters of the Screener work too, and combine with filters: liquidityMin, liquidityMax, marketCapMin, marketCapMax (USD), volumeMin, volumeMax, feesMin, feesMax (USD, over timeframe), txnsMin, txnsMax (over timeframe), ageMin, ageMax (minutes since the token’s first market), bondingMin, bondingMax, socials, factories, dexes (venue keys, see dexesByChain on GET /v1/meta/factories: the tokens whose market has no launchpad and runs on one of those venues; with factories, either), isOG=true (the first token that used its ticker on its chain) and excludeCategories (a list of token categories to leave out, below). Bounds are inclusive; a minimum above its maximum returns an empty list.
Keywords, taxes and activity
The names of the search row work too: stats.<window>.<field>, volume24hUsd, volume1hUsd, priceChange1hPct, priceChange24hPct, iconUrl, socials.website, socials.twitter, socials.telegram, the Screener’s short names (factory, holders, top10, sellTaxBps…) and bonded, bondingPercentage, deployerTokensCount, deployerMigrationsCount. A field the search rows do not carry is refused by name with INVALID_PARAM (details.param, details.field, details.reason), never ignored: totalSupply, circulatingSupply, priceNative, liquidityNative, metadata.dexPaid, the quote of the pool and the creator’s identity (filter them on GET /v1/screener), the other windows (windows.5m.*…), the wallet counts of a window (windows.1h.traders…), and snipers, proTraders, smartTraders, bundlers and insiders, with the same message as on the Screener. Filters apply to an exact address search too: q=<address> with a filter returns the token only when it passes. timeframe (1h or 24h, default 24h) is the window of the bare counters (volumeUsd, feesUsd, buys, sells, txns, priceChangePct), of volumeMin, volumeMax, txnsMin, txnsMax, feesMin, feesMax, and of sortBy=volume.

Completeness

meta.complete is false when a token matching your filters may be missing from the page: the search looks at the best matches of the text, and a very common text, a sort by a figure (volume, holders, any field) or a narrow filter can leave tokens out, or a figure a filter reads was not available yet (retry after a few seconds). Narrow the text or the chains, or raise limit, to search deeper. meta.complete is also false when the holder figures (top10HoldersPct, top25HoldersPct, devHoldingsPct and the other holder and label fields) or the risk block of a row were not available yet: they are null on that row, and a retry after a few seconds serves them. meta.complete is true when nothing is missing.

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, where 0x0000…0000 and 0xeeee…eeee also find SOL. On search rows a native coin’s pool is its main USD market, the same pool as on /v1/token. 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. A native coin carries its priceChange1hPct and priceChange24hPct: the coin’s USD price change over the last hour and the last 24 hours, the same change as /v1/token and /v1/token/stats. Wrapped native coins (WETH, WBNB…) carry the same change as their coin. A native coin’s createdAt is null: it has no trading pool of its own.

Majors and stablecoins

Majors, stablecoins and wrapped native coins (WETH, WBNB, USDC, USDT, UNI…) show the same priceUsd, liquidityUsd, volume24hUsd and pool as /v1/token: their liquidity and volume cover their markets, not a single pool. A wrapped native coin is priced as one native coin.

Socials

Every row carries socials: website, twitter, telegram and discord, https links or null, the same links as /v1/token/metadata (discord is its discordUrl); links, every other link of the token’s profile (TikTok, Reddit, GitHub, docs…), each { type, label, url }, the links of /v1/token/metadata (null when the token has no profile, [] when its profile has no other link); and uri, the token’s metadata URI (see the row fields). No extra call, no extra credit. Native coins, wrapped natives (WETH, WBNB…) and the main quote stablecoins of each chain (USDC, USDT, DAI…) carry the logo (iconUrl) and official links of their asset.

1h and 24h figures

Every row carries stats.1h and stats.24h: volumeUsd and feesUsd (the fees paid by traders: network fees, plus validator tips and trading-terminal fees on Solana), buys, sells and txns, token-wide (every pool of the token: txns counts each transaction once, even when it trades through several of them or buys and sells in one go, so it can be lower than buys + sells; on Solana buys and sells count transactions too), and priceChangePct, the price change of the token’s main market (the row’s pool, the market of /v1/token). A token that did not trade in the window shows 0; a figure is null only when it is unknown. volume24hUsd, volume1hUsd, priceChange1hPct and priceChange24hPct are the same numbers as stats.24h.volumeUsd, stats.1h.volumeUsd, stats.1h.priceChangePct and stats.24h.priceChangePct.

Holders, launchpad and creator

Every row carries the same figures as the token’s own endpoints: Native coins carry holdersCount: null, bondingProgress: 0, migrated: false and creator: null; their holder shares, taxes and all-time high are null.

Token categories

Every row carries category, the category of its token in our asset registry, the same value as on the Screener rows: coin (a chain’s native coin and its wrapped or bridged versions, BTC), stablecoin, staked (liquid staking tokens, yield-bearing dollars), commodity (tokenized gold), stock (tokenized stocks and ETFs, pre-IPO shares) or token (a listed asset of no other kind); null when the token is in none of them, the case of most launchpad and DEX tokens. Native coins are coin. On Solana, the category also covers the tokens of Jupiter’s verified list by their tags. excludeCategories leaves out the results of the listed categories, comma-separated among the six values above: q=intel&excludeCategories=stock finds the memecoins named after Intel, not the tokenized stock. A result with category: null is never left out. The exclusion applies to the whole search, like a filter: the page is refilled with the next matches, and meta.complete follows the usual rules. An unknown value is refused with INVALID_PARAM.

Taxes, token flags and all-time high

Every row carries risk, the token’s taxes and flags, the block of the Screener and Pulse rows: buyTaxBps, sellTaxBps, transferTaxBps in basis points, isHoneypot, transferPausable, balanceMutable, modifiableTax, on Solana mintRevoked, freezeRevoked, and on EVM chains the contract flags isMintable, isBlacklisted, isNotOpenSource, selfDestruct, upgradeableProxy (the values of /v1/token/security). A field that is not known is null, never a made-up 0 or false. A tax filter keeps only the tokens whose tax is known; when a tax is not known yet, meta.complete says so. priceNativeAth (plain decimal text, in the chain’s native coin), priceUsdAth and marketCapAthUsd are the token’s all-time high, the same values as /v1/token. null when there is no credible high. listed says whether CoinGecko lists the token, the metadata.listed of /v1/token: true, false, or null when unknown. Filter on it with filters={"metadata.listed":{"equals":true}} (alias listed).

Creation date

createdAt is when the token’s first trading pool opened, in milliseconds: the first market where the token trades, launchpad curve included, the same value as /v1/token. It is null on a native coin. ageSeconds and ageMin / ageMax count from it. tokenCreatedAt repeats it under the name of the Screener and Pulse rows; poolCreatedAt is the creation of the row’s pool and lastTradeAt its last trade (ms, null while it has not traded since its creation; on EVM chains a liquidity add or removal moves it too, as on the Screener and Pulse rows). lastTradeAt on /v1/token is another reading: the token’s latest swap across its markets. All four filter and sort, for example sortBy=lastTradeAt.

Pagination

limit is 1 to 50 (default 12). offset skips that many results before the page (default 0). A search pages down to its 50th result: offset is below 50 (INVALID_PARAM otherwise) and the page that reaches result 50 is served cut there (offset=40&limit=12 returns at most 10 results); a deeper page would widen the set of candidates the search reads. meta.offset echoes it, meta.hasMore says whether a result follows the page within those 50, and meta.nextOffset gives the next page’s offset whenever hasMore is true. Figures move between two calls, so two pages can repeat or skip a token.
volume24hUsd and volume1hUsd are token-wide - aggregated across every pool of the token. priceChange1hPct/priceChange24hPct follow the token’s main market, the one its price comes from, and are referenced to its close before each window. Majors, stablecoins and native coins show the volume of their markets, the same as /v1/token/stats.
organicVolume24hUsd is the part of volume24hUsd that is not wash trading: a wallet that buys AND sells the token in the same transaction is excluded. Measured on Solana; null where it is not measured, and whenever volume24hUsd is null.
marketCapUsd follows /v1/token: the circulating supply × price, where the circulating supply of a token outside the majors, stablecoins and native coins is its total supply minus the tokens held by burn addresses.
pool is the token’s main market, the same pool /v1/token serves and the first row of /v1/token/pools. A row’s liquidityUsd is the liquidity of its pool (for majors, stablecoins and wrapped natives, of all their markets, as below), and liquidityMin, liquidityMax and sortBy=liquidity read it; /v1/token serves the token’s liquidity across its most traded markets. Searching a pool address returns its token on that pool, on every chain: pool is the pool searched, with its own liquidity. For a wrapped native coin it is the coin’s main USD market, as on /v1/token. pool.factory is the launchpad key of the registry, the same value as on /v1/token and /v1/pulse: a token that graduated from a launchpad keeps its launchpad; pool.factoryAddress is the on-chain address that created the pool. On a native coin, pool is its main USD market, the pool of /v1/token. tokenAddress repeats address and poolAddress repeats pool.address (null when pool is), as on every row (Identity fields).

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 (over timeframe, 24h by default), volume1h (last hour), newest, holders (most holders first), or any number of the row: priceNativeAth, priceUsdAth, marketCapAthUsd, priceUsd, nameRank, bondingProgress, windows.1h.<field>, windows.24h.<field> (volumeUsd, feesUsd, buys, sells, txns, priceChangePct; a bare counter reads timeframe). The sort applies to the whole search, not to a page already cut: it changes which tokens come back. The volume sorts always consider the most traded tokens matching the text, whatever their liquidity. A token whose sort value is unknown comes last. The holder shares, risk.* and creator.* filter but do not sort.

order
string

desc (default) or asc.

limit
integer
default:12

1-50, default 12.

Required range: 1 <= x <= 50
offset
integer

Results to skip before the page (default 0, below 50); a page never goes past result 50 (the last one is cut there). Figures move between two calls: two pages can repeat or skip a token

Required range: 0 <= x <= 49
timeframe
string

1h or 24h (default 24h): the window of volumeUsd, feesUsd, buys, sells, txns, priceChangePct written bare (in filters and sortBy), of the flat volume, transactions and fees filters, and of sortBy=volume.

filters
string

Filter tree as URL-encoded JSON, the Screener's grammar: {"<field>":{"<operator>":<value>}}, combined with AND, OR and NOT. Operators: equals, not, in, gt, gte, lt, lte, contains, startsWith, endsWith. Fields: chain, address, name, symbol (keywords, ignoring letter case), nameRank, priceUsd, marketCapUsd, liquidityUsd, priceNativeAth, priceUsdAth, marketCapAthUsd, createdAt, tokenCreatedAt, poolCreatedAt, graduatedAt, lastTradeAt, ageSeconds, volumeUsd, feesUsd, buys, sells, txns, priceChangePct (over timeframe), windows.1h.<field>, windows.24h.<field>, pool.address, pool.type, pool.factory, bondingProgress, migrated, metadata.<iconUrl|websiteUrl|twitterUrl|telegramUrl|listed>, holdersCount, top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct, proTradersAllTimeCount, creator.<address|launchedCount|migratedCount>, risk.<buyTaxBps|sellTaxBps|transferTaxBps|isHoneypot|mintRevoked|freezeRevoked|transferPausable|balanceMutable|modifiableTax|isMintable|isBlacklisted|isNotOpenSource|selfDestruct|upgradeableProxy>. A field the rows do not carry is refused by name (INVALID_PARAM with details.field and details.reason), with the Screener's message.

ageMin
number

Minutes since the token's first market (createdAt).

Required range: x >= 0
ageMax
number

Minutes since the token's first market (createdAt).

Required range: x >= 0
liquidityMin
number

Minimum liquidityUsd of the row (the liquidity of its pool), USD.

Required range: x >= 0
liquidityMax
number

Maximum liquidity, USD. A minimum above its maximum returns an empty list.

Required range: x >= 0
marketCapMin
number

Minimum market cap, USD.

Required range: x >= 0
marketCapMax
number

Maximum market cap, USD.

Required range: x >= 0
bondingMin
number

Percent of the launchpad bar (bondingProgress), 0 to 100.

Required range: x >= 0
bondingMax
number

Percent of the launchpad bar (bondingProgress), 0 to 100.

Required range: x >= 0
volumeMin
number

Minimum volume over timeframe (24h by default), USD.

Required range: x >= 0
volumeMax
number

Maximum volume over timeframe (24h by default), USD.

Required range: x >= 0
txnsMin
number

Minimum transactions over timeframe.

Required range: x >= 0
txnsMax
number

Maximum transactions over timeframe.

Required range: x >= 0
feesMin
number

Minimum fees paid by traders over timeframe, USD.

Required range: x >= 0
feesMax
number

Maximum fees paid by traders over timeframe, USD.

Required range: x >= 0
socials
string

any (at least one link), or a CSV of twitter, telegram, website that must all be there.

factories
string

CSV of launchpad keys (pool.factory, see /v1/meta/factories).

dexes
string

CSV of venue keys (see dexesByChain on /v1/meta/factories): the tokens whose market has no launchpad and runs on one of these venues. With factories, the tokens of either.

isOG
boolean

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

labeledDev

true or 1: only tokens whose creator is a labeled person (creator.labeled); false or 0: no filter

Available options:
true
excludeCategories
string

CSV of token categories to leave out, among coin, stablecoin, staked, commodity, stock, token (the category of the rows, from the asset registry; on Solana also Jupiter's verified list by its tags). Applied to the whole search like a filter; a result whose category is null is never left out.

chains
string
sort
string

Response

200

Standard { data, meta } envelope.