ATM History

Historical at-the-money implied volatility for BTC, ETH, HYPE, SOL, ZEC, XRP, DOGE, or BNB on a supported exchange — one data point per hour and expiry, showing the IV of the option with the closest strike to the underlying price at that time. Use it to chart how the options market's volatility expectations have evolved, compare IV across term structures, or backtest options strategies.

Authentication

Requires Dev tier or higher. Dev: up to 30 days (range=30d). Pro: up to 90 days. Supported pairs: BTC/ETH on Deribit, Binance, Bybit, OKX, and Derive; HYPE on Deribit/Derive; SOL/XRP on Deribit/Binance/Bybit/Derive; DOGE on Binance/Bybit; BNB on Binance; ZEC on Derive.

Parameters

Tier behavior

• Dev: Maximum 30d.
• Pro: Up to 90 days.

Example request

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/options/atm-history?symbol=BTC&exchange=deribit&range=7d"

Example response

{
  "symbol": "BTC",
  "exchange": "deribit",
  "range": "7d",
  "days": 7,
  "count": 1680,
  "unit": "iv",
  "resolution": "1h",
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "hour": "2026-06-01T00:00:00Z",
      "expiry": "2026-06-27T08:00:00Z",
      "underlying_price": 69800.00,
      "strike": 70000,
      "iv": 0.718
    },
    {
      "timestamp": "2026-06-01T01:00:00Z",
      "hour": "2026-06-01T01:00:00Z",
      "expiry": "2026-06-27T08:00:00Z",
      "underlying_price": 70200.00,
      "strike": 70000,
      "iv": 0.712
    }
  ]
}

Errors

• 400 — range out of bounds (must be 1d–90d).
• 403 — range exceeds your tier's limit. Dev: 30d max. Upgrade to Pro for 90d.

For authentication errors (401) and rate limit responses (429), see Errors.