交易
鑑權
簽名方式:每個請求用 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 | 可選 | 股票代碼,使用 `ticker.region` 格式,例如:`AAPL.US` |
order_id | string | 可選 | 訂單 ID,用於指定訂單 ID 查詢,例如:`701276261045858304` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
trades | object[] | 可選 | 成交明細信息 |
└ trade_id | string | 可選 | 成交 ID |
└ order_id | string | 可選 | 訂單 ID |
└ symbol | string | 可選 | 股票代碼,使用 `ticker.region` 格式,例如:`AAPL.US` |
└ price | string | 可選 | 成交價格 |
└ quantity | string | 可選 | 成交數量 |
└ trade_done_at | string | 可選 | 成交時間,格式為時間戳 (秒) |
└ side | string | 可選 | 買賣方向。**可選值:**, `Buy` - 買入,`Sell` - 賣出 |
has_more | boolean | 可選 | 是否還有更多數據。. 每次查詢最大訂單數量為 1000,如果查詢結果數量超過 1000,那麼 has_more 就會為 true |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"trades": [
{
"order_id": "693664675163312128",
"price": "388",
"quantity": "100",
"side": "Buy",
"symbol": "700.HK",
"trade_done_at": "1648611351",
"trade_id": "693664675163312128-1648611351433741210"
}
]
}
}錯誤碼
參見錯誤碼文檔。