Skip to main content

Bot Commands — Manage Positions via Chat

TL;DR

Send /trade to open the position-management menu: Close Position, Set to Break-Even, Cancel DCA, Cancel All Orders. All actions resolve to one of your linked exchange accounts via the corresponding Trade Setting's API key. Every command is mirrored in your TVH activity log.

The Telegram bot is not just a signal executor — it is a full position-management surface for the exchanges configured in your Trade Settings. When you're away from your desk, the /trade menu lets you do the four things that matter most when a trade goes sideways.

/trade — the command menu​

The bot recognizes three slash commands. Tap Menu in the chat bar to see them: /trade (open trade options), /start (start the bot), /stop (stop the bot).

The bot's command list: /trade, /start, /stop

Send /trade and the bot replies with an inline menu of four position actions — Close Position, Set to break-even, Cancel DCA, Cancel all orders (plus X to dismiss):

The /trade menu: Close Position, Set to break-even, Cancel DCA, Cancel all orders

Tap any option and the bot proceeds to a context-specific picker (your open positions, your symbols with pending limits, etc.) — no typing required.

Close Position​

What it does: market-closes one of your open positions and cancels every associated pending order (the SL, all TPs, any remaining DCA limits).

Flow:

  1. Tap Close Position from the /trade menu.

  2. Under a Choose the position: header, the bot lists all open positions across your linked exchanges, each row showing the symbol, side (Buy/Sell), and live PnL:

    Choose the position picker listing each open position with its side and PnL

  3. Tap the position you want to close.

  4. The bot fires a market close, cancels pending orders for that symbol, and confirms with the realized PnL.

Use this when a trade is moving against you fast and you want out immediately, or when a TP target has been hit and you want to lock in the rest manually instead of waiting for the next TP.

Set to Break-Even​

What it does: for a position currently in profit, moves the stop loss to the average entry price and cancels any pending limit orders that would still add to the position below (for LONG) or above (for SHORT) that level.

Flow:

  1. Tap Set to break-even from the /trade menu.

  2. Under a Choose the break-even position: header, the bot lists only positions with positive PnL — break-even is a no-op (or a loss-locker) on a losing trade, so the menu hides those:

    Choose the break-even position picker, showing only positions in profit

  3. Tap a position. The bot:

    • Locates the existing SL order on the exchange.
    • Updates its trigger price to your average entry.
    • Cancels DCA limit orders that would still try to add more size (their trigger is now beyond the new SL, so they would self-defeat).

  4. The bot acknowledges the action with Set stop-loss to break-even <SYMBOL>.

Use this when a trade reaches your first TP or a key level and you want to make sure the remainder cannot lose money.

Cancel DCA​

What it does: cancels every pending limit order on a chosen symbol that the bot recognizes as a DCA entry (a limit order placed by the order-mesh logic to add to the position at a better price).

Flow:

  1. Tap Cancel DCA from the /trade menu.
  2. The bot lists symbols that currently have pending DCA limits.
  3. Tap a symbol → all DCA limits for that symbol are cancelled. The position itself stays open; only the unfilled add-on orders go away.

Use this when the entry range looks complete (price has moved away and you don't expect more fills), or when you want to lock in current size without further averaging.

Cancel All Orders​

What it does: cancels every pending order for a chosen symbol — DCA limits and SL and TPs. The open position itself is untouched.

Flow:

  1. Tap Cancel all orders from the /trade menu.
  2. The bot lists symbols with any pending orders (limits, SL, TPs).
  3. Tap a symbol → everything pending on that symbol is cancelled.

This is the nuclear option. Most users prefer Close Position (which also cancels pending orders, but additionally exits the position) or Cancel DCA (more surgical). Use Cancel All when you want to take over manual management of a position and have a clean slate of zero pending orders.

Multi-API-key support​

If you have multiple Trade Settings using different API keys (e.g., one for Binance Futures, one for Bybit — see routing logic), the bot first asks you to pick the exchange + API key the action should run against:

Choose exchange & api key:

Each option shows the exchange name and API key name (e.g. Binance-Futures (Main) / Bybit (Alt)), so you always know which account you're about to act on. After you pick, the bot lists the positions or symbols on that account and you continue with the regular flow.

Layout may vary

The exact format of menu rows is rendered by Telegram and can vary slightly between mobile and desktop clients. Treat the example labels above as illustrative.

Quick command reference​

Command / actionEffect
/startInitial auth — paste your Access Key to link your TVH account to this Telegram chat.
/stopDisable the bot for this chat. Unlinks the account (clears the stored chat ID) and turns off the trade log. Re-run /start to re-enable.
/tradeOpen the position-management menu (Close, Break-Even, Cancel DCA, Cancel All).
Forward a signal messageAuto-parse + execute via your matching Trade Setting.
Paste raw signal textSame parser as a forward. Useful when the source channel blocks forwarding.

The bot does not implement a /help command — the four /trade options cover everything it can do beyond signal handling.

Notifications you'll receive​

Once the bot is linked, it sends a Telegram message each time TVH executes a trade for you — regardless of which integration fired it (TradingView webhook, Chrome Extension, Telegram forward, or copy-trading broadcast). The message reports the outcome of that execution:

NotificationTriggered by
Trade executedThe command ran successfully — entry placed, SL/TP set, DCA orders staged, or a close fired. Confirms the action TVH took.
WarningThe command ran but something needed attention (e.g. a leverage value was capped, part of the request was adjusted).
ErrorThe exchange rejected the command. Includes the exchange's error string (insufficient margin, leverage mismatch, symbol not tradable, etc.).

The bot does not stream live fill events, SL/TP-hit alerts, or position-closed updates — it reports the result of each command TVH sends, not the ongoing order lifecycle on the exchange. Watch the exchange or your Activity Log for fills and triggers.

To stop the bot from sending you messages, send /stop in the chat. This unlinks your TVH account from the chat (clears the stored chat ID) and turns off the trade log. Re-run /start and paste your Access Key when you want to re-enable both notifications and command access.

Where to go next​

  • More routing power? Set up filtered Trade Settings so different channels and symbols hit different exchanges.
  • Add your trades to copy trading? Wire your Trade Setting's Broadcast Signal field to a Signal Source and your forwarded trades fan out to followers.
  • Want notifications without execution? Email Backup is a parallel low-latency signal channel that runs independently of Telegram.