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 daily holding history for a specific broker in an HK-listed security.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `700.HK`. |
parti_number | string | Required | Broker (participant) number. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
list | object[] | Required | Daily holding history records |
└ date | string | Required | Date (e.g. `2026.05.13`) |
└ holding | string | Optional | Total shares held |
└ chg | string | Optional | Daily change in shares |
└ ratio | string | Optional | Holding ratio |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"date": "2026.05.13",
"holding": "22903430",
"chg": "7029132.0000",
"ratio": "0.0025"
},
{
"date": "2026.05.12",
"holding": "15874298",
"chg": "-2150000.0000",
"ratio": "0.0017"
}
]
}
}Error code
See the Error Codes page for the full list of error codes.