{"openapi":"3.1.0","info":{"title":"Crypto Derivatives API","version":"1.0.0","description":"Live cross-exchange perpetual-futures market data — no key, nothing cached. Where single-exchange APIs show one venue, this compares the whole derivatives market across every exchange at once. The contract endpoint takes a symbol (BTCUSDT, ETHUSD) and returns that contract on every exchange that lists it — the mark price, the funding rate, the basis, the open interest and the 24-hour volume on Binance, Bybit, OKX, MEXC, Hyperliquid and the rest side by side, so you can instantly see where funding is richest and where the open interest sits (BTCUSDT trades on dozens of venues with billions in open interest each). The exchanges endpoint is the derivatives-exchange league table, ranked by open interest in BTC, with each venue's 24-hour volume and number of perpetual and futures pairs. The top endpoint surfaces the largest contracts market-wide by open interest or by volume. This is the cross-exchange derivatives layer for any trading, funding-arbitrage, risk or analytics app. Live from CoinGecko, nothing stored. Distinct from single-exchange funding and open-interest APIs — this is the whole perpetual-futures market across exchanges. 4 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/derivatives-api","description":"oanor gateway"}],"tags":[{"name":"Derivatives"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/contract":{"get":{"operationId":"get_v1_contract","tags":["Derivatives"],"summary":"A symbol across every exchange","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Contract symbol","schema":{"type":"string"},"example":"BTCUSDT"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"symbol":"BTCUSDT","contracts":[{"price":62109.1,"symbol":"BTCUSDT","exchange":"Binance (Futures)","basis_pct":0.0715,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099763,"volume_24h_usd":14118720422,"funding_rate_pct":-0.00048,"open_interest_usd":6292310173,"price_change_24h_pct":0.053},{"price":61510.3,"symbol":"BTC_USDT","exchange":"MEXC (Futures)","basis_pct":0.0476,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099916,"volume_24h_usd":6641994322,"funding_rate_pct":-0.0004,"open_interest_usd":4206102915,"price_change_24h_pct":-0.24},{"price":62128.8,"symbol":"BTCUSDT","exchange":"Bybit (Futures)","basis_pct":0.0298,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099732,"volume_24h_usd":6444884745,"funding_rate_pct":0.00112,"open_interest_usd":3468464430,"price_change_24h_pct":-0.224},{"price":62041,"symbol":"BTC_USDT","exchange":"Gate (Futures)","basis_pct":0.0809,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099991,"volume_24h_usd":6219238004,"funding_rate_pct":-0.002,"open_interest_usd":3408812374,"price_change_24h_pct":-0.207},{"price":62012.83,"symbol":"BTC-USDT","exchange":"WEEX (Futures)","basis_pct":-0.0058,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781098719,"volume_24h_usd":10796034071,"funding_rate_pct":0,"open_interest_usd":2995270285,"price_change_24h_pct":-0.481},{"price":62067.25,"symbol":"BTC/USDT","exchange":"CoinW (Futures)","basis_pct":-0.0592,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100059,"volume_24h_usd":6245340533,"funding_rate_pct":0.0019,"open_interest_usd":2783213123,"price_change_24h_pct":-0.003},{"price":62162.45,"symbol":"BTC-USDT","exchange":"HTX Futures","basis_pct":0.0402,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099970,"volume_24h_usd":1033184427,"funding_rate_pct":-0.00045,"open_interest_usd":2013746876,"price_change_24h_pct":-0.377},{"price":62243,"symbol":"BTC-USDT","exchange":"BingX (Futures)","basis_pct":0.0522,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100098,"volume_24h_usd":2132471376,"funding_rate_pct":0.0014,"open_interest_usd":1422735183,"price_change_24h_pct":-0.093},{"price":62010.59,"symbol":"BTC/USDT","exchange":"PrimeXBT","basis_pct":0.0052,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100096,"volume_24h_usd":1234748146,"funding_rate_pct":0.0004,"open_interest_usd":953221645,"price_change_24h_pct":-0.351},{"price":62227.3,"symbol":"BTC_USDT","exchange":"Bitunix Futures","basis_pct":0.0243,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099726,"volume_24h_usd":2700353876,"funding_rate_pct":-0.00333,"open_interest_usd":898717603,"price_change_24h_pct":-0.26},{"price":62126.7,"symbol":"BTC-USDT","exchange":"Aster (Futures)","basis_pct":0.0616,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099845,"volume_24h_usd":1474454192,"funding_rate_pct":0.00228,"open_interest_usd":687143742,"price_change_24h_pct":-0.257},{"price":62154.86,"symbol":"BTC_USDT","exchange":"Ourbit (Futures)","basis_pct":0.0543,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099599,"volume_24h_usd":7933290816,"funding_rate_pct":-0.0004,"open_interest_usd":533657773,"price_change_24h_pct":-0.132},{"price":62154.62,"symbol":"BTCUSDT","exchange":"LBank (Futures)","basis_pct":0.0412,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099783,"volume_24h_usd":722964581,"funding_rate_pct":-0.00052,"open_interest_usd":468869616,"price_change_24h_pct":-0.182},{"price":62193.8,"symbol":"BTC_USDT","exchange":"XT.COM (Derivatives)","basis_pct":0.0427,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099534,"volume_24h_usd":1682914857,"funding_rate_pct":-0.00044,"open_interest_usd":397257153,"price_change_24h_pct":-0.132},{"price":62197.7,"symbol":"BTC-USDT","exchange":"Zoomex (Futures)","basis_pct":0.0422,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099598,"volume_24h_usd":2511461650,"funding_rate_pct":0,"open_interest_usd":348853411,"price_change_24h_pct":0},{"price":61988.11,"symbol":"BTC-USDT","exchange":"BloFin (Futures)","basis_pct":-0.1445,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100152,"volume_24h_usd":426470626,"funding_rate_pct":-0.00632,"open_interest_usd":324282167,"price_change_24h_pct":-0.503},{"price":62229.48,"symbol":"BTC_USDT","exchange":"Biconomy (Futures)","basis_pct":0.0364,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099340,"volume_24h_usd":5540802243,"funding_rate_pct":0.01046,"open_interest_usd":167712795,"price_change_24h_pct":0.356},{"price":62108.09,"symbol":"BTC-USDT","exchange":"Bitrue (Futures)","basis_pct":0.0544,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100047,"volume_24h_usd":1727937808,"funding_rate_pct":-0.00052,"open_interest_usd":120843894,"price_change_24h_pct":0.039},{"price":62142.75,"symbol":"BTC_USDT","exchange":"Antarctic ","basis_pct":-0.0053,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099775,"volume_24h_usd":96064797,"funding_rate_pct":0.0433,"open_interest_usd":119857753,"price_change_24h_pct":0.012},{"price":62206.6,"symbol":"BTCUSDT","exchange":"Bitmart Futures","basis_pct":0.0943,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100155,"volume_24h_usd":3292917301,"funding_rate_pct":-0.00838,"open_interest_usd":115340944,"price_change_24h_pct":-0.275},{"price":62413.4,"symbol":"BTC-USDT","exchange":"CoinEx (Futures)","basis_pct":0.0539,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099614,"volume_24h_usd":414107737,"funding_rate_pct":0,"open_interest_usd":114929046,"price_change_24h_pct":-0.062},{"price":62155.08,"symbol":"BTCUSDT","exchange":"ApeX Omni","basis_pct":0.0411,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099821,"volume_24h_usd":919208015,"funding_rate_pct":0.001,"open_interest_usd":97161126,"price_change_24h_pct":-0.178},{"price":62130.74,"symbol":"BTC_USDT","exchange":"AlphaX (Futures)","basis_pct":0.0516,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099750,"volume_24h_usd":97303344,"funding_rate_pct":0.0017,"open_interest_usd":29443574,"price_change_24h_pct":-0.25},{"price":62055.46,"symbol":"BTC_USDT","exchange":"KCEX (Futures)","basis_pct":0.0448,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100024,"volume_24h_usd":2440459650,"funding_rate_pct":-0.0005,"open_interest_usd":16292287,"price_change_24h_pct":-0.24},{"price":62199.99,"symbol":"BTC-USDT","exchange":"LN Exchange (Futures)","basis_pct":0.0032,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099720,"volume_24h_usd":5000194,"funding_rate_pct":0.0051,"open_interest_usd":2412168,"price_change_24h_pct":-0.167},{"price":62050.96,"symbol":"BTCUSDT","exchange":"Delta Exchange (Futures)","basis_pct":0,"underlying":"DEXBTUSDT","contract_type":"perpetual","last_traded_at":1781100142,"volume_24h_usd":2313074,"funding_rate_pct":-0.00315,"open_interest_usd":1133737,"price_change_24h_pct":-0.407},{"price":62023.3,"symbol":"BTCUSDT","exchange":"BigONE Futures","basis_pct":0.0436,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100144,"volume_24h_usd":226876469,"funding_rate_pct":-0.0064,"open_interest_usd":677719,"price_change_24h_pct":-0.518},{"price":61750.86,"symbol":"BTC-USDT","exchange":"KiloEx (BSC)","basis_pct":0,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100055,"volume_24h_usd":13375384,"funding_rate_pct":0.00201,"open_interest_usd":622219,"price_change_24h_pct":-0.279},{"price":62137.81,"symbol":"BTC-USDT","exchange":"KiloEx (Base)","basis_pct":0,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099842,"volume_24h_usd":4933947,"funding_rate_pct":-0.00253,"open_interest_usd":424810,"price_change_24h_pct":-0.126},{"price":62146.68,"symbol":"BTC_USDT","exchange":"DeriW","basis_pct":-0.049,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100110,"volume_24h_usd":136281762,"funding_rate_pct":0.02,"open_interest_usd":208592,"price_change_24h_pct":-0.112},{"price":62028.65,"symbol":"BTC-USDT","exchange":"KiloEx (opBnb)","basis_pct":0,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781100111,"volume_24h_usd":2362258,"funding_rate_pct":0.0021,"open_interest_usd":169444,"price_change_24h_pct":-0.027},{"price":62217,"symbol":"BTC_USDT","exchange":"Hotcoin (Futures)","basis_pct":-0.041,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099662,"volume_24h_usd":1557458225,"funding_rate_pct":-0.00288,"open_interest_usd":14196,"price_change_24h_pct":-0.199},{"price":62634.96,"symbol":"BTC_USDT","exchange":"Gate DEX","basis_pct":0.0461,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099936,"volume_24h_usd":8563705,"funding_rate_pct":-0.0021,"open_interest_usd":0,"price_change_24h_pct":-0.135},{"price":61668.31,"symbol":"BTC-USDT","exchange":"CoinUp.io (Futures)","basis_pct":0.0674,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781098372,"volume_24h_usd":4510183880,"funding_rate_pct":0.00315,"price_change_24h_pct":-0.763},{"price":62279.96,"symbol":"BTCUSDT","exchange":"Deepcoin (Derivatives)","basis_pct":0.0455,"underlying":"BTC","contract_type":"perpetual","last_traded_at":1781099123,"volume_24h_usd":3823528395,"funding_rate_pct":0.01439,"price_change_24h_pct":0.341}],"exchanges_listed":35},"meta":{"timestamp":"2026-06-10T14:04:45.561Z","request_id":"4fb602c1-9ac4-4591-ae6b-0ef09a22c0be"},"status":"ok","message":"Contract retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/exchanges":{"get":{"operationId":"get_v1_exchanges","tags":["Derivatives"],"summary":"Derivatives-exchange league table","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"How many (default 30, max 100)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/top":{"get":{"operationId":"get_v1_top","tags":["Derivatives"],"summary":"Largest contracts market-wide","description":"","parameters":[{"name":"by","in":"query","required":false,"description":"open_interest | volume (default open_interest)","schema":{"type":"string"},"example":"open_interest"},{"name":"limit","in":"query","required":false,"description":"How many (default 20, max 50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"CoinGecko public derivatives API (live)","service":"derivatives-api","endpoints":{"GET /v1/top":"Largest contracts market-wide (by=open_interest|volume, limit up to 50).","GET /v1/meta":"This document.","GET /v1/contract":"A symbol across every exchange (symbol=BTCUSDT): price, funding, basis, OI, volume per venue.","GET /v1/exchanges":"Derivatives-exchange league table by open interest (limit up to 100)."},"description":"Live cross-exchange perpetual-futures market data from CoinGecko: a symbol's contract on every exchange that lists it (mark price, funding rate, basis, open interest, 24h volume side by side); the derivatives-exchange league table ranked by open interest with volumes and pair counts; and the largest contracts market-wide by open interest or volume. Live, no key, nothing stored. Distinct from single-exchange funding and open-interest APIs — this is the whole perpetual-futures market across exchanges."},"meta":{"timestamp":"2026-06-09T11:39:15.292Z","request_id":"efa2a9bf-a542-4b7b-97f5-16be18584755"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1050,"monthly_call_quota":118000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2700,"monthly_call_quota":595000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6350,"monthly_call_quota":3010000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/derivatives-api"}