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, and Delete operations.

Required Fields

TagNameDescriptionType/Values
20131OrderGroupActionOperation to performCreate<1>, Reset<2>, Delete<3>

Fields by Action

Create (Action=1)

TagNameDescriptionRequired
20132OrderGroupContractsLimitMaximum 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)

TagNameDescriptionRequired
20130OrderGroupIDID of group to resetYes

Delete (Action=3)

TagNameDescriptionRequired
20130OrderGroupIDID of group to deleteYes

Example Messages

Create Order Group
8=FIXT.1.1|9=150|35=UOG|34=5|52=20230809-12:34:56.789|49=your-api-key|56=KalshiNR|
20131=1|20132=5000|10=123|
Reset Order Group
8=FIXT.1.1|9=150|35=UOG|34=6|52=20230809-12:34:57.789|49=your-api-key|56=KalshiNR|
20131=2|20130=770e8400-e29b-41d4-a716-446655440002|10=124|
Delete Order Group
8=FIXT.1.1|9=150|35=UOG|34=7|52=20230809-12:34:58.789|49=your-api-key|56=KalshiNR|
20131=3|20130=770e8400-e29b-41d4-a716-446655440002|10=125|

Order Group Response (35=UOH)

Response to order group management requests.

Response Fields

TagNameDescription
20130OrderGroupIDID of the order group
Errors are returned as BusinessMessageReject (35=j) messages, not in the OrderGroupResponse.