Skip to content

V3_STOCK_HISTORY_TRADE()

StandardPro

Returns every trade reported by UTP & CTA. Set the venue parameter to nqb to access current-day real-time historic data from the Nasdaq Basic feed if the account has a stocks standard or pro subscription.

  • Multi-day requests are limited to 1 month of data.

Example

=THETADATA.V3_STOCK_HISTORY_TRADE("AAPL", "", "09:30:00", "16:00:00", "nqb", "20240102", "20240105")

Parameters

symbolRequired  -

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

Type: string
Behavior: Required.
date  -

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

Type: string
Behavior: Optional.
start_time  -

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

Type: string
Behavior: Optional (default: 09:30:00).
end_time  -

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

Type: string
Behavior: Optional (default: 16:00:00).
venue  -

Used to specify the venue of the real time or historic request. nqb = Nasdaq Basic; utp_cta = merged UTP & CTA.

Type: string
Behavior: Optional (default: nqb).
Enumnqb, utp_cta
start_date  -

The start date (inclusive).

Type: string
Behavior: Optional.
end_date  -

The end date (inclusive).

Type: string
Behavior: Optional.

Returns

A grid (string[][]) - a header row followed by one row per result. See the REST API reference for the full response schema.