账户
鉴权
签名方式:每个请求用 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": []
}
}
}错误码
参见错误码文档。