Fetch bar data for a given symbol and period
aggregation setting the size of each bar, from ONE_MINUTE to ONE_YEAR.Get a month of AAPL as one bar per day. The code samples and the playground use this request.
The symbol to fetch bar data for
The time period for the bar data
Instrument type. Used as a suffix on the symbol internally (EQUITY = no suffix).
Aggregation override for the bar data.
Required for SINCE_PURCHASE. YYYY-MM-DD
Which sessions to include on the DAY and WEEK equity charts. REGULAR_HOURS = 09:30-16:00 only; REGULAR_AND_EXTENDED_HOURS = 04:00-20:00 (default when omitted); ALL_SESSIONS = adds the overnight ATS sessions. On DAY, ALL_SESSIONS expands to a midnight-midnight axis and adds the separate preMarketOvernight (00:00-04:00) and postMarketOvernight (20:00-24:00) fields. On WEEK, ALL_SESSIONS switches the chart to full 24/5 coverage (extended hours + overnight ATS) merged chronologically into the single continuous regularMarket series (no separate overnight fields); default and REGULAR_HOURS keep the regular-hours-only WEEK chart unchanged. Unknown values fall back to REGULAR_AND_EXTENDED_HOURS.
Optional. The asset's IPO / first-trade date (YYYY-MM-DD). When the asset is younger than the requested period, the backend fetches a finer aggregation over the available post-IPO history (so the chart isn't a straight diagonal) and returns a `leadingFill` object describing the flat lead-in for the pre-IPO portion. When omitted, behavior is unchanged. A future or unparseable value is ignored. Not applied to the DAY chart. See the `leadingFill` schema.
| Name | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | The symbol to fetch bar data for |
| period | stringDAYWEEKMONTHQUARTERHALF_YEARYEARFIVE_YEARSTEN_YEARSALLYTDSINCE_PURCHASE | Yes | The time period for the bar data |
| purchaseDate | string | No | Required for SINCE_PURCHASE. YYYY-MM-DD |
| tradingSessionToggle | stringREGULAR_HOURSREGULAR_AND_EXTENDED_HOURSALL_SESSIONS | No | Which sessions to include on the DAY and WEEK equity charts. REGULAR_HOURS = 09:30-16:00 only; REGULAR_AND_EXTENDED_HOURS = 04:00-20:00 (default when omitted); ALL_SESSIONS = adds the overnight ATS sessions. On DAY, ALL_SESSIONS expands to a midnight-midnight axis and adds the separate preMarketOvernight (00:00-04:00) and postMarketOvernight (20:00-24:00) fields. On WEEK, ALL_SESSIONS switches the chart to full 24/5 coverage (extended hours + overnight ATS) merged chronologically into the single continuous regularMarket series (no separate overnight fields); default and REGULAR_HOURS keep the regular-hours-only WEEK chart unchanged. Unknown values fall back to REGULAR_AND_EXTENDED_HOURS. |
| ipoDate | string | No | Optional. The asset's IPO / first-trade date (YYYY-MM-DD). When the asset is younger than the requested period, the backend fetches a finer aggregation over the available post-IPO history (so the chart isn't a straight diagonal) and returns a `leadingFill` object describing the flat lead-in for the pre-IPO portion. When omitted, behavior is unchanged. A future or unparseable value is ignored. Not applied to the DAY chart. See the `leadingFill` schema. |
| type | stringEQUITYCRYPTOOPTIONINDEXEVENTCONTRACT | Yes | Instrument type. Used as a suffix on the symbol internally (EQUITY = no suffix). |
| aggregation | stringONE_MINUTEFIVE_MINUTESTEN_MINUTESFIFTEEN_MINUTESTHIRTY_MINUTESONE_HOURONE_DAYONE_WEEKONE_MONTHTHREE_MONTHSSIX_MONTHSONE_YEAR | Yes | Aggregation override for the bar data. |
No request body defined
Successful response with bar data
No response body defined
{
"symbol": "string",
"period": "string",
"totalExpectedBars": 123,
"previousClosePrice": "string",
"totalGainLoss": "string",
"totalGainLossPercentage": "string",
"preMarket": {
"expectedBars": 123,
"bars": [
{
"timestamp": "string",
"open": "string",
"close": "string",
"high": "string",
"low": "string",
"value": "string",
"volume": 123,
"gainAmount": "string",
"gainPercentage": "string"
}
]
},
"regularMarket": {
"expectedBars": 123,
"bars": [
{
"timestamp": "string",
"open": "string",
"close": "string",
"high": "string",
"low": "string",
"value": "string",
"volume": 123,
"gainAmount": "string",
"gainPercentage": "string"
}
]
},
"afterMarket": {
"expectedBars": 123,
"bars": [
{
"timestamp": "string",
"open": "string",
"close": "string",
"high": "string",
"low": "string",
"value": "string",
"volume": 123,
"gainAmount": "string",
"gainPercentage": "string"
}
]
},
"preMarketOvernight": {
"expectedBars": 123,
"bars": [
{
"timestamp": "string",
"open": "string",
"close": "string",
"high": "string",
"low": "string",
"value": "string",
"volume": 123,
"gainAmount": "string",
"gainPercentage": "string"
}
]
},
"postMarketOvernight": {
"expectedBars": 123,
"bars": [
{
"timestamp": "string",
"open": "string",
"close": "string",
"high": "string",
"low": "string",
"value": "string",
"volume": 123,
"gainAmount": "string",
"gainPercentage": "string"
}
]
},
"lastTradingSessionClose": {
"close": "string",
"closeDate": "string",
"change": "string",
"percentChange": "string"
},
"regularSessionClosingData": {
"timestamp": "string",
"price": "string"
},
"lastRegularTradingSessionClose": {
"close": "string",
"closeDate": "string",
"change": "string",
"percentChange": "string"
},
"leadingFill": {
"startTimestamp": "string",
"endTimestamp": "string",
"value": "string",
"count": 123,
"includedInTotalExpectedBars": true
}
}