Marketdata

Options marketdata

Returns Deribit options marketdata snapshots: mark price, implied volatility, Deribit-native Greeks, open interest, and best bid/ask. One row per instrument per timestamp. Includes instrument_name from the instruments table for convenience.

GET/v1/marketdata/optionsproalpha

Query Parameters

coinstringrequired

Underlying asset. Required.

e.g.BTCETHSOL

instrument_idintegeroptional

Filter by instrument_id (integer PK). Returns time series for a single instrument.

e.g.4812

fromstringoptional

Start of time range, UTC. ISO 8601. Default: latest snapshot only.

e.g.2026-03-08T00:00:00Z

tostringoptional

End of time range, UTC. ISO 8601. Default: now.

e.g.2026-03-09T00:00:00Z

limitintegeroptional

Max rows returned. Default 500, max 5000.

e.g.1000

Response Schema

Fields marked pro require a Pro subscription. Fields marked alpha require Alpha.

Field	Type	Tier	Description
`timestamp`	`datetime`	pro	Snapshot time in UTC, ISO 8601. Aligned to 10-minute boundary.
`coin`	`string`	pro	Underlying asset: BTC, ETH, SOL, XRP, AVAX, TRX.
`instrument_id`	`integer`	pro	Internal instrument PK. Join key to instruments endpoint.
`instrument_name`	`string`	pro	Deribit canonical name, e.g. BTC-28MAR26-80000-C. Joined from instruments table.
`option_type`	`string`	pro	Call or put. Joined from instruments table.
`strike`	`float`	pro	Strike price. Joined from instruments table.
`expiration_timestamp`	`datetime`	pro	Option expiration time in UTC. Joined from instruments table.
`contract_size`	`float`	pro	Contract multiplier. Varies by coin: BTC=1, ETH=1, SOL=10, AVAX=100, XRP=1000, TRX=10000. Joined from instruments table.
`underlying_price`	`float`	pro	Spot price of the underlying at snapshot time.
`mark_price`	`float`	pro	Deribit mark price in BTC (or base currency). Used for margin and P&L.
`mark_iv`	`float`	pro	Deribit mark implied volatility, annualized. The IV used for mark pricing.
`delta`	`float`	pro	Deribit-computed delta.
`gamma`	`float`	pro	Deribit-computed gamma.
`theta`	`float`	pro	Deribit-computed theta (daily decay).
`vega`	`float`	pro	Deribit-computed vega.
`rho`	`float`	pro	Deribit-computed rho.
`best_bid_price`	`float`	pro	Best bid price in the order book.
`best_ask_price`	`float`	pro	Best ask price in the order book.
`best_bid_amount`	`float`	pro	Size at the best bid.
`best_ask_amount`	`float`	pro	Size at the best ask.
`open_interest`	`float`	pro	Open interest in contracts.
`last_price`	`float`	pro	Last traded price.
`index_price`	`float`	pro	Deribit index price at snapshot time.
`estimated_delivery_price`	`float`	alpha	Estimated delivery (settlement) price. Relevant near expiry.
`bids`	`json`	alpha	Full order book bid side. Array of [price, amount] pairs. Alpha only.
`asks`	`json`	alpha	Full order book ask side. Array of [price, amount] pairs. Alpha only.

Suggested Calculations

Not included in the API response. Compute these client-side from the fields above. Formulas and context provided.

FieldTypeInputsexpand all

▶spreadfloatclient-sideHow wide is the bid-ask spread?expand

How wide is the bid-ask spread?

Absolute bid-ask spread in base currency (BTC). The first thing any trader checks before entering a position. Wide spreads mean high execution cost.

Inputsbest_ask_pricebest_bid_price

Bid-ask spread

\text{spread} = P_{\text{ask}} - P_{\text{bid}}

RangeZero or positive. BTC ATM options typically 0.0001-0.001 BTC.

▶spread_pctfloatclient-sideHow expensive is the spread relative to the option price?expand

