Fetch bar data for a given symbol and period
tradingSessionToggle applies to DAY and WEEK equity charts and defaults to regular and extended hours.SINCE_PURCHASE requires purchaseDate. To choose the bar size, use Get bars v2 with aggregation.Get today's AAPL bars for regular market hours only. 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).
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). |
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
}
}