Cancel Futures Order

Cancels an open futures order and releases its margin. Returns the updated order with status: "CANCELED", and no fills.

Permission: FUTURES_TRADE | Success: 200 OK

Cancelling is not closing. This removes an order that has not filled. If the order already filled, you hold a position, and cancelling does nothing. To get out of a position, send an opposing reduceOnly order instead.

Errors

Status	`code`	Cause
`400`	`VALIDATION_ERROR`	"order is already FILLED and cannot be canceled", or a missing `Idempotency-Key`
`404`	`NOT_FOUND`	Unknown order, or one that is not yours
`500`	`INTERNAL`	See the warning below

Known issue: a venue-side cancel failure surfaces as a generic 500
On futures, a failed cancel at the venue currently returns 500 INTERNAL rather than a typed error. The order is queued for background resolution, so your state is safe, but do not treat every 500 here as a transport fault. Re-read the order before retrying anything.
This is futures only. Spot's DELETE /v1/orders/{id} already answers 409 CANCEL_REJECTED_BY_VENUE and 503 VENUE_UNAVAILABLE for the same conditions.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "id": "clw8n2k4x0009abcdefghij",
  "userId": "clw8n1a2b0000abcdefghij",
  "clientOrderId": "prod_8n1a2b0000ab_4c7e91a2",
  "venueOrderId": "9876543210",
  "symbol": "BTC-USDT",
  "positionSide": "LONG",
  "side": "BUY",
  "orderType": "LIMIT",
  "timeInForce": "GTC",
  "price": "60000",
  "quantity": "0.01",
  "filledQty": "0",
  "avgPrice": null,
  "leverage": 10,
  "marginMode": "ISOLATED",
  "reservedAmount": "0",
  "reservedAsset": "USDT",
  "status": "CANCELED",
  "reduceOnly": false,
  "submittedAt": "2026-08-18T09:20:43.100Z",
  "terminalAt": "2026-08-18T09:40:00.000Z",
  "createdAt": "2026-08-18T09:20:43.000Z",
  "updatedAt": "2026-08-18T09:40:00.000Z"
}

Errors#

Known issue: a venue-side cancel failure surfaces as a generic 500#

Request

Request Code Samples

Responses

Errors

Known issue: a venue-side cancel failure surfaces as a generic `500`