Order Group Messages
Overview
Order groups provide automatic order cancellation when a contracts limit is reached. This feature helps manage risk by ensuring positions don’t exceed predefined thresholds. Order groups are managed through custom FIX message types.When an order group’s contracts limit is hit, all orders in the group are automatically canceled and no new orders can be placed until the group is reset.
Order Group Request (35=UOG)
Manage order groups with Create, Reset, Delete, and Trigger operations.Required Fields
| Tag | Name | Description | Type/Values |
|---|---|---|---|
| 20131 | OrderGroupAction | Operation to perform | Create<1>, Reset<2>, Delete<3>, Trigger<4> |
Fields by Action
Create (Action=1)
| Tag | Name | Description | Required |
|---|---|---|---|
| 20132 | OrderGroupContractsLimit | Maximum contracts allowed (1-1,000,000) | Yes |
The OrderGroupID is generated by the server and returned in the response. Do not include tag 20130 in Create requests.
Reset (Action=2)
| Tag | Name | Description | Required |
|---|---|---|---|
| 20130 | OrderGroupID | ID of group to reset | Yes |
Delete (Action=3)
| Tag | Name | Description | Required |
|---|---|---|---|
| 20130 | OrderGroupID | ID of group to delete | Yes |
Trigger (Action=4)
| Tag | Name | Description | Required |
|---|---|---|---|
| 20130 | OrderGroupID | ID of group to trigger | Yes |
The Trigger action immediately cancels all orders in the specified order group, regardless of whether the contracts limit has been reached. This is useful for manual risk management or emergency order cancellation.
Example Messages
Create Order Group
Reset Order Group
Delete Order Group
Trigger Order Group
Order Group Response (35=UOH)
Response to order group management requests.Response Fields
| Tag | Name | Description |
|---|---|---|
| 20130 | OrderGroupID | ID of the order group |
Errors are returned as BusinessMessageReject (35=j) messages, not in the OrderGroupResponse.