基本面
鑑權
簽名方式:每個請求用 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=。 |
獲取指定證券的成交統計數據,展示成交量的價格分佈。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `700.HK` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
trades | object[] | 可選 | 按價位的成交分佈, |
└ price | string | 可選 | 價位 |
└ buy_amount | string | 可選 | 該價位買入成交額 |
└ sell_amount | string | 可選 | 該價位賣出成交額 |
└ neutral_amount | string | 可選 | 該價位中性成交額 |
statistics | object | 可選 | 成交統計匯總 |
└ avgprice | string | 可選 | 平均價。 |
└ trades_count | string | 可選 | 成交筆數。 |
└ total_amount | string | 可選 | 總成交額。 |
└ buy | string | 可選 | 淨買入經紀商列表, |
└ sell | string | 可選 | 淨賣出經紀商列表, |
└ neutral | string | 可選 | 中性值/數量。 |
└ timestamp | string | 可選 | 異動時間(Unix 秒,字符串格式) |
└ preclose | string | 可選 | 前收盤價。 |
└ trade_date | array | 可選 | 下一次預計交易日期(YYYY-MM-DD) |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"statistics": {
"avgprice": "210.50",
"buy": "45000000",
"sell": "38000000",
"neutral": "12000000",
"total_amount": "95000000",
"trades_count": "125000",
"preclose": "208.20",
"timestamp": "1778198400",
"trade_date": [
"2026-05-13"
]
},
"trades": [
{
"price": "210.00",
"buy_amount": "5000000",
"sell_amount": "4000000",
"neutral_amount": "1000000"
}
]
}
}錯誤碼
參見錯誤碼文檔。