Perpetuals API
One coin's options open interest and volume, venue by venue
A coin's options open interest in contracts and USD on each venue and in total, with each venue's share, its 24-hour change and its 24-hour volume.
/api/external/perps/options-markets/{symbol}What it returns
One coin's OPTIONS market right now: the total across every venue, and one row per venue with its open interest in contracts and in USD, its share of the total, how that open interest moved over the last 24 hours, and its 24-hour volume — ordered by USD open interest, largest first. Only the handful of coins with a listed options market answer; every other well-formed ticker is a 404. This is options, not perpetual futures: derivatives-open-interest answers the same question for futures. symbol is the coin ticker, matched case-insensitively — not an instrument id, not a token mint or contract address, and not scoped to any of this API's chains.
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-markets/<symbol>"
| Parameter | Description |
|---|---|
symbolpath · string · required | The coin (base asset) ticker, e.g. "BTC", "ETH" or "SOL" — not an instrument id such as "BTC-27JUN25-100000-C", and not a token mint or contract address. Case-insensitive. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
symbol | string | The coin, upper-cased (e.g. "BTC"). |
total | object | null | The figures summed across every venue. null when no total was stated. |
total.openInterestQuantity | number | null | Open interest in contracts, in units of the coin. |
total.openInterestUsd | number | null | The same open interest, USD. |
total.openInterestSharePercent | number | null | This venue's share of the coin's options open interest, percent, rounded as the source states it — the venue figures need not sum to exactly 100. |
total.openInterestChangePercent24h | number | null | Change of the open interest over the last 24 hours, percent. |
total.volumeUsd24h | number | null | Options volume over the last 24 hours, USD. |
total.volumeChangePercent24h | number | null | Change of that volume over the last 24 hours, percent. Stated on the total only; null on a venue. |
venues | object[] | One row per venue, by openInterestUsd descending; venues without that figure last. |
venues[].venue | string | The options venue, e.g. "Deribit" or "CME". |
venues[].openInterestQuantity | number | null | Open interest in contracts, in units of the coin. |
venues[].openInterestUsd | number | null | The same open interest, USD. |
venues[].openInterestSharePercent | number | null | This venue's share of the coin's options open interest, percent, rounded as the source states it — the venue figures need not sum to exactly 100. |
venues[].openInterestChangePercent24h | number | null | Change of the open interest over the last 24 hours, percent. |
venues[].volumeUsd24h | number | null | Options volume over the last 24 hours, USD. |
venues[].volumeChangePercent24h | number | null | Change of that volume over the last 24 hours, percent. Stated on the total only; null on a venue. |
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