# 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"
```

#### `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"
```

#### `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"
```

#### `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"
```

### Meta

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

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


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