Spec

Code snippets

curl "https://api.oanor.com/derivativesexchanges-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/derivativesexchanges-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/derivativesexchanges-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/derivativesexchanges-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}