Skip to content
Short Selling

Get US Short Interest

Returns paged short interest for a US security by settlement date, including shares sold short, short interest ratio, average daily volume, days to cover, and close price. The Short interest chart and detail list on the US security detail page use it. Records return in ascending time order. The Broker App puts each earlier page before the data already loaded.

GEThttps://api.lbkrs.com/v1/quote/us_short_positions

Parameters

counter_idstringqueryRequired

Security ID in the format ST/<market>/<code>, such as ST/US/AAPL

last_timestampintegerqueryRequired

Pagination cursor as a Unix timestamp in seconds. Send the current time on the first request. To load earlier data, send the timestamp of the earliest loaded record

page_sizeintegerqueryRequired

Records per page. The Broker App sends 50

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get US Short Interest” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
dataarray<object>

Short interest records in ascending time order

Child attributes
timestampstring

Unix timestamp of the settlement date, in seconds

current_shares_shortstring

Shares sold short and not yet covered

avg_daily_share_volumestring

Average daily volume, in shares

days_to_coverstring

Days to cover: shares sold short divided by average daily volume

ratestring

Short interest ratio, as a decimal (for example, 0.1523 means 15.23%)

closestring

Close price, as a decimal string

sourcesinteger

Data source:

  • 0 - All exchanges
  • 1 - Nasdaq only
  • 2 - NYSE only
Values
0
1
2
Whale Docs