Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

IV Rank, Skew and Volatility Term Structure Data

One row per underlying per day that tells you whether options are cheap or expensive: 30-day implied volatility, where it sits in its one-year range, how it compares with realised volatility, and the move the market is pricing in.

Coverage

What you get

Item Detail
Product code OPT-VOL-ANALYTICS
Coverage US stocks, ETFs and indices with listed options
Granularity Daily per underlying; 15-minute intraday updates on Business
History Full daily history on Pro
Delivery REST, CSV files per underlying or for the whole universe
Update speed After the close; every 15 minutes during the session on Business

Everything here is computed from our own end-of-day options data, and each formula is in the schema, so iv_rank_1y means one specific thing. Vendors define IV rank and IV percentile differently and often call one by the other's name. Here's ours.

Schema

Schema

Field Type Required Description
date string yes YYYY-MM-DD (or timestamp for intraday)
underlying_symbol string yes Underlying ticker
underlying_price number yes Close or snapshot price
atm_iv_30d number yes Interpolated 30-day at-the-money IV
iv_rank_1y number yes 0 to 100, position of atm_iv_30d in 1-year range
iv_percentile_1y number yes 0 to 100, share of days below today
hv_20d number yes 20-day realized (close-to-close) volatility
hv_60d number optional 60-day realized volatility
vrp_20d number optional atm_iv_30d minus hv_20d (variance risk premium proxy)
skew_25d number optional 25-delta put IV minus 25-delta call IV, 30-day
implied_move_pct number optional Expected move to nearest expiry from the ATM straddle, decimal
implied_move_amount number optional Same in USD
put_call_volume_ratio number optional Put volume / call volume, all expiries
put_call_oi_ratio number optional Put OI / call OI
term_structure array optional List of {expiration_date, days_to_expiration, atm_iv}

Example record:

{
  "date": "2026-11-18",
  "underlying_symbol": "AAPL",
  "underlying_price": 228.61,
  "atm_iv_30d": 0.268,
  "iv_rank_1y": 41.5,
  "iv_percentile_1y": 47.2,
  "hv_20d": 0.224,
  "hv_60d": 0.239,
  "vrp_20d": 0.044,
  "skew_25d": 0.031,
  "implied_move_pct": 0.032,
  "implied_move_amount": 7.32,
  "put_call_volume_ratio": 0.71,
  "put_call_oi_ratio": 0.88,
  "term_structure": [
    {"expiration_date": "2026-11-20", "days_to_expiration": 2, "atm_iv": 0.252},
    {"expiration_date": "2026-12-18", "days_to_expiration": 30, "atm_iv": 0.268},
    {"expiration_date": "2027-01-15", "days_to_expiration": 58, "atm_iv": 0.281}
  ]
}

Sample data

Sample data

No free volatility sample yet; it's derived from OPRA-licensed option prices. A sample file is available on request for the underlyings you trade. Once we launch, the Free plan will show today's IV rank for 5 underlyings a day.

Use cases

Use cases

Premium selling filters. Sell options when iv_rank_1y is above 50 and vrp_20d is positive, meaning implied vol is high for the year and above what the stock has actually been doing. Backtest that rule across the full history before you trust it.

Earnings straddles. implied_move_pct before a report, compared with the actual move the next day, tells you whether a stock's options have tended to over- or under-price earnings. Ten quarters of that is a useful edge check.

Skew as a fear gauge. skew_25d is put IV minus call IV at 25 delta. When it widens on an index while price is flat, demand for downside protection is rising.

Term structure shape. term_structure lists ATM IV by expiry. Front-month IV above back-month (inversion) usually shows up around events or during selloffs.

Code

Code examples

Example: today's vol summary for a few names.

curl "https://api.marketdata.co/v1/options/volatility?underlying=SPY,QQQ,TSLA&date=2026-11-18" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, IV rank history and the days it crossed 50.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/options/volatility",
    params={"underlying": "TSLA", "start": "2024-01-01"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
v = pd.DataFrame(resp.json()["results"]).set_index("date").sort_index()
crossed = v[(v["iv_rank_1y"] > 50) & (v["iv_rank_1y"].shift(1) <= 50)]
print(crossed[["atm_iv_30d", "iv_rank_1y", "hv_20d", "vrp_20d"]])

Pricing

Pricing

Plan Volatility analytics
Free, $0 Today's IV rank for 5 underlyings a day
Pro, $79/mo Full daily vol summary for all underlyings, full history
Business, $249/mo 15-minute intraday updates, commercial use

Planned files: $9 per underlying for full daily history, or $249 for the whole universe. Prices are early access and may change.

In our research, 8 prices for this kind of data run from $49.99 to $584 a month, median $102.

Side by side

How we compare

12 of the 50 providers we studied sell IV rank or similar volatility summaries. Some offer hundreds of fields; most retail tools show IV rank on screen but won't sell you the history. We give you the core fields with written formulas, at $79 a month or $9 per underlying as a file you keep, built on the same daily data as our Greeks and IV product.

FAQ

Frequently asked questions

What's the difference between IV rank and IV percentile?

IV rank places today's 30-day IV within its one-year high-low range, from 0 to 100. IV percentile is the share of days in the past year with lower IV. A single spike can drag IV rank down for months; percentile is less sensitive to that.

How is 30-day IV calculated?

We interpolate at-the-money IV between the two expirations either side of 30 days. That gives a constant-maturity number you can compare day to day.

How is realised volatility measured?

hv_20d is the annualised standard deviation of 20 daily close-to-close returns of the underlying.

Is implied_move_pct a decimal?

Yes. 0.052 means the at-the-money straddle prices a move of about 5.2% by the nearest expiry.

When is the daily row updated?

After the close each trading day. Business adds updates every 15 minutes during the session.

Keep reading