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

# Retrieve Option Contracts

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

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.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/revisions/0b37cadfb125/schema)