Chains API
Which protocols lead this chain by DEX volume, fees or revenue?
One chain's protocols ranked by DEX trading volume, fees paid or protocol revenue in USD over the last 24 hours, 7 days or 30 days.
/api/external/chain-analysis/chain-protocol-rankings/{chain}What it returns
One chain's protocols ranked by the metric chosen with metric, over the trailing window in window, largest first. volume is what was traded on each exchange on the chain, fees what users paid each protocol there, revenue the part of those fees the protocol kept. chainTotalUsd is the chain's own total for the same metric and window; the protocol figures need not add up to it. A protocol with no figure for the window is left out rather than ranked as zero, so protocolsRanked can be smaller than the number of protocols on the chain. On a chain younger than 30 days, the 30-day figures can equal the 7-day ones.
Chains
- Solana SOL
- BNB Chain BNB
- Ethereum ETH
- Stable STABLE
- Base BASE
- Robinhood Chain RHC
- 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/chain-analysis/chain-protocol-rankings/SOL"
| Parameter | Description |
|---|---|
metricquery · string · optional | What to rank by. volume: DEX trading volume. fees: what users paid. revenue: the part of the fees the protocol kept. Defaults to volume.volumefeesrevenue |
windowquery · string · optional | The trailing window the figures cover: the last 24 hours, 7 days or 30 days. Defaults to 24h.24h7d30d |
limitquery · integer · optional | How many protocols to return, 1 to 100. Defaults to 25. |
chainpath · string · required | The chain to query. CELO, ARB, OP and SCROLL return 400 here. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
chain | string | The chain asked about. |
metric | string | What the protocols are ranked by. |
window | string | The window the figures cover. |
chainTotalUsd | number | null | The chain's own total for the metric and window, in USD. null when not reported. |
protocolsRanked | integer | How many protocols carry a figure for the window, before limit is applied. |
protocols | object[] | Largest first; ties ordered by slug. |
protocols[].rank | integer | 1 for the largest figure. |
protocols[].slug | string | The protocol's id, lowercase and hyphenated. |
protocols[].name | string | The protocol's display name. |
protocols[].category | string | null | What kind of protocol it is (for example Dexs, Trading App, Launchpad). null when not reported. |
protocols[].usd | number | The protocol's figure on this chain over the window, in USD. |
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