Perpetuals API

The market-wide derivatives indices by day, with one coin's whale index

The derivatives risk index and derivatives market index as one daily series, oldest first, plus one coin's signed whale index on the same days when a ticker is given.

GET/api/external/perps/derivatives-indices

Get a free API key Try it in the API reference

What it returns

Two market-wide leveraged-derivatives indices as one daily series, one point per UTC day, oldest first: riskIndex, how stretched the derivatives market is (higher means more risk; whole numbers, from March 2022), and marketIndex, the derivatives market level, based at 1000 on 1 January 2024. Naming a coin in symbol adds whaleIndex, that coin's own daily whale index on the same days: a SIGNED reading of how the largest accounts are positioned, negative as often as positive. A day a series does not reach is null in that column, never 0 — the three series start on different dates, and the market index is missing 1 March 2026. The newest day is normally still running (complete: false) and its values still move. symbol is a coin ticker (e.g. "BTC", "ETH", "SOL"), matched case-insensitively; a coin with no whale index answers 404, so leave symbol off to get the market-wide indices alone.

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/perps/derivatives-indices"

Parameters
Parameter	Description
`symbol` query · string · optional	Optional coin ticker to add the whale-index column, e.g. "BTC" — not a trading pair such as "BTCUSDT", and not a token mint or contract address. Case-insensitive. Left off, the answer carries the two market-wide indices and `whaleIndex: null`.
`limit` query · integer · optional	How many of the most recent days to return, 1 to 1000. Defaults to 100. limit ≤ 300 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 The market-wide derivatives indices by day, with one coin's whale index
Field	Type	Description
`symbol`	string \| null	The coin the whale column was read for, upper-cased, or null when none was asked.
`points`	object[]	Oldest first.
`points[].at`	number	The day's 00:00 UTC, unix seconds.
`points[].riskIndex`	number \| null	The market-wide derivatives risk index that day — higher means more risk. Whole numbers; the series starts in March 2022. null on a day it does not cover.
`points[].marketIndex`	number \| null	The market-wide derivatives market index that day, based at 1000 on 1 January 2024. null on a day it does not cover, 1 March 2026 included.
`points[].whaleIndex`	number \| null	The asked coin's whale index that day, signed: positive and negative readings are both normal. null on every day when no coin was asked, and on a day before the coin's series starts.
`points[].complete`	boolean	Whether the day has ended. false only on the newest day, still running when read.

Price per call

Every call: 11 creditsbase; varies with symbol

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

One coin's open interest right now, venue by venue and in total
How much leverage is actually open behind the risk reading.
One coin's funding rate across all venues, as candles over time
What that leverage costs, day by day, on the same coin.
Max-pain liquidation level, per coin
Every coin's single most-leveraged long and short liquidation price and the USD sitting at each — one row per coin, sortable by how close price is to triggering it.
Price change and swing amplitude across short timeframes, per coin
Every coin's percent price change AND high-low swing at 5m, 15m, 30m, 1h, 4h, 12h and 24h — one row per coin, sortable by the widest swing or the biggest move.
Indicator history for one derivatives instrument: RSI, MACD, Bollinger, ATR, TD
How a technical indicator read candle by candle for one perpetual or future on one venue, at the width and look-back you ask for. The only endpoint with Bollinger Bands.
Which perp protocols hold the most open interest?
Ranks perpetual-futures protocols and their frontends by open interest in USD, with the readings 1, 7 and 30 days back, and the total with frontends counted once.

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