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

# Retrieve Expiry Breakdown

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

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