Skip to content

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.
AAPL
Client
Auth
Style
from thetadatadx import Client

client = Client.from_env()

rows = client.market_data.stock_snapshot_market_value(
    "AAPL",
)
for t in rows:
    print(t.date, t.market_price)
Sample response · JSON
[
  {
    "market_ask": 595.55,
    "market_bid": 590.6,
    "market_price": 593.07,
    "symbol": "CVCO",
    "timestamp": "2025-12-16T11:47:50.854"
  },
  {
    "market_ask": 27.69,
    "market_bid": 26.77,
    "market_price": 27.23,
    "symbol": "KLXY",
    "timestamp": "2025-12-16T11:02:05.409"
  },
  {
    "market_ask": 80.27,
    "market_bid": 80.23,
    "market_price": 80.25,
    "symbol": "FXR",
    "timestamp": "2025-12-16T11:47:52.923"
  }
]

Parameters

NameTypeRequiredDefaultDescription
symbolsymbolsyesComma-separated ticker symbols (e.g. AAPL,MSFT)
venuestringnonqbVenue/exchange filter. Accepted values: nqb, utp_cta.
min_timestringnoMinimum time filter
timeout_msintnoPer-request deadline in milliseconds. 0 means no deadline.

Response

Rows of MarketValueTick:

FieldTypeDescription
ms_of_dayi32Milliseconds since midnight Eastern Time.
market_bidf64Last market bid.
market_askf64Last market ask.
market_pricef64Market value derived from the last NBBO.
datei32Trading date as a YYYYMMDD integer.

Released under the Apache-2.0 License.