Order Groups

For an overview of order groups and how they work, see Order Groups.

Order Group Request (35=UOG)

Manage order groups with Create, Reset, Delete, Trigger, and Update operations.

Required Fields

Tag	Name	Description	Type/Values
20131	OrderGroupAction	Operation to perform	Create<1>, Reset<2>, Delete<3>, Trigger<4>, Update<5>

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

Deleting an order group cancels all resting orders in that group.

Trigger (Action=4)

Tag	Name	Description	Required
20130	OrderGroupID	ID of group to trigger	Yes

Trigger immediately cancels all orders in the specified order group, regardless of whether the contracts limit has been reached.

Update (Action=5)

Tag	Name	Description	Required
20130	OrderGroupID	ID of group to update	Yes
20132	OrderGroupContractsLimit	New maximum contracts allowed (1-1,000,000)	Yes

If the updated limit would immediately trigger the group based on the rolling 15-second window, the server cancels all orders in the group and marks it as triggered until reset.

Examples:

Create Margin 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 Margin 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 Margin 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|

Trigger Margin Order Group

8=FIXT.1.1|9=150|35=UOG|34=8|52=20230809-12:34:59.789|49=your-api-key|56=KalshiNR|
20131=4|20130=770e8400-e29b-41d4-a716-446655440002|10=126|

Update Margin Order Group Limit

8=FIXT.1.1|9=150|35=UOG|34=9|52=20230809-12:35:00.789|49=your-api-key|56=KalshiNR|
20131=5|20130=770e8400-e29b-41d4-a716-446655440002|20132=2500|10=127|

Order Group Response (35=UOH)

Response to order group management requests.

Response Fields

Tag	Name	Description
20130	OrderGroupID	ID of the order group

Business-logic errors (e.g. order group not found, exchange-returned errors) are returned as BusinessMessageReject (35=j) messages. Malformed fields (e.g. invalid UUID format for OrderGroupID) produce a session-level Reject (35=3).

Overview

REST

WebSockets

FIX

Order Group Request (35=UOG)

Required Fields

Fields by Action

Create (Action=1)

Reset (Action=2)

Delete (Action=3)

Trigger (Action=4)

Update (Action=5)

Order Group Response (35=UOH)

Response Fields

​Order Group Request (35=UOG)

​Required Fields

​Fields by Action

​Create (Action=1)

​Reset (Action=2)

​Delete (Action=3)

​Trigger (Action=4)

​Update (Action=5)

​Order Group Response (35=UOH)

​Response Fields

Order Group Request (35=UOG)

Required Fields

Fields by Action

Create (Action=1)

Reset (Action=2)

Delete (Action=3)

Trigger (Action=4)

Update (Action=5)

Order Group Response (35=UOH)

Response Fields