Historical Market Data
get_historical_data(
contract: [Contract Object](/tws-api/doc/contracts-financial-instruments/the-contract-object). Contract to retrieve market data for.
end_date_time: String. The request’s end date and time. This should be formatted as “YYYYMMDD HH:mm:ss TMZ”. You may also pass an empty string to indicate the current moment
Please be aware that endDateTime must be left as an empty string when requesting continuous futures contracts or certain whatToShow values like ADJUSTED_LAST.
duration_str: String. The total timespan the bars should cover. See [Duration](/tws-api/doc/market-data-historical/historical-bars/duration) for details.
bar_size_setting: String. The time span covered by each bar. See [Bar Sizes](/tws-api/doc/market-data-historical/historical-bars/historical-bar-sizes) for details.
what_to_show: String. Determines what kind of data should be returned. See [whatToShow](/tws-api/doc/market-data-historical/historical-bar-what-to-show/introduction) for more details.
use_rth: Boolean. Define if data should only be returned from the regular trading session or if extended trading hours should be included.
Default: True is passed by default, only returning data from the regular trading sesions.
format_date: Integer. Determine the return structure of the date. Supports (1) to return a datetime formatting string or 2 to return a epoch Unix timestamp.
Default: Set to 1, returning a datetime string.
timeout: Integer. A default value of 30 is supplied.
)
Response Object
Requesting historical bars will return return a list containing all [Bar] objects for the duration. Please be aware that directly printing this information may result in the memory address being displayed.