Trade

Cancel OCO (TRADE)

Cancel an entire Order List

Canceling an individual leg will cancel the entire OCO

Weight(IP): 1

delete/api/v3/orderList

Query parameters

symbolstring required

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

orderListIdinteger

Order list id

listClientOrderIdstring

A unique Id for the entire orderList

newClientOrderIdstring

Used to uniquely identify this cancel. Automatically generated by default

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Report on deleted OCO

orderListIdinteger required

contingencyTypestring required

listStatusTypestring required

listOrderStatusstring required

listClientOrderIdstring required

transactionTimeinteger required

symbolstring required

Example response

{
  "orderListId": 1929,
  "contingencyType": "OCO",
  "listStatusType": "ALL_DONE",
  "listOrderStatus": "ALL_DONE",
  "listClientOrderId": "C3wyj4WVEktd7u9aVBRXcN",
  "transactionTime": 1574040868128,
  "symbol": "BNBBTC",
  "orders": [
    {
      "symbol": "BNBBTC",
      "orderId": 2,
      "clientOrderId": "pO9ufTiFGg3nw2fOdgeOXa"
    },
    {
      "symbol": "BNBBTC",
      "orderId": 3,
      "clientOrderId": "TXOvglzXuaubXAaENpaRCB"
    }
  ],
  "orderReports": [
    {
      "symbol": "BNBBTC",
      "origClientOrderId": "pO9ufTiFGg3nw2fOdgeOXa",
      "orderId": 2,
      "orderListId": 0,
      "clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
      "price": "1.00000000",
      "origQty": "10.00000000",
      "executedQty": "0.00000000",
      "cummulativeQuoteQty": "0.00000000",
      "status": "CANCELED",
      "timeInForce": "GTC",
      "type": "STOP_LOSS_LIMIT",
      "side": "SELL",
      "stopPrice": "1.00000000",
      "transactTime": 1688005070874
    },
    {
      "symbol": "BNBBTC",
      "origClientOrderId": "TXOvglzXuaubXAaENpaRCB",
      "orderId": 3,
      "orderListId": 0,
      "clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
      "price": "3.00000000",
      "origQty": "10.00000000",
      "executedQty": "0.00000000",
      "cummulativeQuoteQty": "0.00000000",
      "status": "CANCELED",
      "timeInForce": "GTC",
      "type": "LIMIT_MAKER",
      "side": "SELL",
      "selfTradePreventionMode": "NONE",
      "transactTime": 1688005070874
    }
  ]
}

Changes

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

Sep 2, 20236622e0c151001See the full diff
- ○
  added the required property orderReports/items/transactTime to the response with the 200 status
  response-required-property-added
Apr 26, 2023042dad2ebffe1See the full diff
- ○
  added the required property orderReports/items/selfTradePreventionMode to the response with the 200 status
  response-required-property-added
Oct 25, 2021a484ce871a72330See the full diff
- ▲
  for the query request parameter orderListId, 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 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 contingencyType became required for the status 200
  response-property-became-required
- ○
  the response property listClientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property listOrderStatus became required for the status 200
  response-property-became-required
- ○
  the response property listStatusType 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 orderListId became required for the status 200
  response-property-became-required
- ○
  the response property orderReports became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/clientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/cummulativeQuoteQty became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/executedQty became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/orderId became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/orderListId became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/origClientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/origQty became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/price became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/side became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/status became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/stopPrice became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/symbol became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/timeInForce became required for the status 200
  response-property-became-required
- ○
  the response property orderReports/items/type became required for the status 200
  response-property-became-required
- ○
  the response property orders became required for the status 200
  response-property-became-required
- ○
  the response property orders/items/clientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property orders/items/orderId became required for the status 200
  response-property-became-required
- ○
  the response property orders/items/symbol 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 transactionTime became required for the status 200
  response-property-became-required

Full history