How expensive is the spread relative to the option price?

Spread as a percentage of the mid price. Allows comparison across strikes and expiries regardless of absolute price level.

Inputsbest_ask_pricebest_bid_price

Relative spread

\text{spread\_pct} = \frac{P_{\text{ask}} - P_{\text{bid}}}{(P_{\text{ask}} + P_{\text{bid}}) / 2} \times 100

RangeTypically 0.5-15% for liquid strikes. >20% indicates poor liquidity.

Or use the pre-computed endpointalpha

Pre-computed at /v1/liquidity/options with additional depth metrics, HHI, and liquidity scores.

▶mid_pricefloatclient-sideWhat is the fair value estimate?expand

What is the fair value estimate?

Midpoint of the best bid and ask. The standard approximation for theoretical fair value.

Inputsbest_bid_pricebest_ask_price

Mid price

\text{mid\_price} = \frac{P_{\text{bid}} + P_{\text{ask}}}{2}

RangePositive. Same scale as mark_price.

▶moneynessfloatclient-sideHow far is the strike from the current spot price?expand

How far is the strike from the current spot price?

Ratio of the underlying price to the strike. Values above 1.0 = ITM calls / OTM puts. Allows cross-coin comparison on a normalized scale. Requires strike from /v1/instruments/options.

Inputsunderlying_pricestrike

Simple moneyness

\text{moneyness} = \frac{S}{K}

RangeTypically 0.5 to 2.0. ATM options cluster around 1.0.

▶days_to_expiryfloatclient-sideHow many days until this option expires?expand

How many days until this option expires?

Time remaining until expiration in calendar days. Requires expiration_timestamp from /v1/instruments/options. Essential for theta decay analysis.

Inputstimestampexpiration_timestamp

Days to expiry

\text{DTE} = \frac{t_{\text{expiry}} - t_{\text{snapshot}}}{86400}

RangeZero to ~365.

▶oi_usdfloatclient-sideWhat is the dollar value of open interest at this strike?expand

What is the dollar value of open interest at this strike?

Converts raw OI in contracts to USD notional. Without this, "OI = 142 contracts" is meaningless. The starting point for all position-level risk analysis.

Or use the pre-computed endpointalpha

Available pre-computed with put/call split, momentum, and concentration at /v1/positioning/oi.

▶delta_usdfloatclient-sideHow much USD exposure does one contract carry?expand

How much USD exposure does one contract carry?

Dollar delta per contract. The number a risk manager needs to size hedges. Converts the native Deribit delta into a dollar figure.

Or use the pre-computed endpointalpha

Available as part of the full 37-Greek computation at /v1/greeks/snapshot.

▶gamma_usdfloatclient-sideHow much does delta change for a 1% spot move, in dollars?expand

How much does delta change for a 1% spot move, in dollars?

Dollar gamma per contract. The per-contract building block of GEX. High gamma_usd means the position accelerates quickly.

Or use the pre-computed endpointalpha

Pre-aggregated with taker-flow correction at /v1/gex/strikes. Skip the math entirely.

▶vega_usdfloatclient-sideHow much does the option gain per 1 vol point increase, in dollars?expand

How much does the option gain per 1 vol point increase, in dollars?

Dollar vega per contract. Measures how sensitive the position is to changes in implied volatility.

Or use the pre-computed endpointalpha

Part of the full Greek suite at /v1/greeks/snapshot.

▶theta_usdfloatclient-sideHow much does this contract lose per day from time decay, in dollars?expand

How much does this contract lose per day from time decay, in dollars?

Daily time decay in USD. Negative for long options. Accelerates as expiry approaches.

Or use the pre-computed endpointalpha

Part of the full Greek suite at /v1/greeks/snapshot.

▶oi_delta_usdfloatclient-sideWhat is the total directional exposure at this strike?expand

What is the total directional exposure at this strike?

Aggregate directional USD exposure across all open contracts for this instrument. Reveals where the market is concentrated long or short.

