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.
Get full broker holding detail list for an HK-listed security (all brokers and their positions).
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | HK security symbol, e.g. `700.HK` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
list | object[] | Optional | Broker holding detail records |
└ name | string | Optional | Security name. |
└ parti_number | string | Optional | Broker participant number |
└ ratio | object | Optional | Holding ratio |
└ ∟ value | string | Optional | Indicator value as a string; empty when unavailable. |
└ ∟ chg_1 | string | Optional | 1-day change ratio. |
└ ∟ chg_5 | string | Optional | 5-day change ratio. |
└ ∟ chg_20 | string | Optional | 20-day change ratio. |
└ ∟ chg_60 | string | Optional | 60-day change ratio. |
└ shares | object | Optional | Holding share counts |
└ ∟ value | string | Optional | Indicator value as a string; empty when unavailable. |
└ ∟ chg_1 | string | Optional | 1-day change ratio. |
└ ∟ chg_5 | string | Optional | 5-day change ratio. |
└ ∟ chg_20 | string | Optional | 20-day change ratio. |
└ ∟ chg_60 | string | Optional | 60-day change ratio. |
└ strong | boolean | Optional | Whether marked as strong holder |
updated_at | string | Optional | Last update date |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"updated_at": "2026.05.13",
"list": [
{
"parti_number": "B01224",
"name": "HSBC Securities",
"strong": false,
"shares": {
"value": "25100",
"chg_1": "4000.0000",
"chg_5": "6100.0000",
"chg_20": "12600.0000",
"chg_60": "8800.0000"
},
"ratio": {
"value": "0.0025",
"chg_1": "0.0004",
"chg_5": "0.0006",
"chg_20": "0.0012",
"chg_60": "0.0009"
}
}
]
}
}Error code
See the Error Codes page for the full list of error codes.