Bots

​

Overview

The Bot page is your trading floor: every bot with its P&L, trades, win rate, ladder step, and status. Clicking a bot opens the builder — a canvas with three lanes: Signal sources → Risk management → Brokers. URL: /bot

​

Bot lifecycle

Draft (incomplete) → Ready (configured) → Active (trading) ⇄ Paused. Activation needs all three pieces: a signal source, a broker account, and trading settings — the error names whatever’s missing. The same trading pair can’t run on two bots on one broker account.

​

Bots pause themselves when…

• A goal Take Profit or Stop Loss is reached (you get an email).
• Broker credentials fail — reconnect the broker and reassign the bot.
• A filtered news event is in its window (auto-resumes after).
• A configuration or system error occurs.
• Your plan is downgraded or the subscription expires (bots above the new limit pause).
• The parent of a copied bot is deleted.
• (MT5) the Expert Advisor goes silent for more than 90 seconds.

​

Signal sources

• TradingView — point an alert at the bot’s webhook URL. The alert message decides the direction; everything else about the trade is configured on the bot. Anyone with the webhook link can place trades on this bot — treat it like a password. Limit-order mode requires an entry price in the alert.
• MetaTrader — install the connector plugin, paste the webhook, and allow the URL under Tools → Options → Expert Advisors. The terminal must stay open to send.
• Telegram — sign in with your own Telegram, pick one channel, and the bot trades the messages that are unambiguously signals for its pair. Market takes the direction only; Limit places the message’s entry, stop and target on the order.
• Discord — link your Discord, add the TraderFrame bot to a server you manage, pick one channel, and the bot trades that channel’s signals under the same Market and Limit rules as Telegram. Full walkthrough: Discord signals. Discord is read by the TraderFrame bot, never by your own account. A signal group’s server usually will not take a bot: follow its announcement channel into a server of your own (Discord’s Follow), add TraderFrame there, and pick that channel.
• AI assistant (MCP) — connect Claude or another MCP-capable assistant with the bot’s MCP URL. It sends a buy or a sell and reads back what the bot did with it; it cannot change a setting. See Signal sources.
• Trade Agent — an AI agent that finds or judges entries under your caps and proposes trades for your tap. See Trade Agent.
• Copy Trader — copy an approved trader’s bot. See Copy trading.

Every incoming signal — taken or rejected — is logged in the bot’s Signals tab with its exact reason. That ledger is the answer to “why didn’t my bot trade?” A bot with a Trade Agent also has an Agent decisions tab listing every look it took.

​

Switching a bot back on

If the bot stopped in the middle of a martingale or compounding sequence, activating it asks one question: continue from the step it was on, or start fresh at step 0. The step shown is the one the next trade would take — after a winning trade the ladder is already back at 0. A stop that closed in profit (a trailing stop) is recorded as Trailed out, not as a loss.

​

Risk-management elements

• Position size (always present): pair, size (order size / initial margin / asset quantity — or lot size on forex), leverage and margin mode on crypto.
• Exit rule: Auto close (TP/SL as ROI % of committed margin; points on forex) or Follow the signal (an opposite signal closes; a same-side signal while open is rejected). Crypto adds a trailing stop: Continuous (exchange-native — Binance, Bybit, Bitget, OKX) or Steps (a ladder of “at X% → stop to Y%” rungs, max 10, works everywhere including KuCoin; each rung writes a real stop to the exchange, and the stop only ever tightens).
• Daily limits: profit cap and loss cap for the session (fixed amount or % of balance).
• Martingale: recover a loss by scaling the next trade — Auto (multiplier + max steps) or Manual (your own sizes, up to 10). Re-enter on the next signal or right after the loss. Right after the loss has a breather, Take a breath: after that many re-entries in a row (default 2) the ladder holds its step and waits for the next signal from your sources; that signal takes the next step, in whatever direction it says, and the chase resumes after it. Set it to Never chase to wait for a signal at every step, or Chase every step for the old behaviour. The overview shows “Step 3 · waiting for a signal” while it holds, and re-entries the ladder made on its own are tagged chased in the ledger. The step advances on a loss and resets on a win, whoever closed the trade: a stop loss, an opposite signal, or your own Close now all count the same. There are no exceptions: a liquidation is a loss and steps the ladder like any other. The panel simulates the worst case and warns at the step your balance can’t fund.
• Compounding: reinvest a share of profit while winning; one loss returns to base size. Independent of martingale — they can run together.
• Filters: pause around news events (pick impact levels and a quiet window), forex spread guard, per-order fee accounting.
• Schedule: trading days and an hours window (entered in your timezone, stored as UTC).

​

The router (Route 1 / Route 2)

The router splits one martingale or compounding ladder across two broker accounts of the same market type. Route 1 takes the early rungs — it’s the feeder and loses by design. Route 2 takes the recovery rungs — it’s the product. Route 2’s step cap follows the ladder automatically; you only choose where Route 1 hands over and whether Route 2 continues the step count or resets.

​

Trades

• A trade is pending (order sent) → open → closed, or failed (failed trades never consume a credit or touch P&L).
• P&L is net of fees and verified against the exchange’s own settled numbers shortly after close — a figure can adjust slightly within the first hour, and the later number is the correct one.
• A trailing stop that fires is recorded as trailing stop, not stop loss — it’s usually a win.
• 1 trade credit = 1 opened trade, limited per plan per month.

​

Closing a position by hand

Close now on an open position opens a sheet that prices the exit before anything is sent. It shows the estimated result, the closing fee and the net after fees in the venue’s own currency, the entry and the live price with its age, and the size in both units (coin and notional, lots and units, or contracts and dollars per point). It also names the take profit, stop loss or trailing ladder it will cancel with the position. The quote refreshes every 10 seconds; past 30 seconds it is flagged stale. Close at market sends the order; Keep position or swiping the sheet down on a phone leaves everything as it was. The final P&L is whatever the venue fills at, and the settled row shows that figure, not the estimate. A close by hand counts like any other close: a loss steps the martingale ladder and a win feeds compounding.

​

Deleting

A bot with open trades can’t be deleted — close them first. Deleting pauses any copies of the bot and notifies your copiers (you can attach a custom message).