> 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

***

## 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="/files/lwcp2h1GEiuNcifYnfg8" 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="/files/GmMOtXfPuSE6M72XMAyz" 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="/files/IBiVa0O0xyM5ipeHEbsr" alt=""><figcaption></figcaption></figure>

***

## Manage Group Bots

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

<figure><img src="/files/Or5LAm4UevOZUzkgfz1s" 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="/files/WlbFT1H2tWGbuX5iBCUg" 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="/files/zORbKTCb9ZdxYmYrnZb7" 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://katoshi.gitbook.io/katoshi-docs/app/groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.