Get Option Contracts (BETA)

get

https://broker-api.sandbox.alpaca.markets/v1/options/contracts

This endpoint allows you to retrieve a list of option contracts based on various filtering criteria. By default only active contracts that expire before the upcoming weekend are returned.

Query Params

underlying_symbols

string

Filter contracts by one or more underlying symbols.

show_deliverables

boolean

Include deliverables array in the response.

status

string

enum

Filter contracts by status (active/inactive). By default only active contracts are returned.

Allowed:

expiration_date

date

Filter contracts by the exact expiration date (format: YYYY-MM-DD).

expiration_date_gte

date

Filter contracts with expiration date greater than or equal to the specified date.

expiration_date_lte

date

Filter contracts with expiration date less than or equal to the specified date. By default this is set to the next weekend.

root_symbol

string

Filter contracts by the root symbol.

type

string

enum

Filter contracts by the type (call/put).

Allowed:

style

string

enum

Filter contracts by the style (american/european).

Allowed:

strike_price_gte

number

Filter contracts with strike price greater than or equal to the specified value.

strike_price_lte

number

Filter contracts with strike price less than or equal to the specified value.

page_token

string

Used for pagination, this token retrieves the next page of results. It is obtained from the response of the preceding page when additional pages are available.

limit

integer

The number of contracts to limit per page (default=100, max=10000).

ppind

boolean

The ppind(Penny Program Indicator) field indicates whether an option contract is eligible for penny price increments, with true meaning it is part of the Penny Program and false meaning it is not.

Response

200Successful Response.