Fetch bar data for a given symbol and period
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 | stringEQUITYCRYPTOOPTIONINDEX | 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
}
}