Trade Message Fields
The Trade message provides information about executions of non-displayed orders on the Cboe book and routed executions to other trading centers. In options a Trade message can also be sent when an auction executes against a non-displayed order, such as a contra response. Trade messages are necessary to calculate Cboe execution-based data. Trade messages do not alter the book and can be ignored if messages are being used solely to build a book.
No Add Order message is sent for hidden orders, and thus, no modify order messages may be sent when hidden orders are executed. Instead, a Trade message is sent whenever a hidden or routed order is executed in whole or in part. A Trade message is also sent when there is an execution against any non-displayed portion of a reserve order. As with visible orders, hidden, routed and reserve orders may be executed in parts. A complete view of all Cboe executions can be built by combining all Order Executed messages and Trade messages.
The Order ID of a hidden order is obfuscated by default in the Trade message, but may be optionally disseminated for a member’s own orders upon request. As such, partial executions against the same hidden order will by default have different Order IDs.
| Field Name | Offset | Length | Type/(Value) | Description |
|---|---|---|---|---|
| Length | 0 | 1 | Binary | Length of this message including this field |
| Message Type | 1 | 1 | 0x2A | Trade message (long) |
| Time offset | 2 | 4 | Time Offset | Nanosecond offset from last unit timestamp |
| Order Id | 6 | 8 | Binary | Obfuscated Order ID or Order Id of the executed order. |
| Side Indicator | 14 | 1 | Alphanumeric | Always B=Buy Order regardless of resting side |
| Quantity | 15 | 4 | Binary | Incremental number of shares/contracts executed |
| Symbol | 19 | 6 | Printable ASCII | Symbol right padded with spaces. |
| Price | 25 | 8 | Binary Long Price | The execution price of the order |
| Execution Id | 33 | 8 | Binary | Cboe generated day-unique execution identifier of this trade. Execution Id is also referenced in the Trade Break message. |
| Trade Condition | 41 | 1 | Alphanumeric |
|
| Total Length = 42 bytes (Options only), 41 bytes (Equities only) | ||||
| Field Name | Offset | Length | Type/(Value) | Description |
|---|---|---|---|---|
| Length | 0 | 1 | Binary | Length of this message including this field |
| Message Type | 1 | 1 | 0x2B | Trade message (short) |
| Time offset | 2 | 4 | Time Offset | Nanosecond offset from last unit timestamp |
| Order Id | 6 | 8 | Binary | Obfuscated Order ID or Order Id of the executed order. |
| Side Indicator | 14 | 1 | Alphanumeric | Always B=Buy Order regardless of resting side |
| Quantity | 15 | 2 | Binary | Incremental Number of shares/contracts executed |
| Symbol | 17 | 6 | Printable ASCII | Symbol right padded with spaces. |
| Price | 23 | 2 | Binary Short Price | The execution price of the order |
| Execution Id | 25 | 8 | Binary | Cboe generated day-unique execution identifier of this trade. Execution Id is also referenced in the Trade Break message. |
| Trade Condition | 33 | 1 | Alphanumeric |
|
| Total Length = 34 bytes (Options only), 33 bytes (Equities only) | ||||
The following expanded version of the Trade message has been made available to accommodate larger symbol sizes possible through the ISRA plan.
| Field Name | Offset | Length | Type/(Value) | Description |
|---|---|---|---|---|
| Length | 0 | 1 | Binary | Length of this message including this field |
| Message Type | 1 | 1 | 0x30 | Trade message (long) |
| Time offset | 2 | 4 | Time Offset | Nanosecond offset from last unit timestamp |
| Order Id | 6 | 8 | Binary | Obfuscated Order ID or Order Id of the executed order. |
| Side Indicator | 14 | 1 | Alphanumeric | Always B=Buy Order regardless of resting side |
| Quantity | 15 | 4 | Binary | Incremental number of shares/contracts executed |
| Symbol | 19 | 8 | Printable ASCII | Symbol right padded with spaces. |
| Price | 27 | 8 | Binary Long Price | The execution price of the order |
| Execution Id | 35 | 8 | Binary | Cboe generated day-unique execution identifier of this trade. Execution Id is also referenced in the Trade Break message. |
| Trade Condition | 41 | 1 | Alphanumeric |
|
| Total Length = 44 bytes Options Only, 43 bytes Equities Only | ||||





