Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-GREEKS-IV |
| Coverage | US-listed equity, ETF and index options |
| Granularity | Live per contract; daily history; 1-minute history on Business |
| History | Starter: 2 years of daily Greeks and IV. Pro and up: full history we hold |
| Delivery | REST, inside the options chain and EOD records or on their own; CSV files inside our EOD datasets |
| Update speed | 15-minute delayed on Starter, real time on Pro, daily for history |
Two vendors can give you different deltas for the same contract at the same second, and both can be right. They used different rates, dividends, prices or models. We print every input: underlying_price, option_price, risk_free_rate, dividend_yield and model. If our number disagrees with your broker's, you can see why.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | OCC option symbol |
underlying_symbol |
string | yes | Underlying ticker |
timestamp |
string | yes (live) | Calculation time, ISO 8601 UTC |
date |
string | yes (history) | YYYY-MM-DD for daily records |
expiration_date |
string | yes | YYYY-MM-DD |
strike_price |
number | yes | Strike |
option_type |
string | yes | call or put |
days_to_expiration |
integer | optional | Calendar days |
underlying_price |
number | yes | Underlying price used |
option_price |
number | yes | Option price used (mid by default) |
implied_volatility |
number | yes | Mid IV, decimal |
bid_iv |
number | optional | IV at the bid |
ask_iv |
number | optional | IV at the ask |
smoothed_iv |
number | optional | IV from our fitted surface |
delta |
number | yes | Per $1 move in underlying |
gamma |
number | yes | Change in delta per $1 |
theta |
number | yes | Per calendar day, in option price units |
vega |
number | yes | Per 1 vol point |
rho |
number | yes | Per 1 rate point |
vanna |
number | optional | Second-order |
charm |
number | optional | Second-order |
vomma |
number | optional | Second-order |
theoretical_price |
number | optional | Model value at smoothed_iv |
risk_free_rate |
number | optional | Rate used, decimal |
dividend_yield |
number | optional | Dividend yield used, decimal |
model |
string | yes | black_scholes, binomial etc. |
Example record:
{
"symbol": "AAPL261218C00230000",
"underlying_symbol": "AAPL",
"timestamp": "2026-11-18T18:42:07.512000Z",
"expiration_date": "2026-12-18",
"strike_price": 230.0,
"option_type": "call",
"days_to_expiration": 30,
"underlying_price": 228.40,
"option_price": 6.40,
"implied_volatility": 0.271,
"bid_iv": 0.269,
"ask_iv": 0.273,
"smoothed_iv": 0.270,
"delta": 0.478,
"gamma": 0.0225,
"theta": -0.129,
"vega": 0.261,
"rho": 0.087,
"vanna": 0.0041,
"charm": 0.0009,
"vomma": 0.012,
"theoretical_price": 6.38,
"risk_free_rate": 0.039,
"dividend_yield": 0.0045,
"model": "binomial"
}
Sample data
Sample data
We don't have a free Greeks sample yet. The Greeks are ours, but the option prices underneath are licensed OPRA data. A sample file is available on request for any underlying and date range.
Use cases
Use cases
Delta hedging. Sum delta times position size times 100 across your book and you know how many shares hedge it. Recompute when gamma says delta will have moved enough to matter.
Pricing the spread you're crossing. bid_iv and ask_iv show how many vol points wide the market is. Two points wide on a 25-vol name is a lot to give up on every trade.
Theta decay studies. Pull daily theta for a contract over its life and plot it against days_to_expiration. The speed-up in the last few weeks is clear, and you can measure it per underlying instead of trusting a textbook curve.
Vol surface research. smoothed_iv comes from our fitted surface, so it doesn't jump around on illiquid strikes like raw mid IV does. Use it for skew and term-structure work, and raw implied_volatility when you need what the market actually quoted.
Code
Code examples
Example: Greeks for one contract.
curl "https://api.marketdata.co/v1/options/greeks?symbol=AAPL261218C00230000" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, daily IV history for a contract with the bid/ask IV spread.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/greeks",
params={"symbol": "AAPL261218C00230000", "start": "2026-09-01", "interval": "1d"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
g = pd.DataFrame(resp.json()["results"]).set_index("date").sort_index()
g["iv_spread"] = g["ask_iv"] - g["bid_iv"]
print(g[["implied_volatility", "iv_spread", "delta", "theta", "days_to_expiration"]].tail())
Pricing
Pricing
| Plan | Greeks and IV |
|---|---|
| Starter, $29/mo | Live Greeks in the 15-minute delayed chain; 2 years of daily Greeks and IV |
| Pro, $79/mo | Real-time Greeks, full daily history, second-order Greeks |
| Business, $249/mo | Adds intraday (1-minute) Greeks history |
There's no separate dataset price. Greeks and IV are bundled free in our historical options files, from $19 per underlying. Prices are early access and may change.
Across 13 prices we found, plans with Greeks or IV run from $0 to $3,000 a month, median $79.
Side by side
How we compare
18 of the 50 providers we studied sell Greeks or IV, more than any other options product. About half bundle current Greeks into the chain, and the money is in history. We put history in the $29 and $79 plans, publish the prices, include Greeks in every file we sell, and show the model and inputs on every row.
FAQ
Frequently asked questions
Which model do you use?
It's stated per row in model. The example above shows binomial, which handles the early exercise allowed on American-style equity options, and theoretical_price shows the value our model gives at smoothed_iv.
What units are the Greeks in?
delta and gamma are per $1 move in the underlying. theta is per calendar day in option price, vega per one vol point and rho per one rate point.
Is implied volatility a decimal or a percent?
A decimal: 0.271 means 27.1%. The same applies to risk_free_rate and dividend_yield.
Do you have vanna, charm and vomma?
Yes, on Pro and above. They're optional fields, so check for nulls before you sum them across a book.
Can I get Greeks as CSV?
Yes. They're included in every historical options file, and the API can return CSV on request.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options chain
- Learn: Options Greeks explained, Implied volatility and IV rank