Historical OHLC Bar Data

GET

/iserver/marketdata/history

GET

/v1/api/iserver/marketdata/history

$ curl -G https://api.ibkr.com/v1/api/iserver/marketdata/history \
>      -d bar=1min \
>      -d conid=265598 \
>      -d period=1d

1 {
2   "barLength": 86400,
3   "chartPanStartTime": "20250521-00:00:00",
4   "data": [
5     {
6       "c": 212.11,
7       "h": 213.94,
8       "l": 210.58,
9       "o": 212.09,
10       "t": 1747229400000,
11       "v": 0
12     },
13     {
14       "c": 211.34,
15       "h": 212.97,
16       "l": 209.53,
17       "o": 211.32,
18       "t": 1747315800000,
19       "v": 0
20     },
21     {
22       "c": 211.07,
23       "h": 212.56,
24       "l": 209.77,
25       "o": 211.05,
26       "t": 1747402200000,
27       "v": 0
28     },
29     {
30       "c": 207.86,
31       "h": 209.48,
32       "l": 204.25,
33       "o": 207.84,
34       "t": 1747661400000,
35       "v": 0
36     }
37   ],
38   "direction": -1,
39   "high": "21394/0/1440",
40   "low": "20425/0/8640",
41   "mdAvailability": "S",
42   "messageVersion": 2,
43   "mktDataDelay": 0,
44   "negativeCapable": false,
45   "outsideRth": false,
46   "points": 3,
47   "priceDisplayRule": 1,
48   "priceDisplayValue": "2",
49   "priceFactor": 100,
50   "serverId": "4155828",
51   "startTime": "20250513-13:30:00",
52   "symbol": "AAPL",
53   "text": "APPLE INC",
54   "timePeriod": "1w",
55   "travelTime": 2,
56   "volumeFactor": 100
57 }

Request historical data for an instrument in the form of OHLC bars.

Query parameters

conidlongRequired

IB contract ID of the requested instrument.

periodstringRequiredDefaults to 1d

A time duration away from startTime into the future to be divided into bars of the specified width. Supported Period Sizes

min - Minutes
h - Hour(s)
d - Day(s)
w - Week(s)
m - Month(s)
y - Year(s)

A time duration away from startTime into the future to be divided into bars of the specified width. Supported Period Sizes * `min` - Minutes * `h` - Hour(s) * `d` - Day(s) * `w` - Week(s) * `m` - Month(s) * `y` - Year(s)

barstringRequiredDefaults to 1min

The width of the bars into which the interval determined by period and startTime will be divided. It is not required that bar evenly divide period; partial bars can be returned. Supported Bar Sizes

S - Second(s)
min - Minute(s)
h - Hour(s)
d - Day(s)
w - Week(s)
m - Month(s)

The width of the bars into which the interval determined by period and startTime will be divided. It is not required that bar evenly divide period; partial bars can be returned. Supported Bar Sizes * `S` - Second(s) * `min` - Minute(s) * `h` - Hour(s) * `d` - Day(s) * `w` - Week(s) * `m` - Month(s)

exchangestringOptional

Exchange (or SMART) from which data is requested.

outsideRthbooleanOptionalDefaults to false

Indicates whether data outside of regular trading hours should be included in response.

startTimestringOptional

A fixed UTC date-time reference point for the historical data request, from which the specified period extends. Format is YYYYMMDD-hh:mm:ss. If omitted, the current time is used, and direction must be omitted or 1.

directionenumOptionalDefaults to -1

Indicates whether data should begin or end at the start time.

-1 - Historical data will begin away from the start time, ending at the current time/startTime.
1 - Historical data begins at the start time, moving towards the current time. Only supported when startTime is included.

Indicates whether data should begin or end at the start time. * `-1` - Historical data will begin away from the start time, ending at the current time/startTime. * `1` - Historical data begins at the start time, moving towards the current time. Only supported when startTime is included.

Allowed values:

sourcestringOptionalDefaults to Last

The type of data to be returned in the historical bars. Supported Bar Sizes

Bid_Ask - The OHLC bid/ask values.
Last - The OHLC trade values.
Midpoint - The OHLC of the Bid-Ask midpoint.

The type of data to be returned in the historical bars. Supported Bar Sizes * `Bid_Ask` - The OHLC bid/ask values. * `Last` - The OHLC trade values. * `Midpoint` - The OHLC of the Bid-Ask midpoint.

Response

Historical data query successfully returned data.

iserverHistoryBidAskResponseobject

Object containing the requested historical data and related metadata.

iserverHistoryLastResponseobject

Object containing the requested historical data and related metadata.

iserverHistoryMidpointResponseobject

Object containing the requested historical data and related metadata.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error