Third-Order Binomial Greeks

FreeValueStandardPro

Fetch third-order binomial Greeks history (intraday, sampled by interval).

• Returns the data for all contracts that share the same provided symbol and expiration.
• Greeks are calculated with a Leisen-Reimer binomial tree that allows early exercise at every node, so the values are American-style.
• Calculated using the option and underlying midpoint price. If an interval size is specified (highly recommended), the option quote used in the calculation follows the same rules as the quote endpoint.
• The underlying price represents whatever the last underlying price was at the timestamp field. You can read more about how Theta Data calculates greeks here.
• Multi-day requests are limited to 1 month of data.

SPY · 20250321

Client

Auth

Style

symbolstring*

expirationdate*

strikestring

rightstring

datedate

intervalstring

start_timestring

end_timestring

annual_dividendfloat

rate_typestring

rate_valuefloat

binomial_stepsint

versionstring

strike_rangeint

start_datedate

end_datedate

from thetadatadx import Client

client = Client.from_env()

rows = client.market_data.option_history_binomial_greeks_third_order(
    "SPY", "20250321",
    strike="570", right="C", date="20250303", interval="1m",
)
for t in rows:
    print(t.date, t.speed, t.zomma, t.color)

Sample response · JSON

[
  {
    "ask": 2.78,
    "bid": 2.75,
    "color": -2.2101,
    "implied_vol": 0.3222,
    "iv_error": 0.0002,
    "speed": 0.0002,
    "timestamp": "2024-11-04T10:30:00.000",
    "ultima": -1.9493,
    "underlying_price": 221.73,
    "underlying_timestamp": "2024-11-04T10:30:00.000",
    "zomma": -0.1592
  },
  {
    "ask": 2.53,
    "bid": 2.51,
    "color": -2.3041,
    "implied_vol": 0.3103,
    "iv_error": 0.0001,
    "speed": 0.0005,
    "timestamp": "2024-11-04T11:30:00.000",
    "ultima": -4.2452,
    "underlying_price": 221.49,
    "underlying_timestamp": "2024-11-04T11:30:00.000",
    "zomma": -0.1709
  }
]

Parameters

Name	Type	Required	Default	Description
symbol	string	yes	-	Ticker symbol (e.g. AAPL)
expiration	date	yes	-	Expiration date YYYYMMDD
strike	string	no	*	Strike price in dollars as a string (e.g. 500 or 17.5). Use * for wildcard selection.
right	string	no	both	Option side. Use both or * (alias) for calls and puts. Accepted values: call, put, both, *.
date	date	no	-	Single date YYYYMMDD. Supply this for a single-day pull, or supply start_date/end_date for a range. When present, date takes precedence over the range.
interval	string	no	1s	Interval preset. Defaults to 1s when omitted, matching the upstream ThetaData Python library. Accepted values: tick, 10ms, 100ms, 500ms, 1s, 5s, 10s, 15s, 30s, 1m, 5m, 10m, 15m, 30m, 1h.
start_time	string	no	09:30:00	Start time filter
end_time	string	no	16:00:00	End time filter
annual_dividend	float	no	-	Annualized expected dividend amount, in dollars per share, used in the Greeks calculation (e.g. 2.5 is $2.50 per share per year).
rate_type	string	no	sofr	Risk-free-rate source used in the Greeks calculation. Accepted values: sofr, treasury_m1, treasury_m3, treasury_m6, treasury_y1, treasury_y2, treasury_y3, treasury_y5, treasury_y7, treasury_y10, treasury_y20, treasury_y30.
rate_value	float	no	-	Interest rate as a percent (4.36 means 4.36%, matching the InterestRateTick.rate convention) used in the Greeks calculation. Applied when rate_type selects a manual rate.
binomial_steps	int	no	101	Number of steps in the binomial tree used for the Greeks calculation. Accurate at higher values and cheaper at lower ones; the server's cost grows with the square of the value. An even value is rounded up to the next odd one, and an expiration=* request is capped at 101 steps.
version	string	no	latest	Greeks model version. Accepted values: latest, 1.
strike_range	int	no	-	Strike range filter
start_date	date	no	-	Start date YYYYMMDD
end_date	date	no	-	End date YYYYMMDD
timeout_ms	int	no	-	Per-request deadline in milliseconds. 0 means no deadline.

Response

Rows of GreeksThirdOrderTick:

Field	Type	Description
ms_of_day	i32	Milliseconds since midnight Eastern Time.
bid	f64	Last NBBO bid price.
ask	f64	Last NBBO ask price.
speed	f64	Rate of change of gamma with respect to the underlying price.
zomma	f64	Sensitivity of gamma to a change in implied volatility.
color	f64	Rate of change of gamma over time.
ultima	f64	Sensitivity of vomma to a change in implied volatility.
implied_volatility	f64	Implied volatility solved from the option price. The vendor names this column IMPLIED_VOL.
iv_error	f64	Residual pricing error of the implied-volatility solve.
underlying_ms_of_day	i32	Timestamp of the underlying price, milliseconds since midnight ET. The vendor names this column MS_OF_DAY2.
underlying_price	f64	Underlying price used in the calculation (midpoint of the underlying).
date	i32	Trading date as a YYYYMMDD integer.
underlying_date	i32	Trading date of the underlying price as a YYYYMMDD integer, decoded from the same wire column as underlying_ms_of_day. It differs from date when the underlying price and the option quote come from different sessions.

Wildcard requests additionally populate expiration (YYYYMMDD), strike (dollars), and right ("C" / "P") on every row to identify the contract; on single-contract requests these are absent (None / null / undefined; the Rust and C rows carry the documented 0 / 0.0 / '\0' fills).