Sign In
View Entire Document

New Complex Order Message Fields (C1, EDGX, and C2 Only)

A New Complex Order message contains the details required to enter an order on a complex instrument created with previously entered New Complex Instrument message request. The message is similar to a New Order message with an additional repeating group of the positions for each leg. The positions must be in the order returned by the system in the Complex Instrument Accepted message response, not the order supplied in the New Complex Instrument message request. Complex orders in cross product spreads (i.e., SPX/SPXW, IWM/RUT, DIA/DJX, VIX/VXX, MNX/NDX) where the products do not operate on the same matching unit cannot leg into the simple book.

Permitted input optional fields are described in New Complex Order (C1, C2, and EDGX Only).

Table 1. New Complex Order Message Fields (C1, EDGX, and C2 Only)
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.
MessageType41Binary 0x4B
MatchingUnit51BinaryAlways 0 for inbound (Member to Cboe) messages.
SequenceNumber64BinaryThe sequence number for this message.
ClOrdID1020Text
  • Corresponds to ClOrdID (11) in Cboe FIX.
  • ID chosen by the client. Characters in the ASCII range 33-126 are allowed, except for comma, semicolon, and pipe.
  • If the ClOrdID matches a live order, the order will be rejected as duplicate.
  • Note: Cboe only enforces uniqueness of ClOrdID values among currently live orders, which includes long-lived, persisting GTC/GTD orders. However, we strongly recommend that you keep your ClOrdID values unique.
Side301Alphanumeric
  • Corresponds to Side (54) in Cboe FIX.
  • 1 = Buy
  • 2 = Sell
OrderQty314Binary
  • Corresponds to OrderQty (38) in Cboe FIX.
  • Order quantity. System limit is 999,999 contracts.
NumberOfNewComplexOrderBitfields 351BinaryBitfield identifying which bitfields are set. Field values must be appended to the end of the message.
NewComplexOrderBitfield¹ 361BinaryBitfield identifying fields to follow.
….
NewComplexOrderBitfieldᶯ 1BinaryLast bitfield.
NoLegs1Binary
  • Corresponds to NoLegs (555) in Cboe FIX.
  • Indicates the number of repeating groups to fol-
  • low.
  • Must be a minimum of 2 and a maximum of 16.
  • Repeating Group ComplexLegOrderInfo must occur the number of times specified in NoLegs. Each field occurs in each group in order as shown below. Optional fields occur only if corresponding bits in bitfields are set.
Table 2. New Complex Order Message Fields (C1, EDGX, and C2 Only)
LegPositionEffect1Alphanumeric
  • Corresponds to LegPositionEffect (564) in Cboe FIX.
  • Indicates status of client position in option for
  • this leg.
  • O = Open
  • C = Close
  • N = None*
  • *Only Orders with an OrderCapacity of ‘M’ or ‘N’ will be allowed to specify ‘N’ for LegPositionEffect.
  • If the leg is limited to closing only transactions, only Capacity = M will be permitted to submit OpenClose = O if the order has TimeInForce = ‘3’ (IOC) and RoutingInst = B.
Optional fields…Optional fields as set in the bitmap. Note, optional fields that occur in the repeating groups appear above, repeating per group, not within this block.

Required Order Attributes:

The following are required to be sent:

  • Symbol
  • Price only (limit orders) or Price and/or OrdType (limit or market orders. Note market and stop/stop limit orders are not supported during GTH or Curb sessions); and,
  • Capacity
  • LegPositionEffect

All other values have defaults. See List of Optional Fields for additional information about each optional field, including its default value.

Table 3. New Complex Order Message Example
Field NameHexadecimalNotes
StartOfMessage BA BAStart of message bytes.
MessageLength 4D 0077 bytes
MessageType 4B New Complex Order
MatchingUnit 00Always 0 for inbound messages
SequenceNumber 64 00 00 00Sequence number 100
ClOrdID 41 42 43 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ABC123
Side 31Buy
OrderQty 64 00 00 00100 contracts
NumberOfNewOrder Bitfields 02Two bitfields to follow
NewOrderBitfield1 E4Price, Symbol, Capacity, RoutingInst
NewOrderBitfield2 01Account
NoLegs 03Three legs
LegPositionEffect 4F O = Open
LegPositionEffect 4F O = Open
LegPositionEffect 4F O = Open
Price 38 FF FF FF FF FF FF FF-0.02
Symbol 30 30 30 30 43 31 00 000000C1
Capacity 43 C = Customer
RoutingInst 42 00 00 00 B = Book only, COA eligible
Account 44 45 46 47 00 00 00 00 00 00 00 00 00 00 00 00 DEFG
PreviousNext
Cboe Titanium U.S. Options BOE Specification - New Complex Order Message Fields (C1, EDGX, and C2 Only) | Cboe