Or use the pre-computed endpointalpha

Pre-aggregated with directional breakdown and momentum at /v1/positioning/oi.

▶oi_gamma_usdfloatclient-sideWhat is the GEX contribution of this instrument?expand

What is the GEX contribution of this instrument?

Per-instrument gamma exposure in USD. Aggregated across all instruments at a strike, this produces the GEX profile. Identifies magnetic price levels and gamma flip points.

Or use the pre-computed endpointalpha

Pre-aggregated with taker-flow correction, pin scores, and gamma flip detection at /v1/gex/strikes and /v1/gex/pinning.

▶oi_vega_usdfloatclient-sideWhere is the market most sensitive to volatility changes?expand

Where is the market most sensitive to volatility changes?

Total USD sensitivity to a 1-point IV change at this strike. Strikes with high values are where vol moves have the largest P&L impact.

Or use the pre-computed endpointalpha

Used by ORIA to detect vol-sensitive positioning. Full options-volatility-landscape at /v1/vol/surface (coming soon).

▶book_imbalancefloatclient-sideIs the order book skewed toward buyers or sellers?expand

Is the order book skewed toward buyers or sellers?

Ratio of total bid volume to total bid+ask volume across all book levels. Above 0.5 = net buy pressure (more resting bids than asks). Below 0.5 = net sell pressure. A simple but powerful short-term directional signal. Requires the bids and asks JSONB arrays (Alpha tier).

Inputsbidsasks

Order book imbalance ratio

\text{imbalance} = \frac{\sum V_{\text{bid}}}{\sum V_{\text{bid}} + \sum V_{\text{ask}}}

Range0 to 1. Neutral market: ~0.5. Strong buy pressure: >0.65. Strong sell pressure: <0.35.

▶vwap_spreadfloatclient-sideWhat is the true cost of execution beyond the top of book?expand

What is the true cost of execution beyond the top of book?

Difference between the volume-weighted average ask and volume-weighted average bid across all book levels. Unlike the simple best-bid/ask spread, this captures depth. A tight top-of-book spread with a wide VWAP spread means the book is thin. Requires bids and asks JSONB arrays (Alpha tier).

Inputsbidsasks

Volume-weighted spread

\text{vwap\_spread} = \frac{\sum P^{\text{ask}}_i \cdot Q^{\text{ask}}_i}{\sum Q^{\text{ask}}_i} - \frac{\sum P^{\text{bid}}_i \cdot Q^{\text{bid}}_i}{\sum Q^{\text{bid}}_i}

RangeAlways positive. Compare to simple spread to assess book depth.

▶depth_bid_usdfloatclient-sideHow much USD liquidity is resting on the bid side?expand

How much USD liquidity is resting on the bid side?

Total dollar value available on the bid side of the order book. Tells you how much selling the market can absorb before the price moves significantly. The institutional measure of downside support.

Or use the pre-computed endpointalpha

Pre-computed with HHI concentration, weighted metrics, and liquidity scores at /v1/liquidity/options.

▶cost_to_movefloatclient-sideHow many dollars does it take to move the price by 1%?expand

How many dollars does it take to move the price by 1%?

The inverse of depth: walk through the order book and sum the volume needed to shift the price by a target percentage. The standard institutional metric for execution feasibility. Low cost_to_move = vulnerable to large orders or liquidation cascades.

Or use the pre-computed endpointalpha

Pre-computed with full book walk-through at /v1/liquidity/options. Includes bid-side and ask-side separately.

▶book_skewfloatclient-sideIs the depth asymmetric between bids and asks?expand

Is the depth asymmetric between bids and asks?

Measures the ratio of bid-side to ask-side depth at multiple levels of the book (not just top-of-book). Persistent skew indicates directional positioning by market makers. A bid-heavy skew suggests dealers are willing to buy, which often precedes upward price movement.

Or use the pre-computed endpointalpha

Pre-computed as bid_ask_ratio with depth analysis across all book levels at /v1/liquidity/options.