Bots - TraderFrame — User Guide

Overview

Bots are the core of TraderFrame. Each bot connects a signal provider to a broker account and executes trades automatically whenever a signal is received. You can run multiple bots at the same time across different brokers and signal sources. URLs:

/bot — All Bots page
/create-bot?botId=... — Bot creation and configuration page
/bot/[id] — Individual bot detail page

All Bots Page (`/bot`)

Bot Performance Overview

The top section shows aggregated performance across all your bots:

Element	Description
Net Cumulative P&L	Total profit/loss across all bots with % change, and a line chart over time
Total Trades	Number of trades placed across all bots
Total Copiers	How many users are copying your bots
Active Copiers	Copiers currently active
Tip by Copiers	Tips received from copiers
Total Gross P&L By Copiers	P&L generated by your copiers
Pending Approval	Copy requests waiting for your approval
Lowest Month	Your worst performing month and its P&L
Best Bot	Your highest earning bot
Worst Bot	Your lowest earning bot

Filters at the top-right let you view by specific bot or time period (Lifetime, monthly, etc.).

Your Total Bots

Total Bots summary cards and Active Bots table

Four summary cards show your bot counts at a glance:

Card	Description
Total Bots	All bots you have created
Active Bots	Bots currently running (shown as X of Y Bots)
Paused Bots	Bots that are paused
Drafted Bots	Bots still being configured

Active Bots Table

Below the summary cards, the Active Bots table lists all bots with:

Column	Description
Bot Name	Name of the bot
Signal Provider	Logo of the connected signal provider
Connected Broker	Broker logo and name
No of Trades	Total trades this bot has placed
Win Rate	Win percentage (green = good)
Created on	Date and time the bot was created
Status	Active, Pause, Draft, etc.
No of Copies	How many users are copying this bot
Active Copiers	Currently active copiers
Actions (⋯)	View, edit, or delete the bot

Two dropdowns at the top-right filter the table by P&L and Status.

Creating a Bot

Bots are created from the Create Bot flow, accessible via:

The ”+ Create Bot” button in the sidebar
The ”+ Create New Bot” button on the All Bots page
The “Create a new Bot” card on the Dashboard

Full Bot Creation Flow

Click "+ Create Bot"
        │
        ▼
  Backend creates a new bot record (status: draft)
        │
        ▼
  Redirected to /create-bot?botId=[id]
        │
        ▼
  Visual flow diagram appears with 3 dashed nodes:
  [Signal Provider] ─── [Bot] ─── [Broker]
        │
        ├── Step 1: Click Signal Provider node → select and configure provider
        │
        ├── Step 2: Click Broker node → connect a broker account
        │             (only clickable after signal provider is connected)
        │
        ├── Step 3 (optional): Add a Router via toolbar
        │
        ├── Step 4: Configure Bot Settings via toolbar
        │
        └── Step 5: Click "Activate" in the header → bot goes live

Bot Flow Diagram (Visual Builder)

Empty State

When a new bot is created, the page shows three dashed empty nodes connected by a line:

[+ Connect to your Signal Provider] ── [Bot Icon] ── [+ Connect to your broker]

The broker node is faded and disabled until a signal provider is connected first. The header shows: balance, Trades / Win / Draw / Loss counters (all 0), bot name, and the Activate and View Bot buttons.

Connected State

Create Bot page — signal provider and broker connected

Once connected, nodes change from dashed to solid orange borders:

[TradingView] ──+── [Bot Icon] ── [Deriv — Demo 10,000 USD]
      │
[+ Add another Signal Provider]

A banner at the bottom alerts you if configuration is still incomplete:

“Uh-huh, your configuration to creating a bot is incomplete — To setup your bot for trading on ATS you must complete the process of configuring the bot. Complete the process to continue.” Configure Bot →

Button	Enabled When	Action
Add a New Signal Provider	Signal provider already connected	Adds another provider to the same bot
Create a New Bot	Broker is connected	Creates a fresh bot
Configure Bot Settings	Broker is connected	Opens the Bot Settings sidebar
Add a Router	Bot is not in draft/in_progress	Opens the Router sidebar

Node Hover Actions

Hovering over any connected node shows a small action toolbar above it: Signal Provider node:

+ — Add another signal provider
Edit (pen) — Edit provider configuration

Bot node:

Settings (gear) — Open Bot Settings
View (eye) — Go to bot detail page
Activate / Pause (rocket / pause) — Toggle bot status

Broker node:

Settings (gear) — Change broker
Unlink (link) — Remove broker from this bot

Click Configure Bot Settings in the toolbar to open the settings sidebar. It has 4 steps — the fields vary by broker type (Binary, Crypto, or Forex).

Step 1 — Trading Settings

