批量撤单

普通用户10次/S 根据uid限频

描述

撤单接口，可按产品类型、交易对名称进行撤单。

HTTP请求

• POST /api/v2/mix/order/batch-cancel-orders

请求示例

curl -X POST "https://api.bitget.com/api/v2/mix/order/batch-cancel-orders" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "productType": "usdt-futures",
    "marginCoin": "USDT",
    "orderIdList": [
        {
            "orderId":"121211212122"
        }
    ]
}'

请求参数

参数名	参数类型	是否必须	描述
orderIdList	List	否	订单id集合。最大长度：50 若传递，symbol不可为空，且需与symbol/productType对齐
>orderId	String	否	订单id orderId和clientOid必须两者传一个，同传时以orderId为准。
>clientOid	String	否	自定义订单id orderId和clientOid必须两者传一个，同传时以orderId为准。
symbol	String	否	交易对 如:ethusdt 当传入orderIdList参数时，此参数为必传
productType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
marginCoin	String	否	保证金币种 必须大写

返回示例

{
    "code": "00000",
    "data": {
        "successList": [
            {
                "orderId": "121211212122",
                "clientOid": "BITGET#121211212122"
            }
        ],
        "failureList": [
            {
                "orderId": "232",
                "clientOid": "321342",
                "errorMsg": "notExistend"
            }
        ]
    },
    "msg": "success",
    "requestTime": 1627293504612
}

返回参数

返回字段	参数类型	字段说明
successList	List<Object>	所撤成功单集合。
>orderId	String	订单id
>clientOid	String	自定义订单id
failureList	List<Object>	所撤失败单集合。
>orderId	String	订单id
>clientOid	String	自定义订单id
>errorMsg	String	失败原因
>errorCode	String	错误码