Sign in

v1

latestOpenAPI 3.0.32026-07-246185298.2 KB
Short Interest

Delayed Reported Short Interest

Retrieve Official short interest data for US, Canada, Australia and Hong Kong for a given stock ticker. Short interest is the count of shares sold short that remain open (not yet bought back), offering a window into positioning and crowd sentiment. Elevated short interest can reflect bearish conviction and, in some cases, set the stage for short-squeeze dynamics.

Use Cases: Market sentiment analysis, short-squeeze monitoring, risk management, trading strategy tuning.

Available Data Points:

  • Short Interest: Total shares reported as short.
  • Days to Cover: Computed as short_interest ÷ avg_daily_volume, estimating how many trading days are needed for shorts to cover. For display and risk flags, values below 1 are rounded up to 1.
  • Avg Daily Volume: The stock’s average daily trading volume over a defined lookback, used to normalize short interest.
  • Settlement Date: The official reporting/settlement date tied to the exchange calendar for this short interest snapshot.

Coverage:

This API currently provides officially filed short interest statistics for the following countries (country code):

  • United States (US)
  • Australia (AU)
  • Canada (CA)
  • Hong Kong (HK)
get/api/v1/stock/official_short_interest

Query parameters

country_codestring required

2 character ISO country code: US, CA, AU, HK

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

settlement_from_datestring required

Starting settlement date for short interest data (YYYY-MM-DD)

settlement_to_datestring

Ending settlement date for short interest data (YYYY-MM-DD). If no input, will default to settlement_from_date

tickerstring required

Ticker symbol of company to retrieve short interest for (e.g. "AAPL")

Response

paginationLinksobject
lengthinteger required

Example response

{
  "paginationLinks": {
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2"
  },
  "length": 123
}