Cancel Order Multi

Cancel the specified order list

The Cancel Order Multi command allows sending of multiple order cancellation operations at the same time. To do this, construct a payload with the "oc_multi" (order cancel multi) abbreviation. The payload needs to include an object that specifies which orders to cancel based on Internal Order ID's, Client Order ID's (along with the cid_DATE in a YYYY-MM-DD format), Group ID, or the "all" request field. Please look to the sidebar for examples of each method.

You will receive messages to confirm your cancellation requests through "n" (notification) events and, if successful, confirmation through "oc" (order cancelled) events. Please look to the Orders and Notifications pages for further information on the responses you receive.

Order inputs require you to run the authentication code along with additional code for the input. The authentication code can be found on our Authenticated Channels and the additional code for inputs can be found on the Websocket Inputs page.

// Cancel all orders
[
  0,
  "oc_multi",
  null,
  {
    "all": 1
  }
]

// Cancel multiple orders by Internal Order ID
[
  0,
  "oc_multi",
  null,
  {
    "id": [ID, 1234, ...]
  }
]

// Cancel multiple orders using Client Order ID and order creation date
[
  0,
  "oc_multi",
  null,
  {
    "cid": [
      [ID, CID_DATE],
      [234, "2016-12-05"],
      ...
    ]
  }
]

// Cancel multiple orders using Group ID
[
  0,
  "oc_multi",
  null,
  {
     "gid": [GID, 11, ...]
  }
]

Request Fields

NameTypeDescription
idint64Internal Order ID
cidint45Client Order ID
cid_datestringClient Order ID Date
gidint32Group Order ID

❗️

Cancel All Orders

Please note that using {"all" : 1} to cancel all orders will cancel all trading as well as all derivatives orders. Order IDs can be passed instead to cancel only selected orders.