Trade

FreeValueStandardPro

Get the latest trade snapshot for one or more stocks.

Returns a real-time last trade from the Nasdaq Basic feed if the account has a stocks standard or pro subscription.

• Theta Data resets its snapshot cache at midnight ET every day. This endpoint may not work on a weekend where there were no eligible messages sent over exchange feeds. We recommend using historic requests during the weekend.

pub fn stock_snapshot_trade(&self, symbols: &[&str]) -> StockSnapshotTradeBuilder<'_>

Optional parameters chain on the builder: .venue(&str), .min_time(&str). Execute with .await → Result<Vec<TradeTick>, Error>, or decode chunk-by-chunk with .stream(handler).

Example

let rows = tdx.stock_snapshot_trade(&["AAPL"]).await?;
for t in &rows {
    println!("date={} ms_of_day={} price={} size={}", t.date, t.ms_of_day, t.price, t.size);
}

ThetaDataDxClient.stock_snapshot_trade(
    symbols,
    *,
    venue=None, min_time=None, timeout_ms=None,
) -> list[TradeTick]

stock_snapshot_trade_async(...) awaits the same call shape.

Example

rows = tdx.stock_snapshot_trade(["AAPL"])
for t in rows:
    print(t.date, t.ms_of_day, t.price, t.size)

stockSnapshotTrade(symbols: Array<string>, options?: { ... }): Promise<Array<TradeTick>>

Optional parameters ride in a single trailing options object: venue?: string, minTime?: string | Date, timeoutMs?: number.

Example

const rows = await tdx.stockSnapshotTrade(['AAPL']);
for (const t of rows) {
  console.log(t.date, t.msOfDay, t.price, t.size);
}

std::vector<TradeTick> stock_snapshot_trade(
    const std::vector<std::string>& symbols,
    const EndpointRequestOptions& options = {}) const;

Optional parameters chain on EndpointRequestOptions: .with_venue(...), .with_min_time(...). Throws tdx::Error on failure.

Example

auto rows = client.stock_snapshot_trade({"AAPL"});
for (const auto& t : rows) {
    std::cout << t.date << ' ' << t.ms_of_day << ' ' << t.price << ' ' << t.size << "\n";
}

GET http://127.0.0.1:25503/v3/stock/snapshot/trade

Served by the bundled server binary; responses stream as JSON, CSV, or NDJSON via the format parameter.

Example

curl 'http://127.0.0.1:25503/v3/stock/snapshot/trade?symbol=AAPL'

Parameters

Name	Type	Required	Default	Description
symbol	symbols	yes	—	Comma-separated ticker symbols (e.g. AAPL,MSFT)
venue	string	no	nqb	Venue/exchange filter. Accepted values: nqb, utp_cta.
min_time	string	no	—	Minimum time filter
timeout_ms	int	no	—	Per-request deadline in milliseconds. 0 means no deadline.

Response

Rows of TradeTick:

Field	Type	Description
ms_of_day	i32	Milliseconds since midnight Eastern Time.
sequence	i32	Exchange-assigned trade sequence number.
ext_condition1	i32	Additional trade condition code.
ext_condition2	i32	Additional trade condition code.
ext_condition3	i32	Additional trade condition code.
ext_condition4	i32	Additional trade condition code.
condition	i32	Trade condition code.
size	i32	Number of contracts or shares traded.
exchange	i32	Exchange code where the trade executed.
price	f64	Trade price.
condition_flags	i32	Trade condition flags bitmap.
price_flags	i32	Trade price flags bitmap.
volume_type	i32	Volume reporting mode: 0 = incremental, 1 = cumulative.
records_back	i32	Offset of this record behind the most recent record.
date	i32	Trading date as a YYYYMMDD integer.