Discovery and markets API

Protocol share history brief: the leading protocols of a category or chain

The 10 protocols earning the most fees, revenue or DEX volume of a DeFi category or chain, with totals and a few points.

GET/api/external/discovery/protocol-share-history-brief

Get a free API key Try it in the API reference

What it returns

The brief of protocol-share-history; prefer it unless you need every day or more protocols. The same metric, category, chain and window: the 10 largest protocols by total over the window, in that endpoint's ranking, each with its total and at most 30 of its daily points evenly spaced over its days, the first and the newest always kept. partsRanked still counts every protocol the window names.

Chains

Solana SOL
Ethereum ETH
BNB Chain BNB
Base BASE
Stable STABLE
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/discovery/protocol-share-history-brief"

Parameters
Parameter	Description
`metric` query · string · optional	`fees`: what users paid. `revenue`: what the protocols kept, with `category=lending` or no category. `volume`: DEX trading volume, with `category=dexs` or no category. Defaults to `fees`.`feesrevenuevolume`
`category` query · string · optional	Only protocols of this kind: `lending`, `dexs` (exchanges), `liquid-staking`, `derivatives`, `launchpad` or `dex-aggregator`. Omit for every kind, which then needs `chain`.`lendingdexsliquid-stakingderivativeslaunchpaddex-aggregator`
`chain` query · string · optional	Only figures on this chain; with a category, for `lending` and `dexs` only. Omit for every chain, which then needs `category`.
`days` query · string · optional	How many trailing days to return, or `all` for the whole series. Defaults to 90.`73090180365all`
`limit` query · integer · optional	How many protocols to return, largest first, 1 to 50. Defaults to 10.

Response fields

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

Response fields of Protocol share history brief: the leading protocols of a category or chain
Field	Type	Description
`metric`	string	The series returned.
`category`	string \| null	The category asked about, or `null` for every kind of protocol.
`chain`	string \| null	The chain asked about, or `null` for every chain.
`days`	string	The window returned.
`partsRanked`	integer	How many protocols the window names, before `limit` is applied.
`parts`	object[]	The 10 largest protocols at most, largest total first; ties ordered by name.
`parts[].name`	string	The protocol, by display name (e.g. `Aave V3`).
`parts[].pointCount`	integer	Days in the part's full series over the window.
`parts[].totalUsd`	number \| null	The sum of the protocol's day totals over the window, in USD, to the cent: over every point, not only the ones listed. Can be negative for `revenue`.
`parts[].points`	object[]	At most 30 of the part's points, evenly spaced over the days that name it, oldest first; the first and the newest are always kept.
`parts[].points[].timestamp`	integer	Unix seconds, 00:00 UTC of the day.
`parts[].points[].usd`	number	The protocol's total that day, in USD.

Price per call

Every call: 101 credits

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

Which protocols earn the fees or DEX volume of a category or chain, over time?
The full answer this one condenses
How have DeFi fees, revenue or DEX volume moved, overall or by category?
The same category as one total per day.
How have DEX volume, fees and revenue on this chain moved?
The same chain's fees, revenue or volume as one total per day.
How much value do price oracles secure over time?
Daily DeFi value secured by price oracles in USD, all oracles or one (Chainlink, Pyth, RedStone and more), overall or on one chain, over 7 to 365 days or all history.
Which price oracles does DeFi rely on, and which protocols use each?
Price oracles ranked by the DeFi value they secure today in USD (Chainlink, Pyth, RedStone and more), each with the protocols it secures, across every chain or on one.
What crypto does this public company or government hold, and what did it pay?
One public company or government treasury by id, name or ticker: coins held, value, cost, unrealized P&L, mNAV, and its 100 most recent buys and sells with price paid.

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