> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order Groups

> Manage order groups for automatic position management

For an overview of order groups and how they work, see [Order Groups](/getting_started/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      |

<Note>
  The OrderGroupID is generated by the server and returned in the response. Do not include tag 20130 in Create requests.
</Note>

#### 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      |

<Warning>
  Deleting an order group cancels all resting orders in that group.
</Warning>

#### Trigger (Action=4)

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

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

#### 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      |

<Note>
  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.
</Note>

**Examples:**

```fix Create Margin Order Group theme={null}
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|
```

```fix Reset Margin Order Group theme={null}
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|
```

```fix Delete Margin Order Group theme={null}
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|
```

```fix Trigger Margin Order Group theme={null}
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|
```

```fix Update Margin Order Group Limit theme={null}
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 |

<Note>
  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).
</Note>