Trading:CancelOrder

Requests to cancel an existing Order.

Successful completion of this action does not mean your Order has been cancelled on the Market, only that the request has been acknowledged.

The Order state provided in this result is not synchronised with the Orders subscription, and can be older or newer than the most recent event.

Controller: Trading
Topic: CancelOrder
Action: Publish
Permissions: Zenith/OrderPad

Request

Name	Type	Expect	Description
Account	String	Always	The Account that owns the Order
Flags	Array	Optional	An array of string flags. See Appendix F: Order Flags for more information
OrderID	String	Always	The unique identifier of the Order to cancel
RequestID	String	Optional	A string to uniquely (within this Account) identify this request. If omitted, a random 22-character alphanumeric string will be generated by the server.

Response

Name	Type	Expect	Description
Result	String	Always	The result of the operation. One of the following values: Success – Request successful. Incomplete – Required fields are missing. Invalid – The supplied fields are invalid. Rejected – The order was rejected.
RequestID	String	Always	A string to uniquely (within this Account) identify this request.
Order	Object	Optional	If the request was successful, supplies the Order state after this request was acknowledged
Errors	Array	Optional	If the request failed, supplies an array of string codes identifying the errors encountered. See Appendix E: Order Error Codes for more information

Example

Send:

{"Controller":"Trading","Topic":"CancelOrder","TransactionID":1,"Data":{"Account":"1234[Demo]","OrderID":"00000000-0000-0000-CDEF-123456789ABC"}}

Receive:

{
  "Controller":"Trading",
  "Topic":"CancelOrder",
  "TransactionID":1,
  "Data":
  {
    "Result":"Success",
    "Order":
    {
      "ID":"00000000-0000-0000-CDEF-123456789ABC",
      ...
    },
    "EstimatedBrokerage":10.00,
    "EstimatedValue":1000.000
  }
}