基本面
鑑權
簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 請求時間戳,單位秒(Unix 時間)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
僅支援 Longbridge 香港 / 新加坡賬戶
此方法僅支援 Longbridge 香港 / 新加坡賬戶,可查詢任意標的,包括美股。
獲取港股上市證券的完整經紀商持倉詳情列表(所有經紀商及其持倉數量)。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 港股代碼,例如 `700.HK` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
list | object[] | 可選 | 經紀商持倉明細, |
└ name | string | 可選 | 標的名稱。 |
└ parti_number | string | 可選 | 經紀商參與者編號 |
└ ratio | object | 可選 | 持倉比率 |
└ ∟ value | string | 可選 | 指標值(字符串),無數據時為空。 |
└ ∟ chg_1 | string | 可選 | 近 1 日漲跌幅。 |
└ ∟ chg_5 | string | 可選 | 近 5 日漲跌幅。 |
└ ∟ chg_20 | string | 可選 | 近 20 日漲跌幅。 |
└ ∟ chg_60 | string | 可選 | 近 60 日漲跌幅。 |
└ shares | object | 可選 | 持股數量 |
└ ∟ value | string | 可選 | 指標值(字符串),無數據時為空。 |
└ ∟ chg_1 | string | 可選 | 近 1 日漲跌幅。 |
└ ∟ chg_5 | string | 可選 | 近 5 日漲跌幅。 |
└ ∟ chg_20 | string | 可選 | 近 20 日漲跌幅。 |
└ ∟ chg_60 | string | 可選 | 近 60 日漲跌幅。 |
└ strong | boolean | 可選 | 是否為主要持倉者 |
updated_at | string | 可選 | 最後更新日期 |
響應 JSON 示例
{
"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"
}
}
]
}
}錯誤碼
參見錯誤碼文檔。