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
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Implied volatility and IV rank