Coverage
What you get
| Item | Detail |
|---|---|
| Product code | CR-OPTIONS |
| Coverage | Listed crypto options, mostly Deribit, plus OKX, Bybit and Binance where listed |
| Granularity | 1-minute chain snapshots (Business) and end-of-day chains (Pro) |
| History | Full history we hold on Business |
| Delivery | REST, CSV or Parquet files |
| Update speed | Every minute on Business; once a day on Pro |
Crypto options trade around the clock, and the largest venue quotes many contracts in the coin itself rather than in dollars. A 0.012 premium on a BTC call means 0.012 BTC. Every record here says which currency the premium is in, carries the underlying price used, and keeps the venue's own IV and Greeks, so you don't have to rebuild them.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Our option symbol, UNDERLYING-YYYYMMDD-STRIKE-C/P, e.g. BTC-20261225-90000-C |
exchange |
string | yes | e.g. deribit |
underlying |
string | yes | e.g. BTC |
expiration |
string | yes | Expiry time, ISO 8601 UTC |
strike |
number | yes | Strike price |
option_type |
string | yes | call or put |
timestamp |
string | yes | Snapshot time, ISO 8601 UTC |
price_currency |
string | yes | Currency of premium fields (BTC on inverse contracts, USD elsewhere) |
bid |
number | yes | Best bid |
bid_size |
number | optional | Contracts at bid |
ask |
number | yes | Best ask |
ask_size |
number | optional | Contracts at ask |
last_price |
number | optional | Last trade |
mark_price |
number | yes | Exchange mark |
bid_iv |
number | optional | IV of bid, percent |
ask_iv |
number | optional | IV of ask, percent |
mark_iv |
number | yes | IV of mark, percent |
underlying_price |
number | yes | Forward or underlying used |
index_price |
number | optional | Spot index |
open_interest |
number | yes | Open contracts |
delta |
number | yes | Greeks as published by the venue |
gamma |
number | yes | |
vega |
number | yes | |
theta |
number | yes | |
rho |
number | optional |
Example record (illustrative values):
{
"symbol": "BTC-20261225-90000-C",
"exchange": "deribit",
"underlying": "BTC",
"expiration": "2026-12-25T08:00:00Z",
"strike": 90000,
"option_type": "call",
"timestamp": "2026-11-19T14:30:00Z",
"price_currency": "BTC",
"bid": 0.0115,
"bid_size": 12.5,
"ask": 0.0125,
"ask_size": 8.0,
"last_price": 0.012,
"mark_price": 0.01198,
"bid_iv": 47.6,
"ask_iv": 49.1,
"mark_iv": 48.3,
"underlying_price": 77940.5,
"index_price": 77612.4,
"open_interest": 1843.2,
"delta": 0.21,
"gamma": 0.000031,
"vega": 61.8,
"theta": -48.2,
"rho": 12.4
}
Sample data
Sample data
No free crypto options sample yet. A sample file is available on request: tell us the underlying, a date and whether you want EOD or 1-minute snapshots, and we'll send a chain in this schema.
Use cases
Use cases
Volatility smile and skew. For one expiration, plot mark_iv against strike. Compare the 25-delta put and call IV (filter on delta) to see whether the market is paying up for downside or upside.
Term structure. Take at-the-money mark_iv for each expiration and line them up by date. An inverted curve, where short-dated IV sits above long-dated, usually shows up around big events and sell-offs.
Backtesting option selling. Use EOD bid and ask to simulate selling weekly calls against spot. Convert premiums with underlying_price when price_currency is BTC, so your P&L is in one unit.
Positioning by strike. Sum open_interest by strike for the nearest monthly expiry. Large clusters show where many traders hold contracts going into expiry.
Code
Code examples
Example: the BTC chain for one expiry.
curl "https://api.marketdata.co/v1/crypto/options/chain?underlying=BTC&exchange=deribit&expiration=2026-12-25" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, a volatility smile in USD terms.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/crypto/options/chain",
params={"underlying": "BTC", "exchange": "deribit", "expiration": "2026-12-25"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
chain = pd.DataFrame(resp.json()["results"])
calls = chain[chain["option_type"] == "call"].sort_values("strike")
calls["mark_usd"] = calls["mark_price"] * calls["underlying_price"]
print(calls[["strike", "mark_iv", "delta", "mark_usd"]])
The USD conversion applies when price_currency is BTC.
Pricing
Pricing
| Plan | Crypto options |
|---|---|
| Pro, $79/mo | End-of-day chains |
| Business, $249/mo | Full chains with IV and Greeks, 1-minute snapshots, full history |
Dataset: EOD chain snapshots at $49 per underlying per year. 1-minute chains as files are quoted. Among the providers we studied, paid plans run from $35 to $900 a month with a median of $584, and the two cheapest don't include IV or Greeks.
Side by side
How we compare
6 of the 50 providers we studied sell crypto options data. Some give only a snapshot without IV or Greeks, and those with full chains and Greeks start several hundred dollars a month. We put the full chain with Greeks on Business at $249, sell EOD history as files at $49 per underlying-year that you keep, and use the same timestamp and exchange conventions as our other crypto data.
FAQ
Frequently asked questions
Why are some prices in BTC instead of dollars?
Some venues, Deribit included, list inverse options whose premium is paid in the underlying coin. price_currency tells you which unit applies, and underlying_price lets you convert to USD.
Whose Greeks and IV are these?
The venue's own published values. We store them as published so they match what traders saw on screen at that time.
What time zone are expiries in?
UTC. Deribit options expire at 08:00 UTC, and expiration holds the full timestamp.
Is this real-time?
1-minute snapshots on Business are the closest to live. We don't plan a tick-by-tick options stream at launch.
Can I get this as files?
Yes. EOD snapshots are $49 per underlying per year, as CSV or Parquet, and the files are yours to keep.
Keep reading
Related
- Asset hub: Crypto
- Symbols: BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD
- Docs: API Reference: Crypto Prices, Bars and Trades
- Learn: Options Greeks Explained with Real Chain Data, Implied Volatility and IV Rank for Options Traders