# Telegram Bot

The tread.fi Telegram bot provides on-the-go access to algo-trading functions and real-time updates.  For setup instructions please [here](/other-features/telegram-bot/setup-guide.md).

Please note the Telgram bot is still in beta, please use with caution.

### Key Commands

The bot uses interactive buttons for most actions, allowing for fast and intuitive trading.

<figure><img src="/files/s7HSJOsWIfNUjXZqv4Ow" alt="" width="375"><figcaption><p>Telegram Bot Menu</p></figcaption></figure>

* **/order**: Place new trades.
  * Choose the account you want to trade from.
  * Select your desired trading pair.
  * Use preset amounts (e.g., 1,000 USDT, 10,000 USDT), percentages of your balance (50% or 100% for quick exits), or enter a custom quantity.
  * Specify the urgency of your order (Very Low, Low, Medium, High, Very High).
* **/balance**: Get a summary of your current account holdings. You can view balances for a specific account or for all accounts combined.
* **/portfolio**: Track your account's historical performance. This command generates graphical charts of your PnL and balance history over the last 7 days.

<figure><img src="/files/K6GrGuBmET2vYscbIUsu" alt="" width="375"><figcaption><p>Unrealized PNL Graph</p></figcaption></figure>

<figure><img src="/files/mHvLeJVHG7v9WJTLUHrS" alt="" width="375"><figcaption><p>Total Balance &#x26; GMV Graph</p></figcaption></figure>

* **/status:** Check the status of any active or recent order. This displays perecentage filled, average execution price and a direct link to the order page.
* **/cancel:** Cancel an active order. If you have multiple active orders, you'll be prompted to select which one to cancel.
* **/price:** View a candlestick price chart for a specific market. Use the format `/price <exchange> <pair> [period]`
  * Time period can be hour, day, week, month
  * Example: /price Binance ETH-USDT day

<figure><img src="/files/Ed5FiHVcKN3sYkRQYFEX" alt="" width="375"><figcaption><p>Candlestick Price Chart</p></figcaption></figure>

* **/exit**: Exit the current workflow.
* **/help:** Display the full list of available bot commands.

### Getting Alerts

You can customize Telegram alerts in the Settings page to stay informed on key trading events.

<figure><img src="/files/sHrOx1vU6tWCByiQRFCL" alt=""><figcaption></figcaption></figure>

### Alerts

Below is an example of an order's notifications in Telegram

<figure><img src="/files/iqjrNlBNvq1Xiyt2wVqX" alt=""><figcaption></figcaption></figure>


---

# 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://docs.tread.fi/other-features/telegram-bot.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.