Quote
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-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.
longbridge short-positions TSLA.US
longbridge short-positions 700.HK
longbridge short-positions AAPL.US --count 50
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `TSLA.US` or `700.HK` |
count | integer | Optional | Number of records to return (1–100, default: 20) |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Optional | Security symbol, e.g. `AAPL.US`. |
data | object[] | Optional | Bi-monthly FINRA short-interest records. |
└ timestamp | string | Optional | Settlement date (Unix seconds). |
└ rate | string | Optional | Short interest as a fraction of float. |
└ avg_daily_share_volume | string | Optional | Average daily share volume. |
└ current_shares_short | string | Optional | Current shares sold short. |
└ days_to_cover | string | Optional | Days to cover (short interest / avg volume). |
└ close | string | Optional | Closing price. |
sources | integer | Optional | Number 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.