Trade

Cancel Order (TRADE)

Cancel an active order.

Either orderId or origClientOrderId must be sent.

Weight(IP): 1

delete/api/v3/order

Query parameters

symbolstring required

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

orderIdinteger

Order id

origClientOrderIdstring

Order id from client

newClientOrderIdstring

Used to uniquely identify this cancel. Automatically generated by default

cancelRestrictions'ONLY_NEW' | 'ONLY_PARTIALLY_FILLED'

Example:ONLY_NEW

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Cancelled order

symbolstring required

origClientOrderIdstring required

orderIdinteger required

orderListIdinteger required

Unless OCO, value will be -1

clientOrderIdstring required

transactTimeinteger required

pricestring required

origQtystring required

executedQtystring required

cummulativeQuoteQtystring required

statusstring required

timeInForcestring required

typestring required

sidestring required

selfTradePreventionModestring required

Example response

{
  "symbol": "BNBBTC",
  "origClientOrderId": "msXkySR3u5uYwpvRMFsi3u",
  "orderId": 28,
  "orderListId": -1,
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
  "transactTime": 1507725176595,
  "price": "1.00000000",
  "origQty": "10.00000000",
  "executedQty": "10.00000000",
  "cummulativeQuoteQty": "10.00000000",
  "status": "FILLED",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "SELL",
  "selfTradePreventionMode": "NONE"
}

Changes

Changed in 3 of the 26 revisions of this API.720

Sep 2, 20236622e0c151002See the full diff
- ○
  added the new optional query request parameter cancelRestrictions
  new-optional-request-parameter
- ○
  added the required property transactTime to the response with the 200 status
  response-required-property-added
Apr 26, 2023042dad2ebffe1See the full diff
- ○
  added the required property selfTradePreventionMode to the response with the 200 status
  response-required-property-added
Oct 25, 2021a484ce871a72717See the full diff
- ▲
  for the query request parameter orderId, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  the cummulativeQuoteQty response's property type/format changed from number/float to string/ for status 200
  response-property-type-changed
- ▲
  the executedQty response's property type/format changed from number/float to string/ for status 200
  response-property-type-changed
- ▲
  the origQty response's property type/format changed from number/float to string/ for status 200
  response-property-type-changed
- ▲
  the price response's property type/format changed from number/float to string/ for status 200
  response-property-type-changed
- ○
  the response property clientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property cummulativeQuoteQty became required for the status 200
  response-property-became-required
- ○
  the response property executedQty became required for the status 200
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property orderId became required for the status 200
  response-property-became-required
- ○
  the response property orderListId became required for the status 200
  response-property-became-required
- ○
  the response property origClientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property origQty became required for the status 200
  response-property-became-required
- ○
  the response property price became required for the status 200
  response-property-became-required
- ○
  the response property side became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required
- ○
  the response property symbol became required for the status 200
  response-property-became-required
- ○
  the response property timeInForce became required for the status 200
  response-property-became-required
- ○
  the response property type became required for the status 200
  response-property-became-required

Full history