交易
鉴权
签名方式:每个请求用 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,例如:`701276261045858304` |
start_at | string | 可选 | 开始时间,格式为时间戳 (秒),例如:`1650410999`。. 开始时间为空时,默认为结束时间或当前时间前九十天。 |
end_at | string | 可选 | 结束时间,格式为时间戳 (秒),例如:`1650410999`。. 结束时间为空时,默认为开始时间后九十天或当前时间。 |
page | integer | 可选 | 页码,从 `1` 开始。单次查询最多返回 1000 条记录,若结果超过 1000 条,`has_more` 为 `true`,可结合 `has_more` 翻页。 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
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": {
"has_more": false,
"trades": [
{
"order_id": "693664675163312128",
"price": "388",
"quantity": "100",
"symbol": "700.HK",
"trade_done_at": "1648611351",
"trade_id": "693664675163312128-1648611351433741210",
"side": "Buy"
}
]
}
}错误码
参见错误码文档。