Batch cancel Orders

//Request
{
    "orderIdsList":
    [
        "80465574458560512",
        "80465575289094144"
    ],
    "clientOidsList":
    [
        {
            "symbol": "XBTUSDTM",
            "clientOid": "clientOid123"
        },
        {
            "symbol": "ETHUSDTM",
            "clientOid": "clientOid321"
        }
    ]
}

//Response
{
    "code": "200000",
    "data":
    [
        {
            "orderId": "80465574458560512",
            "clientOid": null,
            "code": "200",
            "msg": "success"
        },
        {
            "orderId": "80465575289094144",
            "clientOid": null,
            "code": "200",
            "msg": "success"
        }
    ]
}

Using this endpoint, orders can be canceled in batches.

Supports batch cancellation of orders by orderId or clientOid. When orderIdsList and clientOidsList are used at the same time, orderIdsList shall prevail. A maximum of 10 orders can be canceled at a time.

When using orderId to cancel order, the response will return the orderId.

When using clientOid to cancel order, the response will return the clientOid.

HTTP REQUEST

DELETE /api/v1/orders/multi-cancel

Example

DELETE /api/v1/orders/multi-cancel

API KEY PERMISSIONS

This endpoint requires the Futures Trading permission.

REQUEST URL

This endpoint support Futures URL

REQUEST RATE LIMIT

Futures weight：20

PARAMETERS

Param	Type	Mandatory	Description
symbol	String	No	symbol, this parameter is required when using clientOidsList to cancel orders.
orderIdsList	String	No	Choose one of orderIdsList and clientOidsList
clientOidsList	String	No	Choose one of orderIdsList and clientOidsList

RESPONSES

Param	Description
orderId	order ID of the cancelled order
clientOid	Client ID of the cancelled order