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

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

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

### Meta

#### `GET /v1/meta` — Spec

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


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