---
title: "Retrieve Expiry Breakdown"
method: GET
path: "/api/stock/{ticker}/expiry-breakdown"
---

# Retrieve Expiry Breakdown

`GET /api/stock/{ticker}/expiry-breakdown`

## Request

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

Returns all expirations for the given trading day for a ticker.

## Path parameters

- `ticker` string, required

## Query parameters

- `date` string, date

## Response `200`

Successful response with expiry breakdown data.

- ExpiryBreakdownResponse
  - `data` ExpiryBreakdownEntry[]
    - `chains` integer: The total amount of chains for that expiry.
    - `expiry` string, date: The contract expiry date in ISO format.
    - `open_interest` integer: The total open interest for that expiry.
    - `volume` integer: The total volume for that expiry.

## 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)