Batch Cancel Orders

DELETE

https://api-futures.kucoin.com/api/v1/orders/multi-cancel

api-channel:Private

api-permission:Futures

api-rate-limit-pool:Futures

sdk-service:Futures

sdk-sub-service:Order

sdk-method-name:batchCancelOrders

api-rate-limit-weight:20

Description

Using this endpoint, orders can be canceled in batches

Response Format:

If canceling by orderIdsList, the response returns the affected orderId.

If canceling by clientOidsList, the response returns the affected clientOid.

Notes

Precedence: If both orderIdsList and clientOidsList are provided, the system processes orderIdsList and ignores clientOidsList.

Limit: A maximum of 10 orders can be canceled per request, whether using orderIdsList or clientOidsList.

Normal vs. Conditional Orders: When canceling by clientOidsList, if a clientOid is shared between a normal order and a conditional order (e.g., stop order), only the normal order is canceled, and the conditional order is retained. It is not recommended to use the same clientOid for multiple orders to avoid ambiguity.

Request

Body Params application/json

Example

{
    "orderIdsList":
    [
        "250445104152670209",
        "250445181751463936"
    ]
}


//{
//    "clientOidsList":
//    [
//        {
//            "symbol": "XRPUSDTM",
//            "clientOid": "5c52e11203aa1677f133e493fb"
//        },
//        {
//            "symbol": "ETHUSDTM",
//            "clientOid": "5c52214e112"
//        }
//    ]
//}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://api-futures.kucoin.com/api/v1/orders/multi-cancel' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderIdsList":
    [
        "250445104152670209",
        "250445181751463936"
    ]
}


//{
//    "clientOidsList":
//    [
//        {
//            "symbol": "XRPUSDTM",
//            "clientOid": "5c52e11203aa1677f133e493fb"
//        },
//        {
//            "symbol": "ETHUSDTM",
//            "clientOid": "5c52214e112"
//        }
//    ]
//}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": [
        {
            "orderId": "250445104152670209",
            "clientOid": null,
            "code": "200",
            "msg": "success"
        },
        {
            "orderId": "250445181751463936",
            "clientOid": null,
            "code": "200",
            "msg": "success"
        }
    ]
}

//{
//    "code": "200000",
//    "data": [
//        {
//            "orderId": null,
//            "clientOid": "5c52e11203aa1677f133e493fb",
//            "code": "200",
//            "msg": "success"
//       },
//        {
//            "orderId": null,
//            "clientOid": "5c52214e112",
//            "code": "200",
//            "msg": "success"
//        }
//    ]
//}

Modified at 2025-11-12 07:54:53

Cancel Order By ClientOid

Cancel All Orders