Batch Cancel Orders

Cancel multiple futures orders in a single request.

HTTP Request

POST /api/v1/future/order/batch-cancel-orders

Request Parameters

Parameter	Type	Required	Description
orderIdList	array	Yes	Array of orders to cancel

Order ID List Item Parameters

Parameter	Type	Required	Description
orderId	string	No	Order ID
clientOid	string	No	Client order ID

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/batch-cancel-orders" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "orderIdList": [
      {
        "orderId": "fu-123456789"
      },
      {
        "clientOid": "my-order-002"
      }
    ]
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Batch cancel result
> successList	array	Array of successfully canceled orders
>> orderId	string	Order ID
>> clientOid	string	Client order ID
> failureList	array	Array of failed cancellations
>> orderId	string	Order ID (empty if failed)
>> clientOid	string	Client order ID
>> errorMsg	string	Error message
>> errorCode	string	Error code

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "successList": [
      {
        "orderId": "fu-123456789",
        "clientOid": ""
      }
    ],
    "failureList": [
      {
        "orderId": "",
        "clientOid": "my-order-002",
        "errorMsg": "Order not found",
        "errorCode": "40001"
      }
    ]
  }
}

Error Codes

Code	Message
40001	Order not found (in failureList)