Perpetuals API

How big is the options market next to futures, for BTC and ETH, by day?

Options open interest as a percentage of futures open interest for bitcoin and ether, one point per day since June 2020.

GET/api/external/perps/options-futures-oi-ratio

Get a free API key Try it in the API reference

What it returns

How large the options market is next to the futures market, one point per UTC day, oldest first: btcPct is bitcoin's options open interest across every options venue as a percentage of its futures open interest across every futures venue, and ethPct the same for ether. Daily from June 2020 to today; a few days are missing, and a missing day is simply absent. Only BTC and ETH are published. For one coin's options open interest venue by venue use options-history; for its futures open interest, derivatives-open-interest-history.

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/options-futures-oi-ratio"

Parameters
Parameter	Description
`limit` query · integer · optional	How many of the most recent days to return, 1 to 3000. Defaults to 100; 3000 answers the whole history. limit ≤ 600 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 How big is the options market next to futures, for BTC and ETH, by day?
Field	Type	Description
`points`	object[]	Oldest first; the last is today.
`points[].at`	integer	The day's 00:00 UTC, unix seconds.
`points[].btcPct`	number \| null	BTC options open interest as a percentage of BTC futures open interest that day (e.g. 86.5 means options hold 86.5 % as much open interest as futures). null when there is no reading.
`points[].ethPct`	number \| null	ETH options open interest as a percentage of ETH futures open interest that day (e.g. 86.5 means options hold 86.5 % as much open interest as futures). null when there is no reading.

Price per call

Every call: 6 credits

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

One coin's options open interest or volume over time, per venue
One coin's options open interest venue by venue, the numerator of this ratio.
One coin's open interest across all venues, as candles over time
One coin's futures open interest over time, the denominator.
Liquidation heatmap brief: strongest liquidation levels above and below price
A coin's price and the price levels with the most US dollars modelled to liquidate, top 10 above and below it.
Perpetual-futures markets, all of them
Every perpetual-futures market this surface covers, with its current state. A MARKET is keyed by trading symbol, not by chain and mint — these are derivatives, not tokens you hold.
One perpetual-futures market, by symbol
The current state of ONE perpetual-futures market, keyed by trading SYMBOL. No chain, no mint — an unrecognised symbol is refused rather than guessed at.
Open positions in one perpetual-futures market
The positions currently open in ONE perpetual-futures market, keyed by trading symbol. Answers who is exposed and on which side, not what a token is worth.

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