# 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](https://docs.tread.fi/other-features/telegram-bot/setup-guide).

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://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2Fajn4wPII86ULEqSjxdBS%2Fimg_1710.png?alt=media&#x26;token=dd78fb03-9cbe-4384-b4ec-904aa179f40d" 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://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FMhWLYxNt8DxD6mXY85TQ%2Fphoto_2025-06-20_14-39-27.jpg?alt=media&#x26;token=78dceb14-c1c5-41ee-9fce-f4f99f59fea2" alt="" width="375"><figcaption><p>Unrealized PNL Graph</p></figcaption></figure>

<figure><img src="https://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2F26NL1TdYrzf4CyVjWXuM%2Fphoto_2025-06-20_14-39-33.jpg?alt=media&#x26;token=3ca97f44-db1b-47ed-81d0-c9a380ef7608" 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://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FNbgkTBqgKc2pV4gpYzcr%2FIMG_20250618_170236_454.jpg?alt=media&#x26;token=a69d6fdf-f10f-4372-9497-f1cccab8a0f1" 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://3498068627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzGueudbPNYpRWNpS3Ilo%2Fuploads%2FOHAcRscMjg4pcWezChBh%2FScreenshot%202568-06-17%20at%2010.10.12%E2%80%AFAM.png?alt=media&#x26;token=f7c4d203-a5ee-4e4d-86a9-26940dc9ddaa" alt=""><figcaption></figcaption></figure>

### Alerts

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

<figure><img src="https://content.gitbook.com/content/zGueudbPNYpRWNpS3Ilo/blobs/03fUQYgTgSBirbhqm6TM/image.png" alt=""><figcaption></figcaption></figure>