Field	Options	Description
Bot Name	Free text	Name to identify your bot
Signal Management	Market / Next Minute	Market — execute signal immediately. Next Minute — wait for next candle close
Money Management	Fixed Amount / % of Total Balance	How stake is calculated per trade
Fixed Amount	Number (e.g. 1 USD)	Amount per trade when Fixed is selected
% of Total Balance	Number (e.g. 1%)	Percentage of balance when % is selected
Duration	Seconds (e.g. 60)	Trade expiry time — Binary brokers only

The fields shown in Step 1 differ slightly between Binary, Crypto, and Forex broker types. For example, Forex bots use lot size instead of a currency amount, and the duration field is not shown for Crypto.

Step 2 — Goal Settings

Field	Options	Description
Stop after Profit	Fixed amount or %	Bot pauses automatically when this profit target is hit
Stop after Loss	Fixed amount or %	Bot pauses automatically when this loss limit is hit
Compounding	On / Off	Reinvests profits to grow the stake over time

Step 3 — Risk Management

Field	Options	Description
Martingale	On / Off	Multiplies stake after a loss to recover losses faster
Auto Martingale	Multiplier + Max Steps	Automatically applies a multiplier (e.g. 2.5x) on each consecutive loss
Manual Martingale	Up to 10 steps	Set a custom stake amount for each consecutive loss step
Max Consecutive Losses	Number	Bot pauses after this many losses in a row

Martingale can rapidly deplete your account during a losing streak. Only enable it if you fully understand the risk.

Step 4 — Filters

Filter	Description
Payout Filter	Skip trades when payout is below this % (Binary only)
News Filter	Pause before/after High, Medium, or Low impact news events
Pause Duration	How many minutes before/after a news event to pause trading

Click Next to move between steps and Save on the last step to apply all settings.

Signal Provider Configuration

When you select a signal provider from the flow diagram, a dedicated side panel opens:

TradingView

A unique webhook URL is generated for this bot.
Copy the URL → paste it into your TradingView alert's Webhook URL field.
Set the alert message to match the required signal format.
Click Connect → provider is linked to the bot.

MetaTrader (MT5 / MT4)

An EA Token is displayed.
Install the TraderFrame EA in your MetaTrader platform.
Paste the EA Token into the EA's settings.
The EA will automatically forward signals to this bot.

Copy Trade

Select a trader from the leaderboard.
The bot mirrors all signals from that trader's bot.

Bot Detail Page (`/bot/[id]`)

Click any bot name in the Active Bots table, or click View Bot from the create-bot header, to open the detail page. The page header shows:

Broker account balance
Total Trades / Win / Draw / Loss counts for the current session
Bot name
Pause / Activate button to toggle status
Bot Builder button to go back to the flow diagram

Three tabs organize the content:

Tab 1 — Bot Overview

Bot Summary

A stats bar at the top of the overview:

Metric	Description
Start Time	When the current session started
Runtime	How long the bot has been running (e.g. 2d 17h 13m)
Win Rate	% of trades that were profitable
Max Winning Streak	Longest consecutive wins in this session
Max Loss Streak	Longest consecutive losses in this session
Realized P&L	Total profit/loss for this session (green = profit, red = loss)

Connection

Field	Value
Broker	Broker logo and name (e.g. Deriv)
Signal Platform	Provider logo and name (e.g. TradingView)

Signal Management

Field	Value
Execution	Immediately (Market) or Next Minute

Filter

Field	Value
Skip Pairs With a Payout Less Than	Minimum payout % (Binary only)
News	Impact levels being filtered (e.g. High, Medium)
Pause Duration	Minutes paused around news events

Money Management

Field	Value
Mode	Fixed Amount, % of Total Balance, etc.
Amount	Stake per trade (e.g. 5 USD)
Duration	Expiry time (e.g. 60 Sec)

Goals

Field	Value
Stop after Profit	Target profit — bot pauses when reached (e.g. 500 USD)
Stop after Loss	Max loss — bot pauses when reached (e.g. 200 USD)

Trading Schedule

Scheduled date and time the bot is set to trade (shows - if not configured).

Compounding (if enabled)

Field	Description
Step	Current compounding step number
Current Value	Current stake amount
Turnover	% of turnover needed to advance to the next step
Next	Stake amount at the next step

Martingale (if enabled)

Field	Description
Step	Current Martingale step
Current Value	Current inflated stake
Multiply by	The multiplier applied after each loss (e.g. 2.5x)
Next	Next stake if the current trade loses

Market Events

A live list of upcoming economic news events (next few hours) with time, currency pair, headline, and impact rating (1–3 stars). A “View all Market Events →” link opens the full events list.

Bot Performance Chart

A bar chart showing P&L per hour/day over the selected period (24H / 7D / 30D). Each bar is orange for profit days.

Tab 2 — Successful Trades

The Successful Trades tab is split into two sections: Today’s Summary — same stats bar as Bot Overview (Start Time, Runtime, Win Rate, Max Winning/Loss Streak, Realized P&L) for today only. Today’s Trades table — every trade placed today:

Column	Description
Symbol	Trading pair (e.g. EUR/USD)
Type	Open call / Close call / Open put / Close put
Signal	Direction arrow (up = call, down = put)
Date & Time	Exact timestamp of the trade
Price	Entry price
Amount	Stake amount (e.g. 10 USD)
Duration	Trade expiry (e.g. 60 sec)
Difference	Price difference between open and close
Mart. Step	Martingale step at the time of the trade (e.g. 0/8)
Comp. Step	Compounding step at the time of the trade (e.g. 0/2)
Realize P&L	Profit or loss on this trade (green = win, red = loss)

Previous Trades — same table for all historical trades. A Date Range filter lets you narrow by date.

The columns shown in the trades table differ slightly between Binary, Crypto, and Forex broker types. For example, Forex trades show lot size and pip difference instead of duration and payout.

Tab 3 — Incoming Signals

A log of every signal received by the bot showing:

Timestamp
Asset / trading pair
Signal direction
Whether the signal was executed or skipped (and the reason if skipped — e.g. payout filter, news filter, max trades reached)

Bot Status Reference

Status	Meaning
Draft	Newly created, not yet configured
In Progress	Being set up — signal provider or broker not yet connected
Ready	Fully configured, not yet activated
Active	Running and executing signals
Pause	Temporarily paused (hit stop loss/profit, or manually paused)

Status Flow

Created → Draft
        │
        │ Signal provider connected
        ▼
    In Progress
        │
        │ Broker connected + settings saved
        ▼
      Ready
        │
        │ Click Activate
        ▼
      Active ──── Click Pause ────▶ Pause
                                      │
                                      └── Click Activate → Active

Resume Session

When activating a bot that previously had a trading session, a Resume modal appears:

Resume — continues from the previous session’s state (Martingale step, compounding progress preserved)

Leaving an Incomplete Bot

If you try to navigate away from the create-bot page while the bot is still in draft or in_progress status:

"Configuration is Still Incomplete"
"Are you sure you want to stop the steps to complete
 the configuration of the bot?"

  [ Leave ]   [ Continue ]

Leave — navigates away without saving
Continue — stays on the page to keep configuring

Deleting a Bot

From the Active Bots table, click the ⋯ menu → Delete. A confirmation modal appears. Confirming permanently removes the bot.

Deleting a bot does not close any open positions in your broker. You must close those manually in your broker platform.

Documentation Index

​Overview

​All Bots Page (/bot)

​Bot Performance Overview

​Your Total Bots

​Active Bots Table

​Creating a Bot

​Full Bot Creation Flow

​Bot Flow Diagram (Visual Builder)

​Empty State

​Connected State

​Toolbar Actions

​Node Hover Actions

​Bot Settings (4-Step Sidebar)

​Step 1 — Trading Settings

​Step 2 — Goal Settings

​Step 3 — Risk Management

​Step 4 — Filters

​Signal Provider Configuration

​TradingView

​MetaTrader (MT5 / MT4)

​Copy Trade

​Bot Detail Page (/bot/[id])

​Tab 1 — Bot Overview

​Bot Summary

​Connection

​Signal Management

​Filter

​Money Management

​Goals

​Trading Schedule

​Compounding (if enabled)

​Martingale (if enabled)

​Market Events

​Bot Performance Chart

​Tab 2 — Successful Trades

​Tab 3 — Incoming Signals

​Bot Status Reference

​Status Flow

​Resume Session

​Leaving an Incomplete Bot

​Deleting a Bot

Overview

All Bots Page (`/bot`)

Bot Performance Overview

Your Total Bots

Active Bots Table

Creating a Bot

Full Bot Creation Flow

Bot Flow Diagram (Visual Builder)

Empty State

Connected State

Toolbar Actions

Node Hover Actions

Bot Settings (4-Step Sidebar)

Step 1 — Trading Settings

Step 2 — Goal Settings

Step 3 — Risk Management

Step 4 — Filters

Signal Provider Configuration

TradingView

MetaTrader (MT5 / MT4)

Copy Trade

Bot Detail Page (`/bot/[id]`)

Tab 1 — Bot Overview

Bot Summary

Connection

Signal Management

Filter

Money Management

Goals

Trading Schedule

Compounding (if enabled)

Martingale (if enabled)

Market Events

Bot Performance Chart

Tab 2 — Successful Trades

Tab 3 — Incoming Signals

Bot Status Reference

Status Flow

Resume Session

Leaving an Incomplete Bot

Deleting a Bot