Discovery and markets API

Which liquidity pools belong to this on-chain sector, and which are biggest?

One on-chain sector (jail, ai-agents, clanker-world…) by id or name: its pools ranked by 24h volume, liquidity or trades, each with price, reserves, FDV and its own chain. Optionally one chain only.

GET/api/external/discovery/sector-pools/{id}

Get a free API key Try it in the API reference

What it returns

Every liquidity pool filed under one on-chain sector (jail, ai-agents, clanker-world, robinhood-tokenized-securities…), by sector id or display name in any case, ranked largest first by 24h volume, pool liquidity or 24h trades. A sector spans chains — one sector answered pools on four different chains — so each row carries its own chain, null where this API does not serve it, and chain narrows the answer to one of them. These sector ids are the ON-CHAIN taxonomy and are NOT the ids sectors publishes; the two id spaces never overlap. total is how many pools match before limit, and complete is false when the sector has more pools than one request reads, in which case the ranking covers only what was read. A subject that names no sector returns 404.

Chains

Solana SOL
BNB Chain BNB
Ethereum ETH
Stable STABLE
Base BASE
Robinhood Chain RHC
Arc ARC
Celo CELO
Arbitrum ARB
Optimism OP
Scroll SCROLL

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/sector-pools/<id>"

Parameters
Parameter	Description
`sort` query · string · optional	What to rank by, largest first: 24h `volume24h`, pool `liquidity`, or 24h `transactions24h`. Pools without the ranked figure come last. Defaults to volume24h.`volume24hliquiditytransactions24h`
`limit` query · integer · optional	How many pools to return. Defaults to 20, at most 100.
`chain` query · string · optional	Keep only the pools on this chain. Omit for every chain the sector spans. A sector with no pool on the chain asked for answers an empty list, not a 404.
`id` path · string · required	An on-chain sector, by id (e.g. "jail", "ai-agents") or by display name (e.g. "Jail"), in any case — not a token mint, contract address or protocol slug. These ids are the on-chain taxonomy and are not the ids the market-sector listing uses.

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 belong to this on-chain sector, and which are biggest?
Field	Type	Description
`id`	string	The sector's id, whichever id or name was asked for.
`name`	string \| null	Display name of the sector.
`description`	string \| null	What the sector is, in the words of the taxonomy that defines it.
`volume24hUsd`	number \| null	The whole sector's trailing 24h volume in USD, across every pool it files.
`liquidityUsd`	number \| null	The whole sector's pooled liquidity in USD.
`fdvUsd`	number \| null	The whole sector's fully diluted valuation in USD.
`transactions24h`	number \| null	Trades across the whole sector over the trailing 24h.
`sort`	string	The ranking answered.
`total`	integer	How many pools matched, before `limit`.
`complete`	boolean	True when every pool the sector files was read, so the ranking is the sector's real top. False when the sector is larger than one request reads.
`pools`	object[]	Largest first by `sort`; pools without that figure last.
`pools[].pool`	string	The pool's address on its own chain.
`pools[].chain`	string \| null	The chain the pool trades on. Null when the pool is on a chain this API does not serve.
`pools[].name`	string \| null	The pair as the sector lists it, e.g. `Clav / SOL`.
`pools[].dexId`	string \| null	The DEX the pool belongs to, e.g. `pumpswap`.
`pools[].baseTokenAddress`	string \| null	The base token of the pair.
`pools[].quoteTokenAddress`	string \| null	The quote token of the pair.
`pools[].priceUsd`	number \| null	Price of the base token in USD.
`pools[].liquidityUsd`	number \| null	Pool reserves in USD. 0 means drained; null means no reading.
`pools[].volume24hUsd`	number \| null	Trailing 24h traded volume in USD.
`pools[].transactions24h`	number \| null	Trades in the pool over the trailing 24h.
`pools[].priceChange24hPct`	number \| null	24h price change in percent (4.5 = +4.5 %).
`pools[].fdvUsd`	number \| null	Fully diluted valuation of the base token in USD.
`pools[].marketCapUsd`	number \| null	Market cap of the base token in USD. Usually null on these rows.
`pools[].createdAt`	integer \| null	When the pool was created, in Unix SECONDS (not milliseconds).

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