帳戶
鑑權
簽名方式:每個請求用 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 | 必填 | 證券代碼,例如 `AAPL.US` |
start | string | 可選 | 開始日期,格式 `YYYY-MM-DD` |
end | string | 可選 | 結束日期,格式 `YYYY-MM-DD` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
profit | string | 可選 | 總盈虧 |
underlying_details | object | 可選 | 正股盈虧明細 |
└ holding_value | string | 可選 | 當前持倉市值 |
└ profit | string | 可選 | 總盈虧 |
└ cumulative_credited_amount | string | 可選 | 累計入賬金額 |
└ credited_details | array | 可選 | 入賬明細 |
└ cumulative_debited_amount | string | 可選 | 累計出賬金額 |
└ debited_details | array | 可選 | 出賬明細 |
└ cumulative_fee_amount | string | 可選 | 累計費用金額 |
└ fee_details | array | 可選 | 費用明細 |
└ short_holding_value | string | 可選 | 空頭持倉市值 |
└ long_holding_value | string | 可選 | 多頭持倉市值 |
└ holding_value_at_beginning | string | 可選 | 期初持倉市值 |
└ holding_value_at_ending | string | 可選 | 期末持倉市值 |
derivative_pnl_details | object | 可選 | 衍生品盈虧明細 |
└ holding_value | string | 可選 | 當前持倉市值 |
└ profit | string | 可選 | 總盈虧 |
└ cumulative_credited_amount | string | 可選 | 累計入賬金額 |
└ credited_details | array | 可選 | 入賬明細 |
└ cumulative_debited_amount | string | 可選 | 累計出賬金額 |
└ debited_details | array | 可選 | 出賬明細 |
└ cumulative_fee_amount | string | 可選 | 累計費用金額 |
└ fee_details | array | 可選 | 費用明細 |
└ short_holding_value | string | 可選 | 空頭持倉市值 |
└ long_holding_value | string | 可選 | 多頭持倉市值 |
└ holding_value_at_beginning | string | 可選 | 期初持倉市值 |
└ holding_value_at_ending | string | 可選 | 期末持倉市值 |
name | string | 可選 | 標的名稱。 |
updated_at | string | 可選 | 最後更新時間 |
default_tag | integer | 可選 | 默認顯示標簽 |
currency | string | 可選 | 貨幣 |
start | string | 可選 | 統計期開始 |
end | string | 可選 | 統計期結束 |
start_date | string | 可選 | 開始日期 |
end_date | string | 可選 | 結束日期 |
updated_date | string | 可選 | 最後更新日期 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"name": "Apple",
"currency": "USD",
"profit": "100.00",
"start": "1763769600",
"end": "1778724973",
"start_date": "2025-11-22",
"end_date": "2026-05-14",
"default_tag": 0,
"updated_at": "1778724973",
"updated_date": "2026-05-14",
"underlying_details": {
"profit": "100.00",
"holding_value": "1790.16",
"holding_value_at_beginning": null,
"holding_value_at_ending": "1790.16",
"long_holding_value": "1790.16",
"short_holding_value": "0.00",
"cumulative_credited_amount": "0.00",
"cumulative_debited_amount": "0.00",
"cumulative_fee_amount": "0.00",
"credited_details": [],
"debited_details": [],
"fee_details": []
},
"derivative_pnl_details": {
"profit": "0.00",
"holding_value": "0.00",
"holding_value_at_beginning": null,
"holding_value_at_ending": "0.00",
"long_holding_value": "0.00",
"short_holding_value": "0.00",
"cumulative_credited_amount": "0.00",
"cumulative_debited_amount": "0.00",
"cumulative_fee_amount": "0.00",
"credited_details": [],
"debited_details": [],
"fee_details": []
}
}
}錯誤碼
參見錯誤碼文檔。