Cancel Order

Type: TRADE

DELETE /fapi/v1/order

Cancel an open order by orderId.

Request

DELETE /fapi/v1/order?symbol=BTCUSDT&orderId=<uuid>

Query params

Parameters are read from the URL query string only (the body is only part of the signed payload); a required parameter missing from the query string fails with HTTP 400 (plain-text axum rejection, not a {code, msg} JSON body).

Name	Type	Required	Notes
symbol	string	yes	standard pair (validated as known).
orderId	UUID string	yes	Order id from the placement response. Must belong to the calling key's user and be open on symbol.

Response — 200

{
  "symbol": "BTCUSDT",
  "orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
  "status": "CANCELED"
}

symbol and orderId echo the request; status is always CANCELED. The call returns only after the matching engine has removed the order and any fills emitted before the cancel have been committed.

Errors

HTTP	code	msg
400	-1100	orderId not a valid UUID, or unknown symbol.
422	-2011	Order does not exist — never placed, already fully filled or cancelled, or open under a different symbol than the one given.
401	-2015	orderId belongs to another user (ledger PermissionDenied is mapped to -2015).
500	-1000	Matching-engine cancel barrier unavailable, or other downstream failure.

Signature and API-key failures (-1021, -1022, -1102, -2014, -2015) and rate limiting (-1003, HTTP 429) apply to every signed endpoint; see Error Codes.

Cancelling by origClientOrderId (instead of orderId) is not yet supported.