查询历史成交
查询历史成交
描述
该接口用于获取历史订单的成交明细,包括买入和卖出的成交记录,不支持当日成交明细查询。
HTTP请求
- GET /api/v3/stockplus/trade/history-executions
- 限频规则: 30秒内累计不超过30次调用,且每两次调用之间间隔不小于0.02秒
- 权限: 统一账户交易只读权限
请求示例
curl "https://api.bitget.com/api/v3/stockplus/trade/history-executions?symbol=AAPL.US" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json"
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | String | 否 | 股票代码,使用 ticker.region 格式,例如:AAPL.US |
| startAt | Number | 否 | 开始时间,格式为时间戳(秒),例如:1650410999。默认取结束时间或当前时间的前90天 |
| endAt | Number | 否 | 结束时间,格式为时间戳(秒),例如:1650410999。默认取开始时间或当前时间的后90天 |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"hasMore": false,
"trades": [
{
"orderId": "701276261045858304",
"tradeId": "0f40217c-a73c-410d-b599-2ff6a9ee762e",
"symbol": "AAPL.US",
"tradeDoneAt": "2024-12-16T12:07:12Z",
"quantity": 1,
"price": 150.00
}
]
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| hasMore | Boolean | 是否存在更多数据。单次查询最大1000笔成交记录,超出时hasMore为true |
| trades | List<Object> | 成交明细信息 |
| > orderId | String | 订单 ID |
| > tradeId | String | 成交 ID |
| > symbol | String | 股票代码,使用 ticker.region 格式,例如:AAPL.US |
| > tradeDoneAt | String | 成交时间(ISO 8601) |
| > quantity | Number | 成交数量 |
| > price | Number | 成交价格 |