Cancel Plan Order

Cancel one or more existing trigger orders (plan orders).

HTTP Request

POST /api/v1/future/order/cancel-plan-order

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
orderIdList	array	Yes	List of orders to cancel

orderIdList Item

Parameter	Type	Required	Description
orderId	string	No	Order ID (either orderId or clientOid required)
clientOid	string	No	Client order ID

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/cancel-plan-order" \
  -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 '{
    "symbol": "BTCUSDT",
    "orderIdList": [
      { "orderId": "fu-plan-123456789" },
      { "clientOid": "my-plan-order-002" }
    ]
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Batch order response data
> successList	array	List of successfully cancelled orders
> failureList	array	List of failed cancellations

successList/failureList Item

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

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "successList": [{ "orderId": "fu-plan-123456789", "clientOid": "" }],
    "failureList": []
  }
}

Error Codes

Code	Message
40001	Order not found (in failureList)