> For the complete documentation index, see [llms.txt](https://docs.tread.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tread.fi/tread.fi-institutional-api-docs/other-features/telegram-bot.md).

# 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](/tread.fi-institutional-api-docs/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="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/YyF5NmovSsXXrgLMNj2C/img_1710.png" 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="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/MBk9kuHRURxO2lIzBMhC/photo_2025-06-20_14-39-27.jpg" alt="" width="375"><figcaption><p>Unrealized PNL Graph</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/IP37SxffMdWaaoaseva5/photo_2025-06-20_14-39-33.jpg" 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="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/JhqL1jQDC9WKZzZZcE5p/IMG_20250618_170236_454.jpg" 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="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/JfQrhtQpJU50gTPkV9r9/Screenshot%202568-06-17%20at%2010.10.12%E2%80%AFAM.png" alt=""><figcaption></figcaption></figure>

### Alerts

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

<figure><img src="https://content.gitbook.com/content/QGcP9MNIBq6caHeVJrjq/blobs/V7lGwuJrQ1LQ3w0VYuCa/image.png" alt=""><figcaption></figcaption></figure>