# Crypto Implied Volatility Index (DVOL) & VRP API
> The crypto market's "fear gauge" and the premium option sellers earn, read live from Deribit's public DVOL index and Binance's candles — no key, nothing stored. DVOL is Deribit's 30-day forward implied-volatility index for BTC and ETH, the crypto equivalent of the VIX: the single number that says how much volatility the options market is pricing in. The index endpoint returns the latest DVOL, the session open/high/low/close, the 24-hour change and a plain-language regime label (low, normal, high, extreme). The vrp endpoint computes the variance risk premium — implied vol (DVOL) minus the realised volatility actually delivered over the last 30 days (annualised standard deviation of daily log returns from Binance candles): when implied sits well above realised, option sellers are being paid a premium and the rich/cheap signal flags it; when implied is below realised, options are cheap relative to what the market has been doing. The history endpoint returns the DVOL index time series. This is the implied-volatility-index / variance-risk-premium cut — distinct from the realised-volatility API (which has no implied leg), the equity VIX-family indices and the option-chain, skew and gamma APIs in the catalogue. Currency is BTC or ETH (the assets Deribit publishes DVOL for).

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

## Pricing
- **Free** (Free) — 500 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 13,500 calls/Mo, 6 req/s
- **Pro** ($37/Mo) — 72,000 calls/Mo, 16 req/s
- **Business** ($84/Mo) — 380,000 calls/Mo, 40 req/s

## Endpoints

### DVOL

#### `GET /v1/history` — DVOL index time series

**Parameters:**
- `currency` (query, required, string) — BTC or ETH Example: `BTC`
- `hours` (query, optional, string) — Lookback in hours (24-2160, default 168) Example: `168`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dvol-api/v1/history?currency=BTC&hours=168"
```

**Response:**
```json
{
    "data": {
        "count": 169,
        "source": "Deribit",
        "history": [
            {
                "low": 45.97,
                "high": 46.4,
                "open": 46.11,
                "time": 1780621200000,
                "close": 45.97
            },
            {
                "low": 45.95,
                "high": 46.66,
                "open": 45.97,
                "time": 1780624800000,
                "close": 46.4
            },
            {
                "low": 45.92,
                "high": 46.47,
                "open": 46.39,
                "time": 1780628400000,
                "close": 45.92
            },
            {
                "low": 45.81,
                "high": 46.01,
                "open": 45.92,
                "time": 1780632000000,
                "close": 45.89
            },
            {
                "low": 45.62,
                "high": 46.4,
                "open": 45.89,
                "time": 1780635600000,
                "close": 46.4
            },
            {
                "low": 46.4,
                "high": 48.31,
                "open": 46.4,
                "time": 1780639200000,
                "close": 48.15
            },
            {
                "low": 46.88,
                "high": 48.75,
                "open": 48.15,
                "time": 1780642800000,
                "close": 46.88
            },
            {
                "low": 46.51,
                "high": 47.5,
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/index` — Latest DVOL with OHLC & regime

**Parameters:**
- `currency` (query, required, string) — BTC or ETH Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "dvol": 43.25,
        "note": "DVOL is Deribit's 30-day forward implied-volatility index (percent annualised) — the crypto VIX. regime: low <35, normal 35-55, high 55-80, extreme >=80.",
        "regime": "normal",
        "source": "Deribit",
        "day_low": 43.14,
        "currency": "BTC",
        "day_high": 46.54,
        "day_open": 46.42,
        "change_24h": -3.17,
        "change_24h_pct": -6.83
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:11.107Z",
        "request_id": "8f27ba99-f167-40f2-85d0-263aa7ce8fba"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

#### `GET /v1/vrp` — Variance risk premium (implied minus realised)

**Parameters:**
- `currency` (query, required, string) — BTC or ETH Example: `BTC`
- `window` (query, optional, string) — Realised-vol window in days (7-90, default 30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dvol-api/v1/vrp?currency=BTC&window=30"
```

**Response:**
```json
{
    "data": {
        "note": "implied_vol is the current DVOL; realized_vol is annualised stdev of daily log returns over window_days from Binance candles. variance_risk_premium = implied − realized: positive means the options market prices more vol than has been delivered (sellers earn the premium).",
        "signal": "implied ≈ realised (fair)",
        "source": "Deribit + Binance",
        "currency": "BTC",
        "implied_vol": 43.25,
        "iv_rv_ratio": 1.028,
        "window_days": 30,
        "realized_vol": 42.09,
        "variance_risk_premium": 1.16
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:11.463Z",
        "request_id": "86b3bcb7-43da-4232-addc-a9db630073b8"
    },
    "status": "ok",
    "message": "VRP retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "currency is BTC or ETH. DVOL is percent annualised. vrp window is 7-90 days (default 30). history hours is 24-2160 (default 168). Nothing cached.",
        "source": "Deribit public API (DVOL) + Binance daily candles (realised), live",
        "service": "dvol-api",
        "btc_dvol": 43.25,
        "endpoints": {
            "GET /v1/vrp": "Variance risk premium: implied (DVOL) minus realised vol with a rich/cheap signal (currency=BTC, window=30).",
            "GET /v1/meta": "This document.",
            "GET /v1/index": "Latest DVOL with session OHLC and regime (currency=BTC).",
            "GET /v1/history": "DVOL index time series (currency=BTC, hours=168)."
        },
        "currencies": [
            "BTC",
            "ETH"
        ],
        "description": "Crypto implied-volatility index (DVOL) and variance risk premium, read live from Deribit's DVOL index and Binance candles (no key, nothing stored). index returns the latest DVOL — Deribit's 30-day forward implied vol for BTC/ETH, the crypto VIX — with the session OHLC and a regime label. vrp computes the variance risk premium: implied (DVOL) minus realised vol over a window, with a rich/cheap signal. history returns the DVOL time series. The implied-vol-index / variance-risk-premium cut — distinct from the realised-volatility API, the equity VIX-family indices and the option-chain/skew/gamma APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp":
…(truncated, see openapi.json for full schema)
```


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