BIbinance
Trade

Cancel Order (TRADE)

Changed on

Cancel an active order.

Either orderId or origClientOrderId must be sent.

Weight(IP): 1

delete/api/v3/order

Request

  • Base URL
    https://api.binance.com
  • URL
    https://api.binance.com/api/v3/order
  • Auth
    API key in header X-MBX-APIKEY

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

  • 6622e0c15100Revision changes
    • info

      added the new optional query request parameter cancelRestrictions

    • info

      added the required property to the response with the status

  • 042dad2ebffeRevision changes
    • info

      added the required property to the response with the status