# Deribit API
> Live market data from Deribit — the leading crypto options and futures exchange. A keyless, no-account JSON wrapper over Deribit's public v2 API. Read the spot index price for any settlement currency (BTC, ETH, USDC, USDT), pull a full ticker for any instrument — last / mark / index price, best bid-ask, open interest and 8-hour funding for perpetuals, plus mark implied volatility and the greeks (delta, gamma, vega, theta, rho) for options — list the entire active instruments catalog by currency and kind (future, option, spot, combos) with strikes, expiries and contract sizes, and fetch per-currency order-book summaries across all live instruments. The raw exchange feed for derivatives desks, options dashboards, volatility models and trading bots — distinct from analytics products: this is Deribit's own ticker, instrument and book data, decoded into clean JSON.

## 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/deribit-api/..."
```

## Pricing
- **Free** (Free) — 3,600 calls/Mo, 3 req/s
- **Basic** ($19/Mo) — 54,200 calls/Mo, 10 req/s
- **Pro** ($45/Mo) — 216,500 calls/Mo, 25 req/s
- **Mega** ($98/Mo) — 873,000 calls/Mo, 60 req/s

## Endpoints

### Market

#### `GET /v1/book` — Order-book summary across a currency / kind

**Parameters:**
- `currency` (query, optional, string) — BTC, ETH, USDC, USDT, EURR Example: `BTC`
- `kind` (query, optional, string) — future, option, spot Example: `future`
- `limit` (query, optional, string) — Max instruments (1-500) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deribit-api/v1/book?currency=BTC&kind=future&limit=50"
```

**Response:**
```json
{
    "data": {
        "kind": "future",
        "count": 12,
        "currency": "BTC",
        "returned": 12,
        "instruments": [
            {
                "last": 66007.5,
                "volume": 96.4057374,
                "ask_price": 65930,
                "bid_price": 65927.5,
                "mid_price": 65928.75,
                "mark_price": 65945.52,
                "open_interest": 3156690,
                "instrument_name": "BTC-3JUL26"
            },
            {
                "last": 65725,
                "volume": 0.01826504,
                "ask_price": 65892.5,
                "bid_price": 65860,
                "mid_price": 65876.25,
                "mark_price": 65889.31,
                "open_interest": 960,
                "instrument_name": "BTC-18JUN26"
            },
            {
                "last": 65662.5,
                "volume": 9.12045997,
                "ask_price": 65892.5,
                "bid_price": 65857.5,
                "mid_price": 65875,
                "mark_price": 65885.44,
                "open_interest": 799900,
                "instrument_name": "BTC-17JUN26"
            },
            {
                "last": 65914,
                "volume": 4811.36496026,
                "ask_price": 65917.5,
                "bid_price": 65917,
                "mid_price": 65917.25,
                "mark_price": 65910.78,
                "open_interest": 987637030,
                "instrument_name": "BTC-PERPETUAL"
    
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/index` — Spot index price for a settlement currency

**Parameters:**
- `currency` (query, optional, string) — Settlement currency: BTC, ETH, USDC, USDT, EURR Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "currency": "BTC",
        "index_name": "btc_usd",
        "index_price": 65914.99,
        "estimated_delivery_price": 65914.99
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:47.429Z",
        "request_id": "246670d6-1a43-4c68-a07e-4c1d0a0e10ae"
    },
    "status": "ok",
    "message": "Index price retrieved successfully",
    "success": true
}
```

#### `GET /v1/ticker` — Full ticker for an instrument (price, OI, funding, greeks, IV)

**Parameters:**
- `instrument` (query, required, string) — Instrument name (e.g. BTC-PERPETUAL or an option name) Example: `BTC-PERPETUAL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deribit-api/v1/ticker?instrument=BTC-PERPETUAL"
```

**Response:**
```json
{
    "data": {
        "state": "open",
        "stats": {
            "low": 63660,
            "high": 65984,
            "volume": 4811.36496026,
            "volume_usd": 313868270,
            "price_change": 2.1645,
            "volume_notional": 313868270
        },
        "timestamp": 1781522087532,
        "funding_8h": 6.0e-8,
        "last_price": 65912,
        "mark_price": 65908.18,
        "index_price": 65914.31,
        "open_interest": 987637640,
        "best_ask_price": 65911.5,
        "best_bid_price": 65911,
        "current_funding": 0,
        "instrument_name": "BTC-PERPETUAL",
        "settlement_price": 65637.35
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:47.556Z",
        "request_id": "aa88d56d-2963-4352-856f-8d94185818cc"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Reference

#### `GET /v1/instruments` — Active instruments by currency and kind

**Parameters:**
- `currency` (query, optional, string) — BTC, ETH, USDC, USDT, EURR Example: `BTC`
- `kind` (query, optional, string) — future, option, spot, future_combo, option_combo Example: `future`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/deribit-api/v1/instruments?currency=BTC&kind=future"
```

**Response:**
```json
{
    "data": {
        "kind": "future",
        "count": 12,
        "currency": "BTC",
        "instruments": [
            {
                "kind": "future",
                "is_active": true,
                "tick_size": 0.5,
                "base_currency": "BTC",
                "contract_size": 10,
                "quote_currency": "USD",
                "instrument_name": "BTC-PERPETUAL",
                "settlement_period": "perpetual",
                "expiration_timestamp": 32503708800000
            },
            {
                "kind": "future",
                "is_active": true,
                "tick_size": 2.5,
                "base_currency": "BTC",
                "contract_size": 10,
                "quote_currency": "USD",
                "instrument_name": "BTC-16JUN26",
                "settlement_period": "day",
                "expiration_timestamp": 1781596800000
            },
            {
                "kind": "future",
                "is_active": true,
                "tick_size": 2.5,
                "base_currency": "BTC",
                "contract_size": 10,
                "quote_currency": "USD",
                "instrument_name": "BTC-17JUN26",
                "settlement_period": "day",
                "expiration_timestamp": 1781683200000
            },
            {
                "kind": "future",
                "is_active": true,
                "tick_size": 2.5,
                "base_currency": "BTC",
                "contract
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "kinds": [
            "future",
            "option",
            "spot",
            "future_combo",
            "option_combo"
        ],
        "exchange": "Deribit",
        "upstream": "https://www.deribit.com/api/v2/public",
        "endpoints": [
            "/v1/index",
            "/v1/ticker",
            "/v1/instruments",
            "/v1/book",
            "/v1/meta"
        ],
        "currencies": [
            "BTC",
            "ETH",
            "USDC",
            "USDT",
            "EURR"
        ],
        "description": "Deribit is the leading crypto options and futures exchange. This API exposes its keyless public market data: index prices, instrument tickers (with greeks & implied vol for options, funding for perpetuals), the active instruments catalog and per-currency order-book summaries.",
        "documentation": "https://deribit-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:47.788Z",
        "request_id": "5fb449e0-251e-41b3-b866-85704d5ee2d6"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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