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. Price, OrderQty, OrdType, MaxFloor (C1 and C2 only), and StopPx may be adjusted. OrdType may be adjusted from Limit to Market (market and stop/stop limit orders are not supported during GTH or Curb sessions).

  • Time priority will be maintained on an order modification in the following cases:
    • A decrease in OrderQty with no other changes
    • An update to StopPx on an unelected stop order with no other changes
    • An update to MaxFloor with no other changes
  • An order modification combining two or more of the specific items above will not lose priority.
  • An order modification involving one of the items above and changes to any other attribute will lose priority.
  • An order modification with no change to any attribute will lose priority.

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 Acknowledgement 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 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 allModify Ordermessage 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.
NumberOf ModifyOrderBitfields501BinaryBitfield identifying bitfields which are set. May be 0. Field values must be appended to the end of the message.
ModifyOrder Bitfield1511BinaryBitfield identifying fields to follow.
ModifyOrder Bitfieldᶯ1BinaryLast bitfield.
Optional fields. . .
Table 2. Modify Order Message Example
Field NameHexadecimalNotes
StartOfMessageBA BAStart of message bytes
MessageLength3E 0082 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 00 ABC124
OrigClOrdID41 42 43 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ABC123
NumberOfModify01One bitfield to follow
OrderBitfields
ModifyOrderBitfield10COrderQty, Price
OrderQty64 00 00 00100 contracts
Price08 E2 01 00 00 00 00 0012.34
Cboe Titanium U.S. Options BOE Specification - Modify Order Message Fields | Cboe