---
title: "CBOE put/call ratio history for one ratio type, newest first. Only rows whose ratio reconciles with its own volumes are served. Data runs from late 2006 to present; the Vix ratio type starts October 2019, and pre-2013 history is sampled roughly weekly."
method: GET
path: "/v1/market/put-call-ratios"
tags: ["Market"]
---

# CBOE put/call ratio history for one ratio type, newest first. Only rows whose ratio reconciles with its own volumes are served. Data runs from late 2006 to present; the Vix ratio type starts October 2019, and pre-2013 history is sampled roughly weekly.

`GET /v1/market/put-call-ratios`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/market/put-call-ratios`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/market/put-call-ratios/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `type` string
- `startDate` string, date
- `endDate` string, date
- `limit` integer
- `offset` integer

## Response `200`

OK

- PutCallRatioDtoPagedResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` PutCallRatioDto[], nullable
    - `date` string, date
    - `callVolume` integer, nullable
    - `putVolume` integer, nullable
    - `totalVolume` integer, nullable
    - `putCallRatio` number, double, nullable
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)