Historical bars

GET {{baseUrl}}/v1beta1/options/bars?symbols=AAPL241220C00300000,AAPL240315C00225000&timeframe=1Min

The historical option bars API provides aggregates for a list of option symbols between the specified dates.

The returned results are sorted by symbol first then by bar timestamp. This means that you are likely to see only one symbol in your first response if there are enough bars for that symbol to hit the limit you requested on that request.

In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any bars were found for them.

Request Params

• [1-59]Min / T
• [1-23]Hour / H
• 1Day / D
• 1Week / W
• [1,2,3,4,6,12]Month / M | | start | string | | The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD. If missing, the default value is the beginning of the current day. | | end | string | | The inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD. If missing, the default value is the current time. | | limit | number | | The maximum number of data points to return in the response. The API may return less, even if there are more available data points in the requested interval. Always check the next_page_token for more pages. The limit applies to the total number of data points, not per symbol! | | page_token | string | | Pagination token to continue from. The value to pass here is returned in specific requests when more data is available than the request limit allows. | | sort | string | | Sort data in ascending or descending order. |

HEADERS

RESPONSES

status: OK

{"bars":{"AAPL240419P00140000":[{"t":"2024-01-18T05:00:00Z","o":0.38,"h":0.38,"l":0.34,"c":0.34,"v":12,"n":7,"vw":0.3525}]},"next_page_token":"QUFQTHxNfDIwMjItMDEtMDNUMDk6MDA6MDAuMDAwMDAwMDAwWg=="}