Discovery and markets API

Which liquidity pools are trending right now?

An activity-based (searches, trading) ranking of the pools trending now, in rank order, per chain or across chains: venue, base token, price, 24h change, volume, reserves, market cap, FDV.

GET/api/external/discovery/trending-pools

Get a free API key Try it in the API reference

What it returns

An activity-based (searches, trading) ranking of the liquidity pools trending right now, in rank order. basis picks the activity: trading (default) ranks pools on their trading over the trailing day — within one chain when chain is given, across every chain otherwise; searches ranks pools on how much they are being searched for. The order is the ranking's own and is never re-sorted here; rank is the position, and no underlying score is published.

`searches` is one short cross-chain list (4 pools when measured), with no price or price change. chain narrows THAT list rather than ranking within the chain, so it can answer count: 0; listSize is how many pools the list held, so a caller can tell "none of this chain on the list" from "nothing trending".

Trending is attention, not quality. For the biggest pools by volume or liquidity use top-pools; for the tokens trending, trending-tokens.

Chains

Ethereum ETH
BNB Chain BNB
Base BASE
Solana SOL
Robinhood Chain RHC
Stable STABLE
Arc ARC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/discovery/trending-pools"

Parameters
Parameter	Description
`basis` query · string · optional	The activity ranked on. `trading` (default): trading activity. `searches`: search interest.`tradingsearches`
`chain` query · string · optional	Basis `trading`: rank within this chain. Basis `searches`: keep only this chain's rows of the list. Omit for every chain.
`limit` query · integer · optional	How many pools to return from the top, 1 to 20. Defaults to 20.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Which liquidity pools are trending right now?
Field	Type	Description
`basis`	string	The activity ranked on.
`chain`	string \| null	The chain asked for, or null for every chain.
`listSize`	integer	How many pools the ranking held, before `limit` (and, on basis `searches`, before `chain`).
`count`	integer	How many rows are in `pools`.
`pools`	object[]	In rank order.
`pools[].rank`	integer	Position in the ranking, 1 = most trending. Kept when `chain` narrows basis `searches`, so gaps show.
`pools[].chain`	string \| null	The chain the pool trades on, or null when it is a chain this API does not publish.
`pools[].chainRef`	string	The chain identifier as ranked, e.g. `solana` or `bsc`. Always present, including when `chain` is null.
`pools[].poolAddress`	string	The pool (pair) address.
`pools[].name`	string \| null	The pool name, e.g. `WETH / USDC 0.05%`.
`pools[].dex`	string \| null	The venue the pool is on, e.g. `pumpswap`, `uniswap_v3`.
`pools[].baseToken`	object	The token the pool prices.
`pools[].baseToken.address`	string	The base token's mint or contract address.
`pools[].baseToken.symbol`	string \| null	Ticker.
`pools[].baseToken.name`	string \| null	Name.
`pools[].quoteTokenAddress`	string \| null	The quote token's address.
`pools[].priceUsd`	number \| null	Base token price in USD. Null on basis `searches`, which carries no price.
`pools[].priceChangePercent24h`	number \| null	Price change over the trailing 24h, in PERCENT (12.5 = +12.5 %). Null on basis `searches`.
`pools[].volumeUsd24h`	number \| null	Traded volume over the trailing 24h, USD.
`pools[].liquidityUsd`	number \| null	Pool reserves, USD.
`pools[].marketCapUsd`	number \| null	Base token market cap, USD. Null — never 0 — when it is not known; common on young tokens.
`pools[].fdvUsd`	number \| null	Base token fully diluted valuation, USD.

Price per call

Every call: 104 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Which liquidity pools on this chain are the biggest right now?
The biggest pools by volume or liquidity instead of the most attention.
One pool by its address
The full detail of one pool this ranks, by its address.
Which tokens are trending right now?
The tokens trending, with holders and chain-wide figures.
Which on-chain narratives are trending right now?
The sectors (cat, ai, x402, trump…) trading hardest right now by an activity-based ranking, with their combined market cap, liquidity, 24h volume and 5m/1h/6h/24h market-cap moves.
Which tokens are behind this trending narrative?
One trending sector (cat, ai, x402…) by id or name: its tokens on every chain with address, price, market cap and pool, plus the sector's own market cap, volume and momentum.
Order book heatmap for one coin on one exchange: resting orders by price
A coin's resting bids and asks at each price level on one exchange's futures or spot book, one snapshot per interval from one minute to one day, in coin units. Keyed by coin ticker.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key