Option chain

get

https://data.alpaca.markets/v1beta1/options/snapshots/{underlying_symbol}

The option chain endpoint provides the latest trade, latest quote, and greeks for each contract symbol of the underlying symbol.

Path Params

underlying_symbol

string

required

The financial instrument on which an option contract is based or derived.

Query Params

feed

string

enum

Defaults to opra

The source feed of the data. opra is the official OPRA feed, indicative is a free indicative feed where trades are delayed and quotes are modified. Default: opra if the user has a subscription, otherwise indicative.

Allowed:

limit

integer

1 to 1000

Defaults to 100

Number of maximum snapshots to return in a response. The limit applies to the total number of data points, not the number per symbol! Use next_page_token to fetch the next set of responses.

updated_since

date-time

Filter to snapshots that were updated since this timestamp, meaning that the timestamp of the trade or the quote is greater than or equal to this value. Format: RFC-3339 or YYYY-MM-DD. If missing, all values are returned.

page_token

string

The pagination token from which to continue. The value to pass here is returned in specific requests when more data is available, usually because of a response result limit.

type

string

enum

Filter contracts by the type (call or put).

Allowed:

strike_price_gte

double

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

strike_price_lte

double

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

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.

root_symbol

string

Filter contracts by the root symbol.

Responses

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

500

Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

200OK

400One of the request parameters is invalid. See the returned message for details.

429Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.