Skip to content

Trade (v3)

StandardPro

REQUIRED

The v3 Theta Terminal must be running to access data.

  • Retrieve the real-time last trade of an option contract.
  • You might need to change the default expiration date to a different date if it is past the current date.
  • This endpoint will return no data if the market was closed for the day. Theta Data resets the snapshot cache at midnight ET every night.

Sample URL

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

Returns last trade for all option contracts with an expiration of 2027-01-15
http://127.0.0.1:25503/v3/option/snapshot/trade?symbol=AAPL&expiration=2027-01-15

Query Parameters

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.

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
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: integer
min_time  -

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

Type: string
format  -

The format of the data when returned to the user.

Type: string (Default: csv)
Enumcsv, json, ndjson, html

Responses

Returns last NBBO quote for an option contract

array of:

Sample Code

py