Skip to main content
GET
GET /v1/screener · 1 credit Every tradable market, paginated: filters by chain, sort by trending (relevance, the default), volume, market cap or creation time, cursor pagination. Each row is a market (chain + pool) with its identity, price, liquidity, market cap and windowed stats (5m, 1h, 6h, 24h). The discovery primitive - poll it to detect new markets.
sortBy=trending (default) ranks by relevance: 24h activity weighted by real participation, so a wash-traded market ranks below an organically traded one with the same figures. sortBy=volume is strictly ordered by the gross USD volume of window (default 24h, that is volume24hUsd descending; 5m, 1h, 6h rank on stats.<window>.volumeUsd). sortBy=marketCap ranks on marketCapUsd. window applies to volume only.
Each row carries priceNative/priceUsd, marketCapUsd, liquidityUsd, createdAt, the 24h headline figures (volume24hUsd, priceChange24hPct, txns, buys, sells) and stats, one object per window (5m, 1h, 6h, 24h) with seven fields named as in a Market Data window: volumeNative, volumeUsd, buys, sells, txns, feesNative and priceChangePct (the price change over the window, in percent). volume24hUsd, txns, buys and sells equal their stats.24h counterparts. sortBy=createdAt rows carry identity, price and market cap; windowed stats belong to the ranked listings. priceNative, priceUsd and marketCapUsd are null on a market that has not traded yet.
For trending/volume/marketCap, the universe is selected PER CHAIN: the top 300 markets by 24h USD volume plus the top 100 by 1h USD volume of that chain, among the markets that pass our quality filters (stablecoin, wrapped and native pairs, drained pools and wash-traded markets are left out), refreshed every few seconds and named in meta.universe. The two tops overlap, so a large chain lists between 300 and 400 markets; a smaller chain lists every eligible market among its most active ones. meta.chains lists every requested chain with markets (the size of its universe) and asOf (the time its figures were computed). Pages merge the chains on the rank key. The cursor pins, for each chain, the computation the page was cut from and resumes right after the last market it served: every page of a walk started within the last minute comes from the same figures, so a market is served exactly once whatever the ranks did since. meta.chains[*].asOf tells you which computation a page reflects.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
chains
string
required

CSV of public chain ids (1-8). sortBy=createdAt serves ONE chain per call (indexed walk) - fan out per chain.

​
sortBy
string
default:trending

trending (default), volume, marketCap or createdAt. trending is the relevance ranking: 24h activity weighted by real participation, so wash-traded markets rank below organically traded ones with the same figures. volume is strictly ordered by the gross USD volume of window (default 24h: volume24hUsd descending). trending/volume/marketCap rank within each chain's own universe (top 300 by 24h volume plus top 100 by 1h volume, named in meta.universe).

​
window
string

Rank window for sortBy=volume: 5m, 1h, 6h or 24h (default 24h). Not accepted with the other sorts (trending is a 24h relevance).

​
limit
integer
default:30

Rows per page (default 30, max 100).

Required range: 1 <= x <= 100
​
cursor
string

Opaque cursor from meta.nextCursor. Pins the computation each page was cut from, so a walk started within the last minute never skips or repeats a market.

Response

200

Standard { data, meta } envelope.