ThetaData v3
Search K

Appearance

option_history_trade_quote() ​

StandardPro
  • Returns every trade reported by OPRA paired with the last NBBO quote reported by OPRA at the time of trade.
  • A quote is matched with a trade if its timestamp <= the trade timestamp.
  • To match trades with quotes timestamps that are < the trade timestamp, specify the exclusiveparameter to true. After thorough testing, we have determined that using exclusive=true might yield better results for various applications.
  • Multi-day requests are limited to 1 month of data, and must specify an expiration.

Parameters

date  -

The date to fetch data for. If present, this overrides start_date and end_date.

Type: datetime.date
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
start_time  -

The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS).

Type: datetime.time (Default: 09:30:00)
end_time  -

The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS).

Type: datetime.time (Default: 16:00:00)
exclusive  -

If you prefer to match quotes with timestamps that are < the trade timestamp.

Type: boolean (Default: true)
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
start_date  -

The start date (inclusive).

Type: datetime.date
end_date  -

The end date (inclusive).

Type: datetime.date

Sample Code ​

py

Response ​

Returns every trade quote for an option contract

array of: