ATM History

Dev

GET /options/atm-history

Historical at-the-money implied volatility for BTC, ETH, or HYPE 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. BTC and ETH are accessible on all supported exchanges; HYPE is accessible with exchange=deribit or exchange=derive. Supported exchanges are deribit, binance, bybit, okx, and derive.

Parameters

Query parameters

Name	Type	Required	Description
`symbol`	string	–	BTC, ETH, or HYPE. HYPE is Deribit/Derive only. Defaults to BTC.
`exchange`	string	✓	deribit, binance, bybit, okx, or derive.
`range`	string	–	Preset day lookback such as 7d, 30d, or 90d. Defaults to 30d. Legacy days is accepted until July 21, 2026.

Tier behavior

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

Example request

bash

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

json

{
  "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.