# Crypto Derivatives API
> A cross-exchange aggregator of cryptocurrency perpetual-futures and derivatives markets — the funding rates, open interest and volume that drive leveraged crypto trading, pulled together across every listed derivatives exchange (Binance, Bybit, OKX, Hyperliquid, MEXC and dozens more). The perps endpoint ranks the largest perpetual markets by open interest with their price, funding rate, open interest and 24h volume. The funding endpoint compares the funding rate of one asset (e.g. BTC, ETH, SOL) across every exchange that lists it, with the average — so you can spot funding dislocations and basis trades at a glance. The exchanges endpoint ranks derivatives venues by open interest with their perpetual and futures pair counts. The overview endpoint aggregates total open interest, total 24h volume and the perpetual-pair count across the whole derivatives market. The meta endpoint documents the API. Live aggregated data, lightly cached; funding rates are percentages, open interest in USD per market and BTC for venue totals. Live. 5 endpoints. This aggregates derivatives across all exchanges; for a single exchange's raw order book use that exchange's 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/cryptoderivatives-api/..."
```

## Pricing
- **Free** (Free) — 250 calls/Mo, 2 req/s
- **Basic** ($15/Mo) — 17,500 calls/Mo, 5 req/s
- **Pro** ($37/Mo) — 92,000 calls/Mo, 20 req/s
- **Mega** ($82/Mo) — 410,000 calls/Mo, 55 req/s

## Endpoints

### Derivatives

#### `GET /v1/exchanges` — Derivatives exchanges ranked by open interest

**Parameters:**
- `limit` (query, optional, string) — Number of exchanges (default 25, max 50) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoderivatives-api/v1/exchanges?limit=25"
```

**Response:**
```json
{
    "data": {
        "kind": "Derivatives exchanges ranked by open interest",
        "count": 25,
        "source": "CoinGecko derivatives exchanges",
        "exchanges": [
            {
                "name": "Binance (Futures)",
                "futures_pairs": 114,
                "volume_24h_btc": 949477.17,
                "perpetual_pairs": 593,
                "year_established": 2019,
                "open_interest_btc": 357500.37
            },
            {
                "name": "Bybit (Futures)",
                "futures_pairs": 71,
                "volume_24h_btc": 248024.79,
                "perpetual_pairs": 684,
                "year_established": 2018,
                "open_interest_btc": 146852.91
            },
            {
                "name": "Hyperliquid (Futures)",
                "futures_pairs": 0,
                "volume_24h_btc": 151700.25,
                "perpetual_pairs": 357,
                "year_established": 2023,
                "open_interest_btc": 146658.68
            },
            {
                "name": "MEXC (Futures)",
                "futures_pairs": 0,
                "volume_24h_btc": 230969.79,
                "perpetual_pairs": 937,
                "year_established": 2020,
                "open_interest_btc": 141032.84
            },
            {
                "name": "Gate (Futures)",
                "futures_pairs": 0,
                "volume_24h_btc": 226681.04,
                "perpetual_pairs": 757,
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/funding` — Funding rates for an asset across all exchanges

**Parameters:**
- `base` (query, optional, string) — Asset symbol (default BTC), e.g. BTC, ETH, SOL Example: `BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoderivatives-api/v1/funding?base=BTC"
```

**Response:**
```json
{
    "data": {
        "base": "BTC",
        "source": "CoinGecko derivatives",
        "markets": [
            {
                "price": 66484.2,
                "symbol": "BTCUSDT",
                "exchange": "Binance (Futures)",
                "funding_rate_pct": -0.003766999999999999,
                "open_interest_usd": 6903645124
            },
            {
                "price": 66493.1,
                "symbol": "BTC_USDT",
                "exchange": "MEXC (Futures)",
                "funding_rate_pct": -0.0037,
                "open_interest_usd": 4646087704
            },
            {
                "price": 66464,
                "symbol": "BTC_USDT",
                "exchange": "Gate (Futures)",
                "funding_rate_pct": 0.0023,
                "open_interest_usd": 4316944497
            },
            {
                "price": 66534.8,
                "symbol": "BTCUSDT",
                "exchange": "Bybit (Futures)",
                "funding_rate_pct": 0.004748,
                "open_interest_usd": 3515616659
            },
            {
                "price": 66508.24,
                "symbol": "BTC/USDT",
                "exchange": "CoinW (Futures)",
                "funding_rate_pct": -0.002166,
                "open_interest_usd": 3427738546
            },
            {
                "price": 66530.03,
                "symbol": "BTC-USDT",
                "exchange": "WEEX (Futures)",
                "funding_rate_pct": 6.19e-6,
 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/overview` — Aggregate derivatives market: total OI, volume, pairs

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoderivatives-api/v1/overview"
```

**Response:**
```json
{
    "data": {
        "source": "CoinGecko derivatives exchanges",
        "exchange_count": 50,
        "top_exchanges_by_oi": [
            {
                "name": "Binance (Futures)",
                "open_interest_btc": 357500
            },
            {
                "name": "Bybit (Futures)",
                "open_interest_btc": 146853
            },
            {
                "name": "Hyperliquid (Futures)",
                "open_interest_btc": 146659
            },
            {
                "name": "MEXC (Futures)",
                "open_interest_btc": 141033
            },
            {
                "name": "Gate (Futures)",
                "open_interest_btc": 133952
            }
        ],
        "total_volume_24h_btc": 6557890.7,
        "total_perpetual_pairs": 20841,
        "total_open_interest_btc": 2632832.8
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:37.367Z",
        "request_id": "4ee2beda-532d-4806-8072-961e89cd55d3"
    },
    "status": "ok",
    "message": "Derivatives market overview retrieved",
    "success": true
}
```

#### `GET /v1/perps` — Top perpetual markets ranked by open interest

**Parameters:**
- `limit` (query, optional, string) — Number of markets (default 30, max 100) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoderivatives-api/v1/perps?limit=30"
```

**Response:**
```json
{
    "data": {
        "kind": "Top perpetual markets by open interest",
        "count": 30,
        "source": "CoinGecko derivatives",
        "markets": [
            {
                "base": "BTC",
                "price": 66484.2,
                "symbol": "BTCUSDT",
                "exchange": "Binance (Futures)",
                "basis_pct": 0.0434,
                "contract_type": "perpetual",
                "volume_24h_usd": 13907077396,
                "funding_rate_pct": -0.003766999999999999,
                "open_interest_usd": 6903645124,
                "price_change_24h_pct": 4.08
            },
            {
                "base": "BTC",
                "price": 66493.1,
                "symbol": "BTC_USDT",
                "exchange": "MEXC (Futures)",
                "basis_pct": 0.0497,
                "contract_type": "perpetual",
                "volume_24h_usd": 5866123304,
                "funding_rate_pct": -0.0037,
                "open_interest_usd": 4646087704,
                "price_change_24h_pct": 4.09
            },
            {
                "base": "BTC",
                "price": 66464,
                "symbol": "BTC_USDT",
                "exchange": "Gate (Futures)",
                "basis_pct": 0.0978,
                "contract_type": "perpetual",
                "volume_24h_usd": 5675493888,
                "funding_rate_pct": 0.0023,
                "open_interest_usd": 4316944497,
                "price_change_24h_pct": 4.15
    
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — API metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoderivatives-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "api": "Crypto Derivatives API",
        "kind": "Cross-exchange perpetual-futures & derivatives aggregator",
        "notes": "Aggregates perpetual/futures markets across every listed exchange: prices, funding rates, open interest and volume. Lightly cached. Funding rates are percentages; open interest in USD (markets) or BTC (exchange totals).",
        "source": "CoinGecko derivatives endpoints (aggregated across all listed derivatives exchanges)",
        "endpoints": [
            "/v1/perps",
            "/v1/funding",
            "/v1/exchanges",
            "/v1/overview",
            "/v1/meta"
        ],
        "documentation": "https://cryptoderivatives-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:37.528Z",
        "request_id": "e2cdf0de-2834-40e3-9823-d035a9b950ff"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/cryptoderivatives-api
OpenAPI spec: https://www.oanor.com/api/cryptoderivatives-api/openapi.json