Fundamental
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=. |
Longbridge HK / SG accounts only
This method is available to Longbridge HK / SG accounts only. It works with any supported symbol, including US stocks.
View broker holding positions for HK-listed stocks, including top buyers/sellers and full detail.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `700.HK`. |
type | string | Required | Statistics period: `rct_1` (1 day), `rct_5` (5 days), `rct_20` (20 days), `rct_60` (60 days). |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
buy | object[] | Optional | Top buying brokers |
└ name | string | Optional | Broker name |
└ parti_number | string | Optional | Broker participant number |
└ chg | string | Optional | Position change |
└ strong | boolean | Optional | Whether marked as strong holder |
sell | object[] | Optional | Top selling brokers |
└ name | string | Optional | Broker name |
└ parti_number | string | Optional | Broker participant number |
└ chg | string | Optional | Position change |
└ strong | boolean | Optional | Whether marked as strong holder |
updated_at | string | Optional | Last update timestamp |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"buy": [
{
"parti_number": "B01224",
"name": "HSBC",
"chg": "5000000",
"strong": true
}
],
"sell": [
{
"parti_number": "B01274",
"name": "Goldman Sachs HK",
"chg": "-3000000",
"strong": false
}
],
"updated_at": "2026.05.13"
}
}Error code
See the Error Codes page for the full list of error codes.