Short Interest
GET
/stocks/v1/short-interest
Retrieve bi-monthly aggregated short interest data reported to FINRA by broker-dealers for a specified stock ticker. Short interest represents the total number of shares sold short but not yet covered or closed out, serving as an indicator of market sentiment and potential price movements. High short interest can signal bearish sentiment or highlight opportunities such as potential short squeezes. This endpoint provides essential insights for investors monitoring market positioning and sentiment.
Use Cases: Market sentiment analysis, short-squeeze prediction, risk management, trading strategy refinement.
Query Parameters
ticker
string
The primary ticker symbol for the stock.
days_to_cover
number
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. Value must be a floating point number.
settlement_date
string
The date (formatted as YYYY-MM-DD) on which the short interest data is considered settled, typically based on exchange reporting schedules.
avg_daily_volume
integer
The average daily trading volume for the stock over a specified period, typically used to contextualize short interest. Value must be an integer.
limit
integer
Limit the maximum number of results returned. Defaults to '10' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'asc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
avg_daily_volume
integer
The average daily trading volume for the stock over a specified period, typically used to contextualize short interest.
days_to_cover
number
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
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
optional
The total number of shares that have been sold short but have not yet been covered or closed out.
ticker
string
optional
The primary ticker symbol for the stock.
status
enum (OK)
The status of this request's response.