Market Value

FreeValueStandardPro

Get the latest market value snapshot for one or more stocks.

• Returns a real-time market value derived from the last BBO quote from the Nasdaq Basic feed if the account has a stocks standard or pro subscription.
• Returns a 15-minute delayed market value derived from an NBBO quote from the UTP & CTA feeds if the account has the stocks value subscription 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_market_value(&self, symbols: &[&str]) -> StockSnapshotMarketValueBuilder<'_>

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

Example

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

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

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

Example

rows = tdx.stock_snapshot_market_value(["AAPL"])
for t in rows:
    print(t.date, t.market_price)

stockSnapshotMarketValue(
  symbols: Array<string>, options?: { ... },
): Promise<Array<MarketValueTick>>

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

Example

const rows = await tdx.stockSnapshotMarketValue(['AAPL']);
for (const t of rows) {
  console.log(t.date, t.marketPrice);
}

std::vector<MarketValueTick> stock_snapshot_market_value(
    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_market_value({"AAPL"});
for (const auto& t : rows) {
    std::cout << t.date << ' ' << t.market_price << "\n";
}

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

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/market_value?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 MarketValueTick:

Field	Type	Description
ms_of_day	i32	Milliseconds since midnight Eastern Time.
market_bid	f64	Last market bid.
market_ask	f64	Last market ask.
market_price	f64	Market value derived from the last NBBO.
date	i32	Trading date as a YYYYMMDD integer.