Trade (v3)

StandardPro

GET

https://localhost:25503/v3/option/history/trade

REQUIRED

The v3 Theta Terminal must be running to access data.

• Returns every trade reported by OPRA.
• Trade condition mappings can be found here.
• Extended trade conditions are not reported by OPRA for options, so they can be ignored.

Sample URL

Paste the URL below into your browser while the Theta Terminal is running.

Returns every trade for an option contract

http://localhost:25503/v3/option/history/trade?symbol=AAPL&expiration=20241108&strike=220.000&right=call&date=20241104

Returns every trade for all option contracts

http://localhost:25503/v3/option/history/trade?symbol=AAPL&expiration=*&date=20241104

Query Parameters

dateRequired  -

The date to fetch data for.

Type: string

symbolRequired  -

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

Type: string

expirationRequired  -

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

Type: string

strike  -

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

Type: string (Default: *)

right  -

The right (call or put) of the contract.

Type: string (Default: both)

Enumcall, put, both

start_time  -

The start time (inclusive) in the specified day.

Type: string (Default: 09:30:00)

end_time  -

The end time (inclusive) in the specified day.

Type: string (Default: 16:00:00)

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: int32

format  -

The format of the data when returned to the user.

Type: string (Default: csv)

Enumcsv, json, ndjson, html

Responses

Returns every trade for an option contract

Content-Type

array of:

Sample Code

Python