# Crypto Derivatives Exchanges API > Live ranking and directory of crypto derivatives venues — the platforms that run perpetual and futures markets — served from the public CoinGecko feed with no key and nothing cached. This is a venue-level view of the derivatives market, distinct from spot-exchange directories, per-contract open-interest feeds and single-exchange tickers: it ranks the derivatives platforms themselves. The exchanges endpoint returns the venues ranked by open interest (or by 24-hour volume), each with its open interest in BTC, 24-hour derivatives volume in BTC, the number of perpetual and futures pairs it lists, its country and the year it was established — so one call tells you who the biggest derivatives venues are and how concentrated open interest is. The exchange endpoint returns a single venue's full profile by id. The list endpoint returns every derivatives-exchange id and name for lookup and autocomplete. Everything is read live from CoinGecko on each request, nothing stored beyond a short protective cache. Ideal for derivatives dashboards, open-interest and market-structure analytics, venue comparison and trading tools. Live, no key. 3 endpoints. For per-contract funding and open-interest history use a derivatives or open-interest API. ## 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/derivativesexchanges-api/..." ``` ## Pricing - **Free** (Free) — 5,500 calls/Mo, 2 req/s - **Starter** ($8/Mo) — 97,000 calls/Mo, 6 req/s - **Pro** ($23/Mo) — 510,000 calls/Mo, 18 req/s - **Business** ($55/Mo) — 3,150,000 calls/Mo, 45 req/s ## Endpoints ### Derivatives #### `GET /v1/exchange` — One venue full profile **Parameters:** - `id` (query, required, string) — Derivatives exchange id Example: `binance_futures` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/derivativesexchanges-api/v1/exchange?id=binance_futures" ``` **Response:** ```json { "data": { "id": "binance_futures", "url": "https://www.binance.com/", "name": "Binance (Futures)", "source": "CoinGecko", "country": "Cayman Islands", "description": null, "futures_pairs": 108, "volume_24h_btc": 965098.28, "perpetual_pairs": 593, "year_established": 2019, "open_interest_btc": 346539.95 }, "meta": { "timestamp": "2026-06-11T07:49:24.199Z", "request_id": "cd2a699a-85f2-4586-bec4-aa79fe655f5f" }, "status": "ok", "message": "Derivatives exchange retrieved successfully", "success": true } ``` #### `GET /v1/exchanges` — Derivatives venues ranked by open interest or volume **Parameters:** - `order` (query, optional, string) — open_interest (default), volume or name Example: `open_interest` - `limit` (query, optional, string) — Max venues (default 50) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/derivativesexchanges-api/v1/exchanges?order=open_interest&limit=50" ``` **Response:** ```json { "data": { "count": 50, "order": "open_interest_btc_desc", "source": "CoinGecko", "exchanges": [ { "id": "binance_futures", "url": "https://www.binance.com/", "name": "Binance (Futures)", "rank": 1, "country": "Cayman Islands", "futures_pairs": 108, "volume_24h_btc": 965098.28, "perpetual_pairs": 593, "year_established": 2019, "open_interest_btc": 346539.95 }, { "id": "bybit", "url": "https://www.bybit.com", "name": "Bybit (Futures)", "rank": 2, "country": "Seychelles", "futures_pairs": 69, "volume_24h_btc": 254676.82, "perpetual_pairs": 687, "year_established": 2018, "open_interest_btc": 148633.84 }, { "id": "hyperliquid", "url": "https://hyperfoundation.org/", "name": "Hyperliquid (Futures)", "rank": 3, "country": "Cayman Islands", "futures_pairs": 0, "volume_24h_btc": 176281.72, "perpetual_pairs": 355, "year_established": 2023, "open_interest_btc": 139011.22 }, { "id" …(truncated, see openapi.json for full schema) ``` #### `GET /v1/list` — All derivatives-exchange ids and names **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/derivativesexchanges-api/v1/list" ``` **Response:** ```json { "data": { "count": 202, "source": "CoinGecko", "exchanges": [ { "id": "binance_futures", "name": "Binance (Futures)" }, { "id": "bybit", "name": "Bybit (Futures)" }, { "id": "ftx", "name": "FTX (Derivatives)" }, { "id": "hyperliquid", "name": "Hyperliquid (Futures)" }, { "id": "mxc_futures", "name": "MEXC (Futures)" }, { "id": "gate_futures", "name": "Gate (Futures)" }, { "id": "coinw_futures", "name": "CoinW (Futures)" }, { "id": "weex-futures", "name": "WEEX (Futures)" }, { "id": "bitmart_futures", "name": "Bitmart Futures" }, { "id": "okex_swap", "name": "OKX (Futures)" }, { "id": "bitget_futures", "name": "Bitget Futures" }, { "id": "xt_derivatives", "name": "XT.COM (Derivatives)" }, { "id": "toobit_derivatives", "name": "Toobit Futures" …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/derivativesexchanges-api/v1/meta" ``` **Response:** ```json { "data": { "note": "open_interest_btc and volume_24h_btc are denominated in BTC. order = open_interest (default), volume or name. A 60s protective cache shields the shared upstream rate limit.", "source": "CoinGecko /derivatives/exchanges (live, keyless)", "service": "derivativesexchanges-api", "endpoints": { "GET /v1/list": "Every derivatives-exchange id and name for lookup.", "GET /v1/meta": "This document.", "GET /v1/exchange": "One venue's full profile (id=binance_futures).", "GET /v1/exchanges": "Derivatives venues ranked by open interest or volume (order=open_interest|volume, limit=50)." }, "description": "Live ranking and directory of crypto derivatives venues (the platforms running perpetual and futures markets) from the public CoinGecko feed. A venue-level view, distinct from spot-exchange directories, per-contract open-interest feeds and single-exchange tickers. The exchanges endpoint ranks venues by open interest or 24h volume with open interest in BTC, 24h volume in BTC, number of perpetual and futures pairs, country and year; the exchange endpoint returns one venue's profile; the list endpoint returns every derivatives-exchange id and name. Live, no key.", "exchange_count": 202, "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-11T07:49:24.973Z", "request_id": "a4511898-9b3b-4d54-a136-e7c5dbcf7bc8" }, "statu …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/derivativesexchanges-api OpenAPI spec: https://www.oanor.com/api/derivativesexchanges-api/openapi.json