Perpetuals API
Which on-chain options protocols trade the most?
Ranks on-chain options protocols by premium or notional volume in USD over 24 hours, 7 or 30 days, across every chain or on one chain.
/api/external/perps/options-protocol-volumeWhat it returns
Every on-chain options protocol the record follows, ranked by its options volume over the last 24 hours, 7 days or 30 days (window), largest first. measure=premium is what buyers paid for the options; measure=notional is the size of the underlying they were written on, much larger. With chain, each figure is the protocol's volume on that chain only. A protocol with no figure for the window is left out; one whose figure is 0 is kept. protocolsRanked says how many carry a figure before limit. A chain no options protocol runs on answers an empty protocols. Each slug is the one protocol-history takes for that protocol's daily options volume. For one coin's options on the major venues, centralised ones included, see options-markets.
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/perps/options-protocol-volume"
| Parameter | Description |
|---|---|
measurequery · string · optional | premium: what option buyers paid. notional: the size of the underlying the options were written on. Defaults to premium.premiumnotional |
windowquery · string · optional | The trailing window the volume is summed over. Defaults to 24h.24h7d30d |
chainquery · string · optional | Only each protocol's volume on this chain. Omit for every chain. |
limitquery · 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.
| Field | Type | Description |
|---|---|---|
measure | string | The volume returned. |
window | string | The window returned. |
chain | string | null | The chain asked about, or null for every chain. |
protocolsRanked | integer | How many protocols carry a figure for the window, before limit. |
protocols | object[] | Largest first; ties ordered by name. Empty when no protocol carries a figure. |
protocols[].slug | string | The protocol, by the slug protocol-history takes. |
protocols[].name | string | The protocol, by display name (e.g. Derive Options). |
protocols[].usd | number | Premium or notional volume over the window, 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