---
title: "GET /stocks/v1/short-interest"
method: GET
path: "/stocks/v1/short-interest"
tags: ["reference"]
---

# GET /stocks/v1/short-interest

`GET /stocks/v1/short-interest`

Comprehensive FINRA short interest data that tracks the short selling metrics for securities on a specific settlement date.

## Query parameters

- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `days_to_cover` number, double
- `days_to_cover.any_of` string
- `days_to_cover.gt` number, double
- `days_to_cover.gte` number, double
- `days_to_cover.lt` number, double
- `days_to_cover.lte` number, double
- `settlement_date` string
- `settlement_date.any_of` string
- `settlement_date.gt` string
- `settlement_date.gte` string
- `settlement_date.lt` string
- `settlement_date.lte` string
- `avg_daily_volume` integer
- `avg_daily_volume.any_of` string
- `avg_daily_volume.gt` integer
- `avg_daily_volume.gte` integer
- `avg_daily_volume.lt` integer
- `avg_daily_volume.lte` integer
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `avg_daily_volume` integer, required — The average daily trading volume for the stock over a specified period, typically used to contextualize short interest.
    - `days_to_cover` number, double, required — Calculated as short_interest divided by avg_daily_volume, representing the estimated number of days it would take to cover all short positions based on average trading volume.
    - `settlement_date` string, required — The date (formatted as YYYY-MM-DD) on which the short interest data is considered settled, typically based on exchange reporting schedules.
    - `short_interest` integer — The total number of shares that have been sold short but have not yet been covered or closed out.
    - `ticker` string — The primary ticker symbol for the stock.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)
