Skip to content

Price

FreeValueStandardPro

Fetch the index price at a specific time of day across a date range.

  • Retrieves historical indices price reports. Exchanges typically generate a price report every second for popular indices like SPX.
  • The time_of_day parameter represents the 00:00:00.000 ET that the price should be provided for.
SPX · 20250303 · 20250306 · 10:30:00.000
Client
Auth
Style
from thetadatadx import Client

client = Client.from_env()

rows = client.market_data.index_at_time_price(
    "SPX", "20250303", "20250306", "10:30:00.000",
)
for t in rows:
    print(t.date, t.ms_of_day, t.price)
Sample response · JSON
[
  {
    "condition": 0,
    "exchange": 5,
    "ext_condition1": 255,
    "ext_condition2": 255,
    "ext_condition3": 255,
    "ext_condition4": 255,
    "price": 5725.15,
    "sequence": 0,
    "size": 0,
    "timestamp": "2024-11-04T09:30:01"
  },
  {
    "condition": 0,
    "exchange": 5,
    "ext_condition1": 255,
    "ext_condition2": 255,
    "ext_condition3": 255,
    "ext_condition4": 255,
    "price": 5722.43,
    "sequence": 0,
    "size": 0,
    "timestamp": "2024-11-05T09:30:01"
  },
  {
    "condition": 0,
    "exchange": 5,
    "ext_condition1": 255,
    "ext_condition2": 255,
    "ext_condition3": 255,
    "ext_condition4": 255,
    "price": 5864.89,
    "sequence": 0,
    "size": 0,
    "timestamp": "2024-11-06T09:30:01"
  }
]

Parameters

NameTypeRequiredDefaultDescription
symbolstringyesTicker symbol (e.g. AAPL)
start_datedateyesStart date YYYYMMDD
end_datedateyesEnd date YYYYMMDD
time_of_daystringyesET wall-clock time in HH:MM:SS.SSS (e.g. 09:30:00.000 for 9:30 AM ET; legacy 34200000 is also accepted)
timeout_msintnoPer-request deadline in milliseconds. 0 means no deadline.

Response

Rows of IndexPriceAtTimeTick:

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.
pricef64Index value at the requested time.
datei32Trading date as a YYYYMMDD integer.

Released under the Apache-2.0 License.