# Bot Client — Managing MoonTrader via Telegram

Bot Client is a MoonTrader extension that lets you manage trading accounts directly from Telegram. Open and close positions, stop algorithms, change leverage, and get reports — without opening the terminal. This guide covers the full setup from scratch: from creating a bot to executing your first commands.

> **Requirements:** a Telegram account, BotClient.exe installed, MoonTrader core running.

***

### 1. Creating a Telegram Bot

Before launching Bot Client, you need to create your own Telegram bot. This bot acts as the interface between you and MoonTrader.

1. Open Telegram and find **@BotFather**.
2. Send the command `/newbot`.
3. Enter a name for the bot (any name).
4. Enter the bot's username — it must end with `Bot` or `_bot`, e.g. `MyTraderBot`.
5. Save the **Token** that BotFather sends — you will need it when configuring BotClient.

> To view the token of an existing bot: `/mybots` → select the bot → "API Token".

***

### 2. Getting Your ChatID

ChatID is your Telegram identifier. Bot Client uses it to send notifications only to you.

1. Find the bot **@myidbot**.
2. Send the command `/getid`.
3. Save the ChatID you receive.

***

### 3. Configuring and Starting BotClient

1. Extract the BotClient archive to a convenient folder.
2. Launch **BotClient.exe**.
3. In the "Token" field, enter the token from step 1.
4. In the "ChatID" field, enter the identifier from step 2.
5. Click "Save" — Bot Client is ready to use.

After launching, find your bot in Telegram: `/mybots` → select the bot → "Go to chat" → click **Start**. All further commands are executed in this chat.

> The bot's interface language can be changed in "Telegram Settings" → "Telegram Layout".

***

### 4. Managing Profiles

A profile is a connection to one MoonTrader account. Bot Client supports multiple profiles simultaneously.

#### Add a Profile

1. Open "Profile" → "Add".
2. Enter the account details from the MoonTrader client.
3. Click "Execute" — the profile will be added if the core is available.

#### Edit a Profile

1. Open "Profile" → "Edit" or type `/edit_profile`.
2. Select the profile from the list.
3. Update the required parameters and click "Execute".

#### Set Default Profiles

Default profiles are automatically applied to all commands — no need to select them manually each time.

1. Open "Profile" → "Default".
2. Select the profiles from the list.
3. Click "Execute".

**Text command:**

```
#change def profile; pr: profile1, profile2;
```

#### Remove a Profile

1. Open "Profile" → "Remove" or type `/remove_profile`.
2. Select the profile from the list.
3. Click "Execute" to confirm.

**Text command:**

```
#remove profile; pr: profile1, profile2;
```

***

### 5. Orders and Positions

#### Add an Order

This command works with one profile at a time.

1. Open "Order" → "Add" or type `/add_order`.
2. Fill in the parameters: profile, market, side (buy/sell), order type, instrument, volume, price.
3. If needed, configure Take Profit and Stop Loss in the same menu.
4. Click "Execute".

> ⚠️ Make sure all parameters are correct — the order will be sent to the exchange immediately.

#### Cancel Orders

This command cancels only open (unfilled) orders.

1. Open "Order" → "Cancel" or type `/cancel_order`.
2. Select the profile, market, and instruments.
3. Click "Execute".

To abort mid-execution, click "Stop".

**Text commands:**

```
#cancel order; pr: profile1, profile2; market: spot; symbols: ethusdt;
#cancel order; pr: all; market: futures; cancel all: true;
```

#### Order List

1. Open "Order" → "List" or type `/get_order_list`.
2. Select the profile — current orders for each market will load.
3. From this menu you can also cancel selected orders or view their details.

#### Close Positions

This command works with open positions, not with open orders.

1. Open "Position" → "Close" or type `/close_positions`.
2. Select the profile, market, and instruments.
3. Click "Execute" and wait for the core response.

**Text commands:**

```
#get pos; pr: profile1, profile2;
#get pos; pr: all;
```

#### Panic Sell — Emergency Position Close

Panic Sell closes all open positions in the selected markets. Open orders are not affected.

1. Open "Panic" or type `/panic_sell`.
2. Select the profile — all open positions will appear, grouped by market.
3. Click "Execute".

> ⚠️ Use Panic Sell only when you need to exit all positions immediately — this action is irreversible.

**Text commands:**

```
#panic sell; pr: profile1; market: futures; symbols: btcusdt, ethusdt;
#panic sell; pr: all; market: spot; symbols: all;
```

***

### 6. Managing Algorithms

#### Stop All Algorithms

Stops all running algorithms on the selected account.

1. Open "Algorithms" → "Stop All" or type `/stop_all_algorithm`.
2. Select the profile and click "Execute".

**Text commands:**

```
#stop all algo; pr: all;
#stop all algo; pr: profile1, profile2;
```

#### Start All Algorithms

Starts all previously stopped algorithms.

1. Open "Algorithms" → "Start All" or type `/start_all_algorithm`.
2. Select the profile and click "Execute".

**Text command:**

```
#start all algo; pr: profile1, profile2;
```

#### Manage Individual Algorithms

1. Open "Algorithms" → "Manage".
2. The list of algorithms on the selected core will load.
3. For each algorithm, the following actions are available: start, stop, delete.

***

### 7. Market Settings

#### Change Leverage

This command only works on markets with no open positions or orders.

1. Open "Market" → "Change Leverage" or type `/modify_leverage`.
2. Select the profile, market, and instruments.
3. Enter the new leverage value.
4. Click "Execute".

> If leverage is not specified, the exchange's maximum allowed value will be set.

**Text command:**

```
#modify leverage; pr: profile1; market: futures; symbols: bnbusdt; leverage: 23;
```

#### Change Margin Type

This command only works on markets with no open positions or orders.

1. Open "Market" → "Change Margin" or type `/modify_margin`.
2. Select the profile, market, instruments, and margin type (Cross or Isolated).
3. Click "Execute".

**Text command:**

```
#modify margin; pr: profile1; market: futures; margin type: cross; symbols: bnbusdt;
```

#### Balance

To view the balance for selected profiles:

1. Open "Balance" → "Info" or type `/get_balance`.
2. Select the profile and market.

**Text command:**

```
#get balance; pr: profile1; market: futures;
```

To transfer assets between markets:

1. Open "Balance" → "Transfer".
2. Enter the profile, source market, target market, asset, and amount.
3. Click "Execute".

**Text command:**

```
#transfer balance; pr: profile1; from market: futures; to market: spot; symbol: USDT; amount: 100;
```

***

### 8. Core and Reports

#### Core Management

The "Core" menu offers four actions:

| Action            | Description                     | Text command                        |
| ----------------- | ------------------------------- | ----------------------------------- |
| Status            | Shows the current account state | `#core status; pr: all;`            |
| Restart           | Restarts the core with update   | `#core restart; pr: all;`           |
| Restart No Update | Restarts without update         | `#core restart no update; pr: all;` |
| Shutdown          | Shuts down the core             | `#core shutdown; pr: all;`          |

Select an action in the "Core" menu and click "Execute", or send a text command.

#### Reports

Loads algorithm reports filtered by market and instrument.

* Single profile → detailed report per algorithm (number of filled orders, average order size, result).
* Multiple profiles → summary report without per-algorithm details.

The "Markets", "Quote/Symbol", and "Information" fields can be left empty.

#### Positions

Loads information on all open positions across the selected accounts.

**Text command:**

```
#get pos; pr: all;
```

***

### 9. Signals from Telegram Channels

Bot Client can parse trading signals from Telegram channels and automatically forward them to connected cores.

> **Supported platforms:** Windows, Ubuntu/Linux 20.04.

#### Step 1 — Connect a Telegram Account

1. Open "Profile" → "Telegram Profile".
2. Click "Login".
3. Authorization fields will appear in the chat (if they don't — press Enter).
4. Enter your phone number.
5. Enter the code from Telegram.
6. Enter your password if two-factor authentication is enabled.

After successful authorization, the connected account status will appear in "Profile" → "Telegram Profile".

#### Step 2 — Select Channels to Monitor

1. Open "Algorithms" → "Signals" → "Channels".
2. Select the channels you want to receive signals from.
3. Click "Execute".

Parsing rules for each channel are configured separately: "Algorithms" → "Signals" → "Channel Settings".

Once configured, Bot Client will monitor the selected channels and forward any signals to all connected cores.

```
Binance USDT-M sell galausdt tp 3% sl 4%
```

***

### Text Command Syntax

A text command must start with `#`. Any other message is treated as menu navigation.

**Rules:**

* Parameters are separated by `;` or a line break — both are equivalent.
* Parameters can be abbreviated: `pr` instead of `profiles`, `m` instead of `margin`, etc.
* Parameter order does not matter.
* If all parameters are valid — the command executes immediately. Otherwise, a pre-filled form opens.
* Multiple profiles are listed with commas: `pr: profile1, profile2`. To apply to all — `pr: all`.
* Any character (including a space) can separate a parameter from its value: `pr: all` and `pr all` are equivalent.

**Market codes:** `f` — futures, `m` — margin, `s` — spot, `d` — delivery.

**Order side:** `buy`, `sell`.

**Order type:** `Limit`, `Market`, `StopLimit`, `StopMarket`, `LimitMarket`, `PostOnly`.

**Margin type:** `Cross`, `Isolated`.

***

### Text Command Cheatsheet

#### Commands

| Command                   | Description              | Example                                                                                 |
| ------------------------- | ------------------------ | --------------------------------------------------------------------------------------- |
| `#core status`            | Core status              | `#core status; pr: all;`                                                                |
| `#core restart`           | Restart core with update | `#core restart; pr: main;`                                                              |
| `#core restart no update` | Restart without update   | `#core restart no update; pr: main;`                                                    |
| `#core shutdown`          | Shut down core           | `#core shutdown; pr: all;`                                                              |
| `#get pos`                | List open positions      | `#get pos; pr: main, backup;`                                                           |
| `#get balance`            | Balance by market        | `#get balance; pr: main; market: f;`                                                    |
| `#transfer balance`       | Transfer between markets | `#transfer balance; pr: main; from market: f; to market: s; symbol: USDT; amount: 500;` |
| `#start all algo`         | Start all algorithms     | `#start all algo; pr: all;`                                                             |
| `#stop all algo`          | Stop all algorithms      | `#stop all algo; pr: main;`                                                             |
| `#panic sell`             | Emergency position close | `#panic sell; pr: main; market: f; symbols: btcusdt, ethusdt;`                          |
| `#add order`              | Place an order           | see below                                                                               |
| `#cancel order`           | Cancel orders            | `#cancel order; pr: main; market: f; symbols: btcusdt;`                                 |
| `#modify leverage`        | Change leverage          | `#modify leverage; pr: main; market: f; symbols: btcusdt; leverage: 10;`                |
| `#modify margin`          | Change margin type       | `#modify margin; pr: main; market: f; margin type: cross; symbols: btcusdt;`            |
| `#remove profile`         | Remove a profile         | `#remove profile; pr: old_account;`                                                     |
| `#change def profile`     | Set default profiles     | `#change def profile; pr: main, backup;`                                                |

***

#### `#add order` — Full Syntax

Minimal example (no TP/SL):

{% code overflow="wrap" %}

```
#add order; pr: main; market: f; side: buy; order type: Limit; symbol: btcusdt; order size: 100; price: 65000;
```

{% endcode %}

With Take Profit and Stop Loss:

```
#add order
pr: main
market: f
side: buy
order type: Limit
symbol: btcusdt
order size: 100
price: 65000
tp percentage: 2
tp order type: Limit
sl percentage: 1
sl order type: Market
sl trailing spread: 0.1
```

> If `tp percentage` is not set — all other `tp *` parameters are ignored. Same applies to `sl percentage`.
>
> If `sl trailing spread` is set — trailing is enabled automatically.
>
> If `leverage` is not set in `#modify leverage` — the exchange maximum is applied.

***

#### Parameters

#### General

| Parameter     | Abbreviation | Allowed values                                                               | Example                     |
| ------------- | ------------ | ---------------------------------------------------------------------------- | --------------------------- |
| `profiles`    | `pr`         | Names separated by commas, or `all`                                          | `pr: main, backup`          |
| `market`      | `m`          | `f` / `m` / `s` / `d`                                                        | `market: f`                 |
| `symbols`     | —            | Tickers separated by commas, or `all`                                        | `symbols: btcusdt, ethusdt` |
| `side`        | —            | `buy` / `sell`                                                               | `side: buy`                 |
| `order type`  | —            | `Limit` / `Market` / `StopLimit` / `StopMarket` / `LimitMarket` / `PostOnly` | `order type: Limit`         |
| `order size`  | —            | Number                                                                       | `order size: 100`           |
| `price`       | —            | Number                                                                       | `price: 65000`              |
| `cancel all`  | —            | `true` / `false`                                                             | `cancel all: true`          |
| `leverage`    | —            | Number (if not set — exchange maximum)                                       | `leverage: 10`              |
| `margin type` | —            | `Cross` / `Isolated`                                                         | `margin type: cross`        |
| `amount`      | —            | Number                                                                       | `amount: 500`               |
| `symbol`      | —            | Asset ticker                                                                 | `symbol: USDT`              |
| `from market` | —            | `f` / `m` / `s` / `d`                                                        | `from market: f`            |
| `to market`   | —            | `f` / `m` / `s` / `d`                                                        | `to market: s`              |

#### Take Profit (`#add order`)

| Parameter                  | Description                                  | Example                        |
| -------------------------- | -------------------------------------------- | ------------------------------ |
| `tp percentage`            | TP % from entry price. Required to enable TP | `tp percentage: 2`             |
| `tp order type`            | TP order type                                | `tp order type: Limit`         |
| `tp is iceberg`            | Iceberg order                                | `tp is iceberg: true`          |
| `tp auto price down time`  | Time before auto price reduction (sec)       | `tp auto price down time: 60`  |
| `tp auto price down step`  | Auto price reduction step                    | `tp auto price down step: 0.1` |
| `tp auto price down limit` | Auto price reduction limit                   | `tp auto price down limit: 1`  |

#### Stop Loss (`#add order`)

| Parameter            | Description                                                 | Example                   |
| -------------------- | ----------------------------------------------------------- | ------------------------- |
| `sl percentage`      | SL % from entry price. Required to enable SL                | `sl percentage: 1`        |
| `sl order type`      | SL order type                                               | `sl order type: Market`   |
| `sl spread`          | SL spread                                                   | `sl spread: 0.05`         |
| `sl delay`           | Delay before triggering (sec)                               | `sl delay: 5`             |
| `sl trailing spread` | Trailing spread. If set — trailing is enabled automatically | `sl trailing spread: 0.1` |

***

#### Market Codes

| Code | Market   |
| ---- | -------- |
| `f`  | Futures  |
| `m`  | Margin   |
| `s`  | Spot     |
| `d`  | Delivery |


---

# Agent Instructions: 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://guide.moontrader.com/en-moontrader-docs/tips-and-recommendations/bot-client-managing-moontrader-via-telegram.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.