# Crypto Volatility API
> Live crypto realized (historical) volatility as an API, computed from Binance daily candles. For any coin it returns the annualized realized volatility over the 7-, 30- and 90-day windows — the standard deviation of daily log returns, annualized over 365 days — the average true range as a percent of price, the current price, and a plain-language regime label (low, normal, high or extreme). It can also rank a basket of major coins by their 30-day volatility, so you can see at a glance which assets are calm and which are wild. The volatility layer that options pricing, position sizing and risk dashboards need. Live, no key, no cache. Distinct from price, OHLC and drawdown APIs — this is the realized-volatility analytic.

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

## Pricing
- **Free** (Free) — 7,000 calls/Mo, 5 req/s
- **Starter** ($14/Mo) — 100,000 calls/Mo, 15 req/s
- **Pro** ($38/Mo) — 500,000 calls/Mo, 40 req/s
- **Desk** ($88/Mo) — 2,600,000 calls/Mo, 100 req/s

## Endpoints

### Volatility

#### `GET /v1/volatility` — A coin realized volatility (7/30/90d) and regime

**Parameters:**
- `symbol` (query, required, string) — Coin ticker (any Binance USDT pair) Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "base": "BTC",
        "basis": "daily log returns, annualized over 365 days",
        "price": 62843.34,
        "regime": "low",
        "symbol": "BTCUSDT",
        "atr_14d_pct": 4.1,
        "vol_30d_pct": 39.2,
        "realized_vol_annualized_pct": {
            "d7": 53.68,
            "d30": 39.2,
            "d90": 38.74
        }
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:24.070Z",
        "request_id": "ebca6c4c-1d5a-42a9-af21-df3285818dad"
    },
    "status": "ok",
    "message": "Volatility retrieved successfully",
    "success": true
}
```

### Compare

#### `GET /v1/compare` — Rank major coins by realized volatility

**Parameters:**
- `window` (query, optional, string) — Window in days (7-90) Example: `30`
- `add` (query, optional, string) — Extra tickers, comma-separated Example: `PEPE,WIF`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptovolatility-api/v1/compare?window=30&add=PEPE%2CWIF"
```

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "base": "MATIC",
                "price": 0.3794,
                "regime": "high",
                "symbol": "MATICUSDT",
                "vol_pct": 87.4
            },
            {
                "base": "WIF",
                "price": 0.1554,
                "regime": "high",
                "symbol": "WIFUSDT",
                "vol_pct": 83.03
            },
            {
                "base": "ADA",
                "price": 0.1672,
                "regime": "high",
                "symbol": "ADAUSDT",
                "vol_pct": 73.34
            },
            {
                "base": "AVAX",
                "price": 6.656,
                "regime": "normal",
                "symbol": "AVAXUSDT",
                "vol_pct": 62.24
            },
            {
                "base": "PEPE",
                "price": 2.78e-6,
                "regime": "normal",
                "symbol": "PEPEUSDT",
                "vol_pct": 59.45
            },
            {
                "base": "BNB",
                "price": 598.52,
                "regime": "normal",
                "symbol": "BNBUSDT",
                "vol_pct": 59.27
            },
            {
                "base": "ETH",
                "price": 1666,
                "regime": "normal",
                "symbol": "ETHUSDT",
                "vol_pct": 58.12
            },
            {
                "base": "LINK",
                "price": 7.
…(truncated, see openapi.json for full schema)
```

### Symbols

#### `GET /v1/symbols` — Major coins covered by compare

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

**Response:**
```json
{
    "data": {
        "note": "Any Binance USDT pair works via symbol=<BASE> (e.g. symbol=PEPE). The compare board covers these majors:",
        "count": 12,
        "majors": [
            "BTC",
            "ETH",
            "SOL",
            "BNB",
            "XRP",
            "DOGE",
            "ADA",
            "AVAX",
            "LINK",
            "DOT",
            "MATIC",
            "LTC"
        ]
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:24.610Z",
        "request_id": "c1ec8f99-dbce-4a63-a96e-9f00328e493b"
    },
    "status": "ok",
    "message": "Symbols retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "Binance public klines (live)",
        "service": "cryptovolatility-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/compare": "Rank majors by realized volatility (window=30, add=PEPE,WIF to extend).",
            "GET /v1/symbols": "The majors covered by compare (any USDT pair works in /v1/volatility).",
            "GET /v1/volatility": "A coin's realized volatility (symbol=BTC): 7/30/90-day annualized vol, ATR%, regime."
        },
        "description": "Live crypto realized (historical) volatility from Binance daily candles: for any coin, the annualized realized volatility over 7/30/90-day windows (std-dev of daily log returns, annualized over 365 days), the ATR as a percent of price, the current price and a regime label (low/normal/high/extreme). Also ranks a basket of majors by 30-day volatility. Live, no key. Distinct from price, OHLC and drawdown APIs — this is the realized-volatility analytic.",
        "windows_days": [
            7,
            30,
            90
        ],
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:24.949Z",
        "request_id": "bc50f7aa-2012-44b5-a909-1d35992fac99"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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