Discovery and markets API

Which market sectors are largest and how did each move today?

Every crypto sector (memes, AI, layer 1, RWAs…) with its combined market cap, 24h volume, 24h cap change and top three coins, ranked by any of them.

GET/api/external/discovery/sectors

What it returns

Every sector of the crypto market with the combined market cap and 24h volume of its coins, the sector's 24h market-cap change and its three largest coins, ranked largest first by market cap, volume or change. Sectors overlap (a coin sits in several), so their figures never add up to the whole market, and a sector's 24h change is computed on its own and can differ widely from the whole market's. About half the sectors carry no figures at all: they rank last with nulls. total is how many sectors exist before limit.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

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/sectors"
Parameters
ParameterDescription
sort

query · string · optional

What to rank by, largest first: marketCap, 24h volume, or 24h market-cap change24h. Defaults to marketCap.marketCapvolumechange24h
limit

query · integer · optional

How many sectors to return. Defaults to 100; 1000 returns every one. limit ≤ 100 keeps the answer under 32 KB.

Response fields

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

Response fields of Which market sectors are largest and how did each move today?
FieldTypeDescription
sortstringThe ranking answered.
totalintegerHow many sectors exist, before limit.
sectorsobject[]Largest first; sectors without the ranked figure last.
sectors[].idstringThe sector's id, e.g. layer-1.
sectors[].namestring | nullDisplay name.
sectors[].marketCapUsdnumber | nullCombined market cap of the sector's coins, in USD. Null for a sector no figure is kept for.
sectors[].volumeUsd24hnumber | nullCombined trailing 24h trading volume of the sector's coins, in USD. Null where none was recorded.
sectors[].marketCapChangePercent24hnumber | null24h change of the sector's market cap, in percent (4.5 = +4.5 %). Null without a market cap.
sectors[].topCoinIdsstring[]Ids of the sector's largest coins, largest first, up to three. Empty for an untracked sector.
sectors[].updatedAtstring | nullWhen the sector's figures were last computed (ISO 8601). Null for an untracked sector.

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