帳戶
鑑權
簽名方式:每個請求用 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 | 必填 | 證券代碼 |
page | integer | 可選 | 頁碼(預設 1) |
size | integer | 可選 | 每頁數量(預設 20) |
derivative | boolean | 可選 | 是否包含衍生品倉位 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
flows_list | object[] | 必填 | 資金流水列表(分頁), |
└ executed_date | string | 必填 | 執行日期(如 `2024-01-15`) |
└ executed_timestamp | string | 可選 | 執行時間戳 |
└ code | string | 可選 | 證券代碼 |
└ direction | string | 可選 | 方向:`In`(買入)或 `Out`(賣出) |
└ executed_quantity | string | 可選 | 成交數量 |
└ executed_price | string | 可選 | 成交價格 |
└ executed_cost | string | 可選 | 成交成本 |
└ describe | string | 可選 | 描述說明 |
has_more | boolean | 可選 | 是否有更多頁 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"has_more": false,
"flows_list": [
{
"code": "AAPL",
"symbol": "AAPL.US",
"direction": "In",
"executed_date": "2025-11-22",
"executed_timestamp": "1763769600",
"executed_quantity": "10",
"executed_price": "180.50",
"executed_cost": "1805.00",
"describe": "Buy AAPL.US"
}
]
}
}錯誤碼
參見錯誤碼文檔。