> For the complete documentation index, see [llms.txt](https://katoshi.gitbook.io/katoshi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://katoshi.gitbook.io/katoshi-docs/app/groups.md).

# Groups

This section documents the Groups page.

***

## Group Overview

Trading groups can be created to allow other users to copy your trades. 

* Groups can be made public for anyone to join while [earning fees](#group-monetization) from member's trades.
* Groups can be made private so that only your own bots can join, which is a useful way to split your orders across multiple addresses and obfuscate your real position size.
* 3 tabs are available: 
  * Public: Groups available for anyone to join
  * Joined: All groups your bots have joined
  * Owned: Groups created by you

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2Fxbvp10BIWPIISnZUjGL0%2Fimage.png?alt=media&amp;token=d0bb7633-9bcd-45a7-b774-2fe98e6a48d2" alt=""><figcaption></figcaption></figure>

***

## Group Creation

* Click on the "+" button in the bottom-right corner to show the group creation popup
* Choose a unique name for your group
* Add a description for your group
* Choose the Bot Owner for the group

{% hint style="info" %}
Every group has a dedicated bot that is the owner of the group.&#x20;

* All signals sent to bot owners are automatically propagated to their member's bot
  {% endhint %}

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FxWzO21n7wSKzRqZVKfYv%2Fimage.png?alt=media&amp;token=841090a5-0244-47e3-af28-fec90ae64d1b" alt=""><figcaption></figcaption></figure>

***

## Group Details

* Group publisher name
* Group description
* Traded coins (Bot owner's whitelisted coins)
* Number of bots connected
* Days since group was made public
* Portfolio and positions of the group's bot owner

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2F5oJxLLCM0uJCJJfFWUvL%2Fimage.png?alt=media&amp;token=266774ac-5aa5-4134-b411-bbdcf10e07f5" alt=""><figcaption></figcaption></figure>

***

## Manage Group Bots

* This section lets you choose which bot to join/leave a group.

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FESHfV5Hi7HGr7PnFZRpn%2Fimage.png?alt=media&amp;token=a21b8220-3c33-442c-9b5d-395ccf0ae65f" alt=""><figcaption></figcaption></figure>

* Connecting your bot to a public group will prompt you to authorize it first
* Authorizing a group requires a wallet signature to approve [Hyperliquid Builder Codes](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes) for the group owner address, which are used to monetize their group.

{% hint style="info" %}
No additional fees are charged to group members, we simply transfer our platform trading fees to the group owner.
{% endhint %}

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FfFJHucpchu5dISFodokN%2Fimage.png?alt=media&amp;token=586aa75c-9c69-4170-a2e3-09faf1feb19b" alt=""><figcaption></figcaption></figure>

***

## **Group Settings**

* **Name:** Update the group name
* **Description:** Update the group description
* **Hyperliquid Payout Address:** Set an Hyperliquid account address to receive member's trading fees
* **Group Owner:** Choose which of your bot should control the group (this setting can't be changed once group is made public)
* **Status:** Set the status of your group to either public (anyone can join) or private (only your own bots can join)

{% hint style="info" %}
The payout account must have a min. of 100 USDC sitting in perps account at all times. Hyperliquid set this requirement in order to receives fees via [builder codes](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes)
{% endhint %}

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2Fi8ZviPte3Kyyv901raJf%2Fimage.png?alt=media&amp;token=54df50b8-6826-4bd6-9356-a88a71355948" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Turning your group from public to private will send a final `clear_all` signal to all connected bots to make sure all positions are closed and all resting orders canceled.
{% endhint %}

***

## Group Monetization

* Creating a public group entitles you to earn 100% trading fees from all joined members.
* Trading fees are collected via [Hyperliquid Builder Codes](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes) and sent directly to your payout address
* Trading fee rates are based on the [active plan](/katoshi-docs/app/fees-and-credits.md) of each users