EQequibles
Options

Past bars for one option contract by its OCC symbol, active or expired, newest first: open, high, low, close, volume, VWAP and trade count. A period without trades has no bar, so a gap means no trades. `timeframe` is day (default, last 90 days), hour (last 7 days) or minute (last 4 days); `startDate` and `endDate` set another window. History begins in early 2024. Plus receives bars 15 minutes after they end; Pro receives them as they form, with `final: false` on a bar read before its period ended. The Free plan covers end-of-day data only and receives 403. Open interest, greeks and bid/ask have no history here; implied volatility history is `/options/volatility`. US listings only.

get/v1/stocks/{ticker}/options/contract/bars

Request

Path parameters

tickerstring required

Exact listed underlying (e.g. GOOG, GOOGL, BRK-A, or BRK-B). A listing never falls through to its sibling; dot class-share spelling such as BRK.B is accepted as BRK-B.

Query parameters

symbolstring

OCC option symbol (e.g. O:AAPL270617C00350000).

timeframestring

Bar size: day, hour or minute (default: day).

startDatestring

First date, YYYY-MM-DD (default depends on timeframe).

endDatestring

Last date, YYYY-MM-DD (default: today).

limitinteger

Maximum bars to return, newest first (default: 250, max: 500).

Response

OK

tickerstring nullable
timeframestring nullable
startDatestring date
endDatestring date
returnedinteger
truncatedboolean

True when older bars exist in the window; pass the oldest bar's session as endDate, or raise limit when it already is your endDate.

delayedboolean

True on Plus, where bars younger than 15 minutes are withheld.

Changes

No recorded changes to this operation across all 1 revision of this API.