获取历史策略子订单
获取历史策略子订单
描述
查询策略生成的终态历史子订单
HTTP请求
- GET /api/v3/trade/strategy-sub-orders
- 限频规则: 10次/秒/UID
- 需要统一账户交易只读/读写权限
请求示例
curl "https://api.bitget.com/api/v3/trade/strategy-sub-orders?orderId=1234567890123456789" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json"
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| orderId | String | 是 | 策略订单ID |
| limit | String | 否 | 每页条目数 最大 100,默认100 |
| cursor | String | 否 | 分页游标 用于翻页,首次查询不传,查询第二页及后面的数据时,取上一次查询返回的最小orderId,结果会返回小于该值的数据 |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1724486400000,
"data": {
"list": [
{
"subOrderId": "1234567890123456789",
"subClientOid": "myOrder001",
"category": "USDT-FUTURES",
"symbol": "BTCUSDT",
"price": "60000",
"qty": "0.01",
"cumExecQty": "0.01",
"avgPrice": "60001",
"side": "buy",
"posSide": "long",
"status": "filled",
"createdTime": "1724486400000",
"updatedTime": "1724486401000"
}
],
"cursor": 1234567890123456788
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| list | Array | 子订单列表 |
| >subOrderId | String | 子订单ID |
| >subClientOid | String | 自定义订单ID |
| >category | String | 业务线SPOT 现货交易MARGIN 杠杆交易USDT-FUTURES U本位合约COIN-FUTURES 币本位合约USDC-FUTURES USDC合约 |
| >symbol | String | 交易对名称 |
| >price | String | 委托价格 |
| >qty | String | 委托数量 单位为base coin |
| >cumExecQty | String | 累计成交数量 单位为base coin |
| >avgPrice | String | 平均成交价 |
| >side | String | 开单方向buy 买sell 卖 |
| >posSide | String | 仓位方向long 多short 空只适用合约订单 |
| >status | String | 订单状态filled 已成交cancelled 已撤销failed 失败 |
| >createdTime | String | 订单创建时间 Unix毫秒时间戳 |
| >updatedTime | String | 订单更新时间 Unix毫秒时间戳 |
| cursor | Number | 下一页游标 把该值作为下次请求的 cursor参数,可获取下一页数据 |