New Order Message Fields

A New Order message consists of a number of required fields followed by a number of optional fields. The optional fields used are specified by setting bits in the NewOrderBitfields. Fields must be appended at the end of the message, starting with the lowest order enabled bit in the first bit field first.

Permitted input optional fields are described in New Order.

Table 1. New 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.
MessageType41Binary0x38
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, pipe, the ‘at’ symbol and double quotes.
  • 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. However, we strongly recommend that you keep your ClOrdID values unique.
Side301Alphanumeric
  • Corresponds to Side (54) in Cboe FIX.
  • 1=Buy
  • 2=Sell
  • 5=Sell Short (client affirms ability to borrow)
  • 6=Sell Short Exempt
OrderQty314Binary
  • Corresponds to OrderQty (38) in Cboe FIX.
  • Order quantity. System limit is 999,999 shares.
  • NumberOf
  • NewOrder
  • Bitfields
351BinaryBitfield identifying which bitfields are set. Field values must be appended to the end of the message.
NewOrderBitfield¹361BinaryBitfield identifying fields to follow.
….
NewOrderBitfieldᶯ1BinaryLast bitfield.
Optional fields. . .

Required Order Attributes:

The following are required to be sent on new orders:

  • Some form of symbology (see Symbology below);
  • Price (limit orders) or Price and/or OrdType (limit order market orders); and,
  • Capacity

All other values have defaults. See the table in Purge Rejected for additional information about each optional field, including its default value.

Symbology:

For additional information, refer to Cboe Titanium U.S. Symbology Reference.

Table 2. New Order Message Example
Field NameHexadecimalNotes
StartOfMessageBA BAStart of message bytes.
MessageLength4A 0073 bytes
MessageType38New Order
MatchingUnit00Always 0 for inbound messages
SequenceNumber64 00 00 00Sequence number 100
ClOrdID41 42 43 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00 00ABC123
Side31Buy
OrderQtyE8 03 00 001,000 shares
NumberOfNewOrder Bitfields033 bitfields to follow
NewOrderBitfield104Price
NewOrderBitfield2C1Symbol, Capacity, RoutingInst
NewOrderBitfield301Account
Price44 D6 12 00 00 00 00 00$123.45
Symbol4D 53 46 54 00 00 00 00MSFT
Capacity50P=Principal
RoutingInst52 00 00 00R=Routable
Account44 45 46 47 00 00 00 00 00 00 00 00 00 00 00 00DEFG
Cboe Titanium U.S. Equities BOE Specification - New Order Message Fields | Cboe