# Options DEX API > Live on-chain crypto options trading volume — the decentralized options market where protocols like Derive, Aevo, Premia, Ithaca and Rysk let users trade calls and puts on-chain, powered by the public DeFiLlama options feed, no key, nothing stored. This is distinct from a centralized options exchange order book: it measures the volume actually flowing through on-chain options venues. The overview endpoint returns the whole on-chain options market's volume over the last 24 hours, 7 days and 30 days plus every protocol ranked by what it trades, measured as notional (contract face value, the default) or premium (what option buyers actually paid). The protocol endpoint returns a single protocol's notional and premium volume side by side across 24h / 7d / 30d / all-time. The chain endpoint returns the options volume and top venues for one blockchain. See which on-chain options venue leads and how DeFi options flow shifts. This is the on-chain options-volume cut of DeFi — distinct from the centralized options-chain, spot-DEX, swap-aggregator, fees and perpetual APIs in the catalogue. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/optionsdex-api/..." ``` ## Pricing - **Free** (Free) — 14,500 calls/Mo, 3 req/s - **Desk** ($9/Mo) — 180,000 calls/Mo, 10 req/s - **Pro** ($26/Mo) — 830,000 calls/Mo, 28 req/s - **Scale** ($60/Mo) — 2,900,000 calls/Mo, 65 req/s ## Endpoints ### Overview #### `GET /v1/overview` — On-chain options market volume + ranked protocols **Parameters:** - `metric` (query, optional, string) — notional (default) or premium Example: `notional` - `limit` (query, optional, string) — Max protocols (1-300) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/optionsdex-api/v1/overview?metric=notional&limit=50" ``` **Response:** ```json { "data": { "note": "Notional = contract face value traded (USD).", "metric": "notional", "source": "DeFiLlama", "total_d7": 365100078, "protocols": [ { "d7": 292762642, "d30": 1212451371, "h24": 20131794, "name": "Derive Options", "chains": [ "Derive Chain" ], "category": "Options" }, { "d7": 26828314, "d30": 148443558, "h24": 1173990, "name": "Rysk V12", "chains": [ "Hyperliquid L1" ], "category": "Options" }, { "d7": 31028390, "d30": 34289900, "h24": 289290, "name": "CallPut", "chains": [ "Base" ], "category": "Options" }, { "d7": 6628531, "d30": 32432657, "h24": 210890, "name": "Aevo Options", "chains": [ "Ethereum" ], "category": "Options" }, { "d7": 4502789, "d30": 21944890, "h24": 37945, "name": "Hypersurface", "chains": [ …(truncated, see openapi.json for full schema) ``` ### Protocol #### `GET /v1/protocol` — One protocol notional & premium volume **Parameters:** - `protocol` (query, required, string) — DeFiLlama options protocol slug Example: `derive` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/optionsdex-api/v1/protocol?protocol=derive" ``` **Response:** ```json { "data": { "name": "Derive", "slug": "derive", "chains": [ "OP Mainnet", "Arbitrum", "Derive Chain" ], "source": "DeFiLlama", "category": null, "premium_volume": { "d7": 16543591, "d30": 45063388, "h24": 600187, "all_time": 466967213 }, "notional_volume": { "d7": 292762642, "d30": 1212451371, "h24": 20131794, "all_time": 17452429305 } }, "meta": { "timestamp": "2026-06-11T16:46:42.698Z", "request_id": "53fcb3f6-bdcf-432f-aeb1-e5cb61aad019" }, "status": "ok", "message": "Protocol retrieved successfully", "success": true } ``` ### Chain #### `GET /v1/chain` — Options volume + top venues for a chain **Parameters:** - `chain` (query, required, string) — DeFiLlama chain slug Example: `arbitrum` - `metric` (query, optional, string) — notional (default) or premium Example: `notional` - `limit` (query, optional, string) — Max protocols (1-200) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/optionsdex-api/v1/chain?chain=arbitrum&metric=notional&limit=25" ``` **Response:** ```json { "data": { "chain": "arbitrum", "metric": "notional", "source": "DeFiLlama", "total_d7": 335825, "protocols": [ { "d7": null, "d30": 807097, "h24": null, "name": "Hegic", "chains": [ "Arbitrum" ], "category": "Options" }, { "d7": null, "d30": null, "h24": null, "name": "Premia V2", "chains": [ "Ethereum", "Arbitrum", "Fantom", "OP Mainnet" ], "category": "Options" }, { "d7": null, "d30": null, "h24": null, "name": "Derive V1", "chains": [ "OP Mainnet", "Arbitrum" ], "category": "Options" }, { "d7": null, "d30": null, "h24": null, "name": "Rysk V1", "chains": [ "Arbitrum" ], "category": "Options" }, { "d7": null, "d30": null, "h24": null, "name": "Premia V3", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/optionsdex-api/v1/meta" ``` **Response:** ```json { "data": { "note": "metric=notional (contract face value, default) or premium (what buyers paid). Amounts are USD. protocol/chain are DeFiLlama slugs (derive, aevo, ethereum, arbitrum).", "source": "DeFiLlama options (api.llama.fi/overview/options & /summary/options, live)", "service": "optionsdex-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/chain": "Options volume and top venues for one chain (chain=arbitrum, metric=notional).", "GET /v1/overview": "Whole on-chain options market volume plus protocols ranked (metric=notional|premium, limit=50).", "GET /v1/protocol": "One protocol's notional and premium volume side by side (protocol=derive)." }, "description": "Live on-chain crypto options trading volume from DeFiLlama — the decentralized options market (Derive, Aevo, Premia, Ithaca, Rysk) where users trade calls and puts on-chain, distinct from a centralized options exchange. The overview endpoint returns the whole on-chain options market volume (24h/7d/30d) plus protocols ranked, measured as notional (contract face value, default) or premium (paid by buyers); the protocol endpoint returns one protocol's notional and premium side by side; the chain endpoint returns options volume and top venues for one blockchain. Live, no key, nothing stored. The on-chain options-volume cut of DeFi — distinct from the centralized options-chain, spot-DEX, swap-aggregator …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/optionsdex-api OpenAPI spec: https://www.oanor.com/api/optionsdex-api/openapi.json