Modify Order Message Fields

Request to modify an order. The order attributes to be modified are selected using NumberOfModifyBitfields and some number of bitfields to follow.

Only Price, Side, OrderQty, StopPx, MaxFloor, and OrdType may be adjusted. Modifies will result in a loss of time priority unless the modification involves a decrease in OrderQty, a change to MaxFloor, a change to StopPx, or a change in Side from sell long to sell short or vice-versa.

Other fields (including ExecInst will be ignored, and the value from the original order will be reused. In particular, note that when a Day ISO is modified, the ISO designation is applied to the new order.

A change in MaxFloor takes effect on the next reserve reload. A zero value for MaxFloor will be ignored. If MaxFloor is to be removed completely, then the order should be cancelled and a new order sent.

Changes in OrderQty result in an adjustment of the current order's OrderQty. The new OrderQty does not directly replace the current order's LeavesQty. Rather, a delta is computed from the current OrderQty and the replacement OrderQty. This delta is then applied to the current LeavesQty. If the resulting LeavesQty is less than or equal to zero, the order is cancelled. This results in safer behavior when the modification request overlaps partial fills for the current order, leaving the Member in total control of the share exposure of the order.

A Modify Order message should not be issued until the Order Acknowledgment message for the previous New Order or Order Modified message for the previous Modify Order message has been received. The BOE handler will reject a new Modify Order message if it has not been accepted or it has not seen the result of the prior modification from the Matching Engine. However, Modify Order message requests that merely reduce OrderQty may be overlapped if the existing ClOrdID is reused, as long as the trading identifier has not been opted-in to daily limit trading risk controls. This is the only case where reuse of the ClOrdID is allowed.

The OrderQty and Price fields in the optional field block must be present on all Modify Order message requests. Messages sent without OrderQty or Price fields will be rejected. Price is optional for market orders.

A maximum of 1,295 Modify Order message requests may be made to a single order each trading day. Once the 1,295th modification is made, the next user-generated message on the order should be a Cancel Order message request.

Permitted input optional fields are described in Modify Order.

Table 1. Modify Order Message Fields
FieldOffsetLengthData TypeDescription
StartOfMessage02BinaryMust be 0xBA 0xBA.
MessageLength22BinaryNumber of bytes for the message, including this field but not including the two bytes for the StartOfMessage field.
MessageType41Binary0x3A
MatchingUnit51BinaryAlways 0 for inbound (Member to Cboe) messages.
SequenceNumber64BinaryThe sequence number for this message.
ClOrdID1020TextNew ClOrdID for this order.
OrigClOrdID3020Text
  • Corresponds to OrigClOrdID (41) in Cboe FIX.
  • ClOrdID of the order to replace.
  • In the case of multiple changes to a single order, this will be the ClOrdID of the most recently accepted change.
  • NumberOfModifyOrder
  • Bitfields
501BinaryBitfield identifying bitfields which are set. May be 0. Field values must be appended to the end of the message.
ModifyOrderBitfield1511BinaryBitfield identifying fields to follow.
ModifyOrderBitfieldn1BinaryLast bitfield.
Optional fields. . .
Table 2. Modify Order Message Example
Field NameHexadecimalNotes
StartOfMessageBA BAStart of message bytes
MessageLength3E 0062 bytes
MessageType3AModify Order
MatchingUnit00Always 0 for inbound messages
SequenceNumber64 00 00 00Sequence Number 100
ClOrdID41 42 43 31 32 34 00 00 00 00 00 00 00 00 00 00 00 00 00 00ABC124
OrigClOrdID41 42 43 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00 00ABC123
NumberOfModify011 bitfield to follow
OrderBitfields
ModifyOrderBitfield10COrderQty, Price
OrderQtyE0 2E 00 0012,000 shares
Price08 E2 01 00 00 00 00 00$12.34
Cboe Titanium U.S. Equities BOE Specification - Modify Order Message Fields | Cboe