# Telegram bot and mini app

> Get notifications, check your balance and positions, and look up prices from Telegram.

The Doxa Telegram bot sends you notifications and answers a few questions about your account without opening the website. You need a Doxa account and the Telegram app.

## Link your account

1. Open **Settings → Telegram**.
2. Press **Link Telegram**. Telegram opens the Doxa bot.
3. Confirm in the bot. It replies **Account linked**.

Each link is single use and expires, so if the bot says that the link did not work, go back to **Settings → Telegram** and press the button again. A Telegram account can be linked to only one Doxa account at a time. To move it, press **Unlink** on the other account first.

To stop all Telegram notifications, open **Settings → Telegram** and press **Unlink**.

## Notifications

Once linked, the bot can message you about:

- **Market results**
- **Order fills**
- **Price alerts**
- **Withdrawal status**

Each one has its own switch in **Settings → Telegram**, and all are on by default. Notifications in Telegram are separate from the [bell in the app](/features/messages-and-notifications/), where everything still appears.

## Commands

Send these to the bot in a private chat:

| Command | What it does |
| --- | --- |
| `/start` | Welcome message and the list of commands. |
| `/help` | The same welcome message and command list. |
| `/portfolio` | Your total balance, split into available, pending and in orders. |
| `/positions` | Your open positions, with side, size and average price. The first five are listed, with the rest in the app. |
| `/price query` | Searches active markets by name and shows their prices. For example, `/price bitcoin`. |

`/portfolio` and `/positions` need a linked account. They work only in a private chat with the bot, never in a group, so nobody else sees your balance. `/price` works for everyone.

The bot also adds a keyboard below the chat with **Portfolio**, **Positions** and **Markets** buttons that do the same things. Replies include buttons that open the market or your portfolio on Doxa.

## Mini app

The mini app is a small version of Doxa that opens inside Telegram.

To open it, send `/portfolio` or `/positions` to the bot in a private chat and press the **Mini App** button under the reply.

The mini app shows your **Portfolio**: your total value, your available and locked balance, and a list of open positions with their current value and profit or loss. You are signed in automatically through your linked Telegram account, so link it first. If it is not linked, the mini app tells you to link Telegram in the Doxa app. Outside Telegram it asks you to sign in through the Doxa app.