Skip to main content

Cancel Multiple Orders

Description

Cancel orders in a batch. A maximum of 10 orders can be cancelled per request.

HTTP Request

DELETE /v3/trade/batchOrders

Request Parameters

ParameterRequiredTypeDescription
symbolYesStringA trading pair, consisting of two currencies: base currency and quote currency
ordIdsNoListThe ID of the orders to be canceled
clOrdIdsNoListOrder ID as assigned by the user
tip

Either ordIds or clOrdIds must be provided, but if both are provided, ordIds will take precedence.

Response Parameters

ParameterTypeDescription
ordIdStringOrder ID
clOrdIdStringOrder ID as assigned by the user

Request Example

{
"symbol":"BTC_USDT_PERP",
"ordIds":[
"331378951169769472",
"331378951182352384",
"331378951199129601"
]
}

Response Example

{
"code":200,
"data":[
{
"clOrdId":"b93fe6bd-30eb-4d0e-8c99-0288a9156837",
"code":200,
"msg":"Success",
"ordId":"331378951169769472"
},
{
"clOrdId":"225c8607-d98f-4a2e-a27b-faea04fe718f",
"code":200,
"msg":"Success",
"ordId":"331378951182352384"
},
{
"clOrdId":"9e36e89c-6cab-45c6-9c8a-245b7547601a",
"code":200,
"msg":"Success",
"ordId":"331378951199129601"
}
],
"msg":"Success"
}