Skip to content

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

client = Client.from_env()

rows = client.market_data.stock_snapshot_trade(
    "AAPL",
)
for t in rows:
    print(t.date, t.ms_of_day, t.price, t.size)
Sample response · JSON
[
  {
    "condition": 1,
    "price": 225.75,
    "sequence": 63539137,
    "size": 23,
    "symbol": "AAPL",
    "timestamp": "2025-08-20T16:36:05.549"
  }
]

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 TradeTick:

FieldTypeDescription
ms_of_dayi32Milliseconds since midnight Eastern Time.
sequencei32Exchange-assigned trade sequence number.
ext_condition1i32Additional trade condition code.
ext_condition2i32Additional trade condition code.
ext_condition3i32Additional trade condition code.
ext_condition4i32Additional trade condition code.
conditioni32Trade condition code.
sizei32Number of contracts or shares traded.
exchangei32Exchange code where the trade executed.
pricef64Trade price.
condition_flagsi32Trade condition flags bitmap.
price_flagsi32Trade price flags bitmap.
volume_typei32Volume reporting mode: 0 = incremental, 1 = cumulative.
records_backi32Offset of this record behind the most recent record.
datei32Trading date as a YYYYMMDD integer.

Released under the Apache-2.0 License.