Skip to content

option_snapshot_greeks_implied_volatility()

StandardPro

Returns implied volatilies calculated using the national best bid, mid, and ask price
of the option respectively. The underlying price represents whatever the last underlying price was at the
underlying_timestamp field. You can read more about how Theta Data calculates greeks
here.

Parameters

symbolRequired  -

The stock or index symbol, or underlying symbol for options.

Type: str
expirationRequired  -

The expiration of the contract in YYYY-MM-DD or YYYYMMDD format, or * for all expirations.

Type: datetime.date
strike  -

The strike price of the contract in dollars (ie 100.00 for $100.00), or * for all strikes.

Type: str (Default: *)
right  -

The right (call or put) of the contract.

Type: str (Default: both)
Enumcall, put, both
annual_dividend  -

The annualized expected dividend amount to be used in Greeks calculations.

Type: float
rate_type  -

The interest rate type to be used in a Greeks calculation.

Type: str (Default: sofr)
Enumsofr, treasury_m1, treasury_m3, treasury_m6, treasury_y1, treasury_y2, treasury_y3, treasury_y5, treasury_y7, treasury_y10, treasury_y20, treasury_y30
rate_value  -

The interest rate, as a percent, to be used in a Greeks calculation.

Type: float
stock_price  -

The underlying stock price to be used in the Greeks calculation.

Type: float
version  -

Used to adjust Greeks calculation methodology. "1" uses a fixed .15 DTE for 0DTE; "latest" uses real TTE (down to a minimum of 1 hour)

Type: str (Default: latest)
Enumlatest, 1
max_dte  -

If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned.

Type: int
strike_range  -

Used to specify a filter to limit the number of contracts returned relative to the underlying's spot price. Will return the specified number of strikes above and below the spot price, as well as the at-the-money strike.

Type: int
min_time  -

Filters snapshots to include only data with a timestamp greater or equal to the specified value (HH:mm:ss.SSS format).

Type: datetime.time
use_market_value  -

Use the market value bid, ask, and price

Type: boolean (Default: false)

Sample Code

py

Response

Returns implied volatility for an option contract

array of: