Cancel Order by orderId

Request via this endpoint to cancel a single order previously placed.

TIP

This interface is only for cancellation requests. The cancellation result needs to be obtained by querying the order status or subscribing to websocket. It is recommended that you DO NOT cancel the order until receiving the Open message, otherwise the order cannot be cancelled successfully.

HTTP REQUEST

DELETE /api/v1/orders/{orderId}

Example

DELETE /api/v1/orders/5bd6e9286d99522a52e458de

{
  "cancelledOrderIds": ["5bd6e9286d99522a52e458de"]
}

API KEY PERMISSIONS

This endpoint requires the Spot Trading or Margin Trading permission.

REQUEST URL

This endpoint support Spot URL

REQUEST RATE LIMIT

Spot weight：3

PARAMETERS

Param	Type	Mandatory	Description
orderId	String	Yes	Order ID, unique ID of the order.

RESPONSES

Param	Description
cancelledOrderIds	Unique ID of the cancelled order

TIP

The order ID is the server-assigned order id and not the passed clientOid.

CANCEL REJECT

If the order could not be canceled (already filled or previously canceled, etc), then an error response will indicate the reason in the message field.