Quote

Short Positions (US)

GEThttps://openapi.longbridge.com/v1/quote/short-positions/us

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

Get short interest data for US securities from FINRA, updated bi-monthly.

>_ CLI
longbridge short-positions TSLA.US
longbridge short-positions 700.HK
longbridge short-positions AAPL.US --count 50

Request

Query parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity symbol, e.g. `TSLA.US` or `700.HK`
countintegerOptionalNumber of records to return (1–100, default: 20)

Response

Response properties

NameTypeRequiredDescription
symbolstringOptionalSecurity symbol, e.g. `AAPL.US`.
dataobject[]OptionalBi-monthly FINRA short-interest records.
└ timestampstringOptionalSettlement date (Unix seconds).
└ ratestringOptionalShort interest as a fraction of float.
└ avg_daily_share_volumestringOptionalAverage daily share volume.
└ current_shares_shortstringOptionalCurrent shares sold short.
└ days_to_coverstringOptionalDays to cover (short interest / avg volume).
└ closestringOptionalClosing price.
sourcesintegerOptionalNumber of contributing data sources.

Response JSON example

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "timestamp": "2022-03-15T04:00:00Z",
      "current_shares_short": "111286790",
      "avg_daily_share_volume": "95077016",
      "days_to_cover": "1.17",
      "rate": "0.0068",
      "close": ""
    }
  ]
}

Error code

See the Error Codes page for the full list of error codes.