---
title: "Retrieve Option Contracts"
method: GET
path: "/api/stock/{ticker}/option-contracts"
---

# Retrieve Option Contracts

`GET /api/stock/{ticker}/option-contracts`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/stock/{ticker}/option-contracts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/stock/:ticker/option-contracts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all option contracts for the given ticker.

## Path parameters

- `ticker` string, required

## Query parameters

- `exclude_zero_dte` boolean
- `exclude_zero_oi_chains` boolean
- `exclude_zero_vol_chains` boolean
- `expiry` string, date
- `limit` integer
- `maybe_otm_only` boolean
- `option_type` 'call' | 'put'
- `vol_greater_oi` boolean

## Response `200`

Successful response with option contracts data.

- TickerOptionContractsResponse
  - `data` TickerOptionContract[]
    - `ask_volume` integer: The amount of volume that happened on the ask side.
    - `avg_price` string: The volume weighted average fill price of the contract.
    - `bid_volume` integer: The amount of volume that happened on the bid side.
    - `cross_volume` integer: The amount of cross volume. Cross volume consists of all transactions that have the cross trade code.
    - `floor_volume` integer: The amount of floor volume. Floor volume consists of all transactions that have the floor trade code.
    - `high_price` string: The highest fill on that contract.
    - `implied_volatility` string: The implied volatility for the last transaction.
    - `last_price` string: The last fill on the contract.
    - `low_price` string: The lowest fill on that contract.
    - `mid_volume` integer: The amount of volume that happened in the middle of the ask and bid.
    - `multi_leg_volume` integer: The amount of volume that happened as part of a multileg trade with another contract. This can be spreads, rolls, condors, butterflies, and more.
    - `nbbo_ask` string: The National Best Bid and Offer (NBBO) ask price.
    - `nbbo_bid` string: The National Best Bid and Offer (NBBO) bid price.
    - `no_side_volume` integer: The amount of volume that happened on no identifiable side. This can be late, out of sequence, and/or cross transactions.
    - `open_interest` integer: The open interest for the contract.
    - `option_symbol` string: The option symbol of the contract.
    - `prev_oi` integer: The previous trading day's open interest.
    - `stock_multi_leg_volume` integer: The amount of volume that happened as part of a stock transaction and possibly other option contracts. This can be covered calls and more.
    - `sweep_volume` integer: The amount of sweep volume. Sweep volume consists of all transactions that have the sweep trade code.
    - `total_premium` string: The total option premium.
    - `volume` integer: The contract volume.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)