Skip to main content
GET
Get Options K-line (OHLCV) data

Authorizations

X-API-Key
string
header
required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol
string
required

Underlying symbol (e.g. SPY, AAPL)

options_ticker
string
required

OCC-format options ticker (e.g. O:SPY260620C00570000)

interval
enum<string>
required

Interval

Available options:
1min,
2min,
3min,
5min,
10min,
15min,
30min,
45min,
1h,
2h,
4h,
1d,
1w,
1m
start_time
integer
required

Start time (Unix seconds)

end_time
integer
required

End time (Unix seconds)

limit
integer

Limit (default 500, max 10000)

include_partial
boolean

Also return the current, not-yet-closed bar as the first element (data is newest first). Intraday intervals: on weekdays from 9:30 ET until midnight ET. 1d/1w/1m: at any time; until Polygon publishes a day's daily aggregate (hours after the close), that day's bar is rebuilt from its 1-minute bars so it does not drop out. It is built from 1-minute bars fetched from Polygon REST at request time, so it is only as fresh as Polygon's closed minute aggregates, and it stops at end_time. time_close follows the same convention as closed bars (open + interval; 1d closes at the next 00:00 ET, 1w/1m at the next bucket start), so it can be in the future. No intraday partial bar before 9:30 ET or on weekends, and no bar for a market holiday. limit still caps the total, dropping the oldest bar. Default false: closed bars only.

Response

Options kline data

data
object[]
error
object
metadata
any
pagination
any
request_id
string
success
boolean