---
title: "Get Option Contracts (BETA)"
method: GET
path: "/v1/options/contracts"
tags: ["Assets"]
---

# Get Option Contracts (BETA)

`GET /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 parameters

- `underlying_symbols` string
- `show_deliverables` boolean
- `status` 'active' | 'inactive'
- `expiration_date` string, date
- `expiration_date_gte` string, date
- `expiration_date_lte` string, date
- `root_symbol` string
- `type` 'call' | 'put'
- `style` 'american' | 'european'
- `strike_price_gte` number
- `strike_price_lte` number
- `page_token` string
- `limit` integer
- `ppind` boolean

## Response `200`

Successful Response.

- object
  - `next_page_token` string, nullable — Use this token in your next API call to paginate through the dataset and retrieve the next page of results. A null token indicates there are no more data to fetch.
  - `option_contracts` OptionContract[], required
    - `close_price` string — The close price of the option contract.
    - `close_price_date` string, date — The date of the close price data.
    - `deliverables` OptionDeliverable[] — Represents the deliverables tied to the option contract. While standard contracts entail a single deliverable, non-standard ones can encompass multiple deliverables, each potentially customized with distinct parameters. This array is included in the list contracts response only if the query parameter show_deliverables=true is provided.
      - `allocation_percentage` string, required — Cost allocation percentage of the deliverable. This is used to determine the cost basis of the equity shares received from the exercise, specially for non-standard contracts with multiple deliverables.
      - `amount` string, required — The deliverable amount. For cash deliverables, this is the cash amount. For standard contract, this is always 100. This field can be null in case the deliverable settlement is delayed and the amount is yet to be determined.
      - `asset_id` string — Unique identifier of the deliverable asset. For standard contracts, this is equivalent to underlying_asset_id of the contracts. This field is not returned for cash deliverables.
      - `delayed_settlement` boolean, required — If true, the settlement of the deliverable will be delayed. For instance, in the event of a contract with a delayed deliverable being exercised, both the availability of the deliverable and its settlement may be postponed beyond the typical timeframe.
      - `settlement_method` 'BTOB' | 'CADF' | 'CAFX' | 'CCC', required — Indicates the settlement method that will be used: - **BTOB**: Broker to Broker - **CADF**: Cash Difference - **CAFX**: Cash Fixed - **CCC**: Correspondent Clearing Corp
      - `settlement_type` 'T+0' | 'T+1' | 'T+2' | 'T+3' | 'T+4' | 'T+5', required — Indicates when the deliverable will be settled if the contract is exercised/assigned.
      - `symbol` string, required — Symbol of the deliverable. For standard contracts, this is equivalent to the underlying symbol of the contract.
      - `type` 'cash' | 'equity', required — Type of deliverable, indicating whether it's cash or equity. For standard contracts, it is always "equity".
    - `expiration_date` string, date, required — The expiration date of the option contract.
    - `id` string, required — The unique identifier of the option contract.
    - `multiplier` string, required — The multiplier of the option contract is crucial for calculating both the trade premium and the extended strike price. In standard contracts, the multiplier is always set to 100. For instance, if a contract is traded at $1.50 and the multiplier is 100, the total amount debited when buying the contract would be $150.00. Similarly, when exercising a call contract, the total cost will be equal to the strike price times the multiplier.
    - `name` string, required — The name of the option contract.
    - `open_interest` string — The open interest of the option contract.
    - `open_interest_date` string, date — The date of the open interest data.
    - `root_symbol` string — The root symbol of the option contract.
    - `size` string, required — Represents the number of underlying shares to be delivered in case the contract is exercised/assigned. For standard contracts, this is always 100. This field should **not** be used as a multiplier, specially for non-standard contracts.
    - `status` 'active' | 'inactive', required — The status of the option contract.
    - `strike_price` string, required — The strike price of the option contract.
    - `style` 'american' | 'european', required — The style of the option contract.
    - `symbol` string, required — The symbol representing the option contract.
    - `tradable` boolean, required — Indicates whether the option contract is tradable.
    - `type` 'call' | 'put', required — The type of the option contract.
    - `underlying_asset_id` string, required — The unique identifier of the underlying asset.
    - `underlying_symbol` string, required — The underlying symbol of the option contract.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)