---
title: "Options Contracts"
method: GET
path: "/v3/reference/options/contracts"
tags: ["reference:options:contracts:list"]
---

# Options Contracts

`GET /v3/reference/options/contracts`

Query for historical options contracts. This provides both active and expired options contracts.

## Query parameters

- `underlying_ticker` string
- `ticker` string
- `contract_type` 'call' | 'put'
- `expiration_date` string
- `as_of` string
- `strike_price` number
- `expired` boolean
- `underlying_ticker.gte` string
- `underlying_ticker.gt` string
- `underlying_ticker.lte` string
- `underlying_ticker.lt` string
- `expiration_date.gte` string
- `expiration_date.gt` string
- `expiration_date.lte` string
- `expiration_date.lt` string
- `strike_price.gte` number
- `strike_price.gt` number
- `strike_price.lte` number
- `strike_price.lt` number
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'ticker' | 'underlying_ticker' | 'expiration_date' | 'strike_price'

## Response `200`

A list of options contracts

- object
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string — A request id assigned by the server.
  - `results` object[] — An array of results containing the requested data.
    - `additional_underlyings` object[] — If an option contract has additional underlyings or deliverables associated with it, they will appear here. See <a rel="noopener noreferrer nofollow" target="_blank" href="https://www.optionseducation.org/referencelibrary/faq/splits-mergers-spinoffs-bankruptcies">here</a> for some examples of what might cause a contract to have additional underlyings.
      - `amount` number — The number of shares per contract of the additional underlying, or the cash-in-lieu amount of the currency.
      - `type` string — The type of the additional underlying asset, either equity or currency.
      - `underlying` string — The name of the additional underlying asset.
    - `cfi` string — The 6 letter CFI code of the contract (defined in <a rel="nofollow" target="_blank" href="https://en.wikipedia.org/wiki/ISO_10962">ISO 10962</a>)
    - `contract_type` string — The type of contract. Can be "put", "call", or in some rare cases, "other".
    - `correction` integer — The correction number for this option contract.
    - `exercise_style` 'american' | 'european' | 'bermudan' — The exercise style of this contract. See <a rel="nofollow" target="_blank" href="https://en.wikipedia.org/wiki/Option_style">this link</a> for more details on exercise styles.
    - `expiration_date` string — The contract's expiration date in YYYY-MM-DD format.
    - `primary_exchange` string — The MIC code of the primary exchange that this contract is listed on.
    - `shares_per_contract` number — The number of shares per contract for this contract.
    - `strike_price` number — The strike price of the option contract.
    - `ticker` string — The ticker for the option contract.
    - `underlying_ticker` string — The underlying ticker that the option contract relates to.
  - `status` string — The status of this request's response.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)