Skip to main content
GET
Get one session of 1-minute option contract bars

Path Parameters

contract_symbol
string
required

Response

Option premium bars or an explicit no-data response

Response model for chart data.

symbol
string
required

Stock symbol

interval
enum<string>
required

Candle interval

Available options:
1m,
2m,
5m,
15m,
30m,
1h,
1d
period
enum<string>
required

Time period

Available options:
1d,
5d,
1m,
3m,
6m,
1y,
5y
candles
ChartBar · object[]
required

OHLCV candle data

warmup_count
integer
default:0

Number of leading bars that are warmup data for indicator computation

is_lookback
boolean
default:false

True when the requested window contained no fresh data. When True with an empty candles array, the underlying data is stale (see staleness_seconds) and was intentionally withheld rather than silently served.

last_bar_time
string | null

ISO timestamp of the most recent bar available for the symbol

last_source_bar_time
string | null

ISO timestamp of the latest source minute included in the final returned candle. For rolled intraday candles this differs from bucket-start last_bar_time.

staleness_seconds
integer | null

Seconds between now and the most recent bar available for the symbol. Populated whenever is_lookback is True; None for fresh responses.

data_status
enum<string>
default:ok

High-level data status. 'ok' = fresh bars returned. 'stale' = no fresh bars in the requested window, refused on fail-closed policy (see staleness_seconds). 'no_data' = no bars available for this symbol at all.

Available options:
ok,
stale,
no_data
source
string
default:realtime_sip

Market-data feed source label (entitlement layer). 'realtime_sip' = real-time SIP bars (entitled caller). 'delayed' = upper time bound clamped to now - 15m for non-entitled callers per SIP redistribution policy. 'byok' = served under the user's own Alpaca data entitlement.