批量撤单
限速规则 5次/1s (UID)
描述
批量撤单
HTTP请求
- POST /api/v2/spot/trade/batch-cancel-order
请求示例
curl -X POST "https://api.bitget.com/api/v2/spot/trade/batch-cancel-order" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
-d '{
"symbol": "",
"batchMode":"multiple",
"orderList": [
{
"orderId":"121211212122",
"symbol":"BTCUSDT",
"clientOid":"121211212122"
}
]
}'
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
symbol | String | 否 | 交易对名称,如BTCUSDT |
batchMode | String | 否 | 批量下单模式single 单币种模式, 默认单币种模式multiple 跨币种模式. 如选择单币种模式,则orderlist中的symbol不生效 如选择跨币种模式,则orderlist中的symbol生效,且orderlist中的symbol必填。orderlist外的symbol不生效 |
orderList | Array | 是 | 订单id数组,最大长度:50 |
>symbol | String | 否 | 交易对名称,如BTCUSDT |
>orderId | String | 否 | orderId,与clientOid必填一个 |
>clientOid | String | 否 | clientOid,与orderId必填一个 |
返回示例
{
"code": "00000",
"message": "success",
"requestTime": 1695808949356,
"data": {
"successList": [
{
"orderId": "121211212122",
"clientOid": "121211212122"
}
],
"failureList": [
{
"orderId": "121211212122",
"clientOid": "xxx001",
"errorMsg": "duplicate clientOrderId"
}
]
}
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
successList | Array | 成功订单数组 |
>orderId | String | 订单ID |
>clientOid | String | 客户端订单ID |
failureList | Array | 失败订单数组 |
>orderId | String | 订单ID |
>clientOid | String | 客户端订单ID |
>errorMsg | String | 错误信息 |
>errorCode | String | 错误码 |