Signal Bot User Guide

The Signal Bot executes trades based on trading signals from external providers. Rather than analyzing markets directly, it listens for signals from sources you trust -- such as webhook endpoints, API integrations, Telegram channels, or Discord servers -- and either executes trades automatically or notifies you to act manually.

This guide covers everything you need to configure, manage, and get the most out of the Signal Bot.

What Is a Signal Bot?

A Signal Bot connects to one or more external signal providers and acts on the trading signals they produce. Signal providers are services or individuals that publish trade recommendations. These recommendations include a direction (BUY, SELL, or CLOSE), a target asset, price levels, and a confidence score.

You choose which providers to follow and whether the bot should auto-trade on your behalf or simply alert you so you can decide manually. The bot evaluates every incoming signal against your risk settings before taking action.

Key capabilities:

Receive signals from multiple provider types (Telegram, Discord, webhook, API, email, custom)
Auto-execute trades or receive notifications for manual decision-making
Enforce risk controls including stop-loss, take-profit, and position size limits
Track provider accuracy and performance over time
Operate in paper-trading mode for risk-free testing or in live mode against your exchange account

How It Works

Signal providers send trading signals. Each signal contains a direction (BUY, SELL, or CLOSE), the target asset symbol, and optionally an entry price, stop-loss, take-profit, and confidence level.
The bot validates the signal. It checks that the signal includes a valid action and symbol, and that the symbol is in your list of allowed trading pairs.
The bot evaluates the signal against your risk settings. It checks whether you have reached your maximum number of open positions, calculates the correct position size based on your configuration (fixed amount or percentage of balance), and determines stop-loss and take-profit levels.
If auto-trade is enabled, the bot executes the trade. For BUY signals, it opens a new position. For SELL or CLOSE signals, it finds and closes the matching open position. In paper-trading mode, trades are simulated with a 0.1% fee. In live mode, the bot places a real market order through your connected exchange.
If auto-trade is disabled, you receive a notification. You can then review the signal details and decide whether to act on it manually.
All signals and their outcomes are recorded. You can review execution history, track profit and loss per signal, and compare provider performance.

Creating a Signal Bot

Step 1: Navigate to the Signal Bot Page

Open the Signal Bot section from the main navigation. The dashboard header displays the bot title, a description ("Manage your crypto trading signals and automate your trades"), and a Start/Pause button to control the bot.

Step 2: Configure Your Signal Bot

Before starting the bot, configure the foundational settings in the Settings tab:

Bot Name -- Give your bot a descriptive name (default: "My Signal Bot").
Description -- Add a short description of the bot's purpose.
Default Exchange -- Select the exchange your bot will trade on (e.g., Binance).
Default Trading Pair -- Choose a default pair such as BTC/USDT, ETH/USDT, BNB/USDT, or ADA/USDT.
Position Size -- Set a default position size, either as a percentage of your portfolio or as a fixed dollar amount.
Maximum Open Positions -- Limit how many positions the bot can hold at once (default: 5).
Maximum Daily Trades -- Cap the number of trades per day (default: 10).

Step 3: Add Signal Providers

Use the Providers tab to add one or more signal providers. See the next section for details.

Step 4: Start the Bot

Click the Start Bot button in the dashboard header. The status cards at the top of the page will update to show the bot is active and monitoring signals.

Adding Signal Providers

Signal providers are the sources of trading signals. You can add multiple providers and manage them independently.

Provider Types

The Add Provider modal supports the following provider types:

Type	Description
Telegram Channel	Forward signals from a Telegram channel or group. The bot engine includes a built-in parser that recognizes common Telegram signal formats such as `BUY BTCUSDT @ 45000` or `LONG BTC Entry: 45000 SL: 44000 TP: 47000`.
Discord Server	Receive signals from a Discord server or channel.
API Provider	Connect to an external signal API. Provide the API key or access token to authenticate.
Webhook	Receive signals via HTTP POST to a unique webhook URL. External services can push signals to this endpoint.
Email Alerts	Receive signal alerts via email integration.
Custom Integration	Configure a custom signal source for specialized use cases.

Adding a Provider

In the Providers tab, click Add Provider.
Fill in the required fields:
- Provider Name (required) -- A recognizable name for this provider.
- Provider Type (required) -- Select from the list above.
Configure connection settings:
- API Key / Token -- Enter the provider's API key or access token if applicable.
- Webhook URL -- Enter the webhook endpoint URL if applicable.
Optionally fill in performance metrics:
- Success Rate (%) -- The provider's historical success rate.
- Average Return (%) -- Average return per signal.
- Max Drawdown (%) -- The provider's worst drawdown.
- Subscription Fee ($) -- The cost to use this provider.
Set the Risk Level for this provider (Low, Medium, or High).
Toggle available features: Real-time Signals, Backtesting, Risk Management, Custom Alerts, Portfolio Tracking, Social Trading.
Add descriptive Tags to organize your providers.
Set the Active Status toggle to enable or disable the provider immediately.
Click Add Provider to save.

Managing Providers

Each provider card in the Providers tab displays:

Accuracy -- The provider's signal accuracy percentage.
Signals -- Total number of signals sent.
Subscribers -- Number of users following this provider.
Price -- Subscription cost (or "Free").
Status -- Active or Inactive.

Available actions for each provider:

Add to Favorites / Remove Favorite -- Mark providers you rely on most.
Mute / Unmute -- Temporarily disable signal reception without removing the provider.
Contact -- Reach out to the provider.
View Details -- Open the provider details modal showing performance charts, recent signals, win rate, average return, max drawdown, Sharpe ratio, signal frequency, and more.
Follow / Subscribe -- Follow a provider or subscribe to a paid plan.

Discovering New Providers

At the bottom of the Providers tab, the Discover New Providers section lets you browse the marketplace to find top-performing signal providers that match your trading strategy.

Dashboard Overview

The Signal Bot dashboard is organized into five tabs, plus a set of status cards at the top of the page.

Status Cards

Four summary cards are always visible at the top of the dashboard:

Bot Status -- Shows whether the bot is Active (monitoring signals) or Paused (not receiving signals).
Success Rate -- The percentage of successful signals over the last 30 days, with a progress bar.
Avg. Profit -- The average profit percentage per signal.
Active Signals -- The number of signals currently being tracked.

Overview Tab

The Overview tab provides a high-level snapshot of your bot's performance and auto-trading configuration.

Performance Overview card:

A line chart showing profit and signal count over the last 30 days.
Summary metrics: Total Signals, Completed, and Stopped.

Auto-Trading Status card:

Auto-Trading toggle -- Enable or disable automatic trade execution. When enabled, the bot executes trades based on received signals according to your risk settings. When disabled, you receive notifications only.
Risk Level slider -- Adjust from 0% to 100%, labeled Conservative (below 30%), Balanced (30-70%), or Aggressive (above 70%). This controls how aggressively the bot acts on signals.
Advanced Settings button -- Opens the Advanced Auto-Trading Settings modal (see below).

Recent Signals list:

Shows the five most recent signals with provider name, asset, direction (LONG/SHORT), status (Active/Completed/Stopped), confidence percentage, profit/loss percentage, and timestamp.

Signals Tab

The Signals tab displays a detailed, filterable table of all trading signals.

Filter controls:

Search -- Search by symbol or provider name.
Status filter -- Filter by All Statuses, Active, Executed, Expired, or Stopped.
Type filter -- Filter by All Types, Buy Signals, or Sell Signals.
Apply Filters button to update results.

Signal table columns:

Provider, Symbol, Type (BUY/SELL with icon), Price, Confidence (shown as a progress bar and percentage), Risk Level (LOW/MEDIUM/HIGH), Status, P&L, Time.

Actions per signal:

View Details -- Opens a modal with full signal information including entry price, stop-loss, take-profit, volume, risk level, analysis description, and P&L.
Copy -- Copies signal details to your clipboard for sharing or reference.
Stop -- Stops an active signal (available only for signals with "active" status).

Providers Tab

See the "Adding Signal Providers" section above for full details. This tab lets you:

Search and filter providers by name or description.
Add new providers via the Add Provider button.
Manage existing providers (favorite, mute, view details, contact).
Discover new providers through the marketplace.

Settings Tab

The Settings tab contains four sections:

General Settings:

Bot Name and Description fields.

Trading Settings:

Default Exchange (Binance, OKX).
Default Trading Pair (BTC/USDT, ETH/USDT, BNB/USDT, ADA/USDT).
Default Position Size with type selector (% of Portfolio or Fixed Amount).
Maximum Open Positions.

Notification Settings:

Email Notifications -- Receive signal alerts via email.
Push Notifications -- Receive signal alerts via browser notifications.
Telegram Notifications -- Receive signal alerts via Telegram.
Discord Notifications -- Receive signal alerts via Discord.

Security Settings:

API Key Management -- Manage your exchange API keys.
Maximum Daily Trades -- Limit the number of trades per day.
Emergency Stop -- Immediately stop all trading activity.

Use Reset to Default to restore all settings to their defaults, or Save Settings to persist changes.

History Tab

The History tab provides a complete record of all signal activity.

Signal History table:

Columns: Signal (asset, provider, date), Type (LONG/SHORT), Entry Price, Status (Completed/Active/Stopped), Profit/Loss.
Filter by status: All Signals, Completed, Active, or Stopped.
Paginated view (10 signals per page) with Previous/Next navigation.
Export button to download your signal history.

Performance Analytics:

A line chart showing cumulative profit and win rate over time.
Summary cards: Average Signal Duration, Win Rate, Loss Rate, Total Profit.

Auto-Trade Settings

Auto-trading can be toggled on the Overview tab. When enabled, the bot automatically executes market orders when signals arrive, subject to your risk controls.

Basic Controls

Auto-Trading toggle -- Master switch for automatic execution. Located on the Overview tab.
Risk Level slider -- Controls overall risk tolerance from Conservative to Aggressive.

Advanced Settings

Click Advanced Settings on the Overview tab to open the configuration modal:

Position Size (%) -- The percentage of your portfolio to allocate per trade (default: 5%).
Max Concurrent Trades -- Maximum number of positions open simultaneously (default: 3).
Stop Loss (%) -- Automatic stop-loss percentage below entry price (default: 2%).
Take Profit (%) -- Automatic take-profit percentage above entry price (default: 5%).
Trailing Stop Loss -- When enabled, the stop-loss follows price upward to lock in gains.
Partial Position Closing -- When enabled, allows closing a portion of a position rather than all at once.
Reinvest Profits -- When enabled, realized profits are added back to the trading balance for compounding.

How Position Sizing Works

The bot supports two position sizing modes, configured in the Settings tab:

Fixed Amount -- Each trade uses a fixed dollar amount regardless of account balance.
Percentage of Portfolio -- Each trade uses a percentage of your current available balance. In paper-trading mode, this is calculated from your simulated balance. In live mode, it is calculated from your USDT balance on the connected exchange.

Signal-Level Risk Controls

When a signal arrives with its own stop-loss and take-profit levels, the bot can either follow them or apply your own. This behavior is controlled by the followStopLoss and followTakeProfit configuration options in the bot engine:

If the signal includes stop-loss/take-profit values and following is enabled, the bot uses the signal's levels.
If the signal does not include them, the bot falls back to your configured stop-loss and take-profit percentages.

Signal History and Performance

Tracking Signals

Every signal received by the bot is recorded with full details:

Provider name
Asset symbol and direction (LONG/SHORT)
Entry price
Stop-loss and take-profit levels
Confidence percentage
Execution status (Active, Completed, Executed, Expired, Stopped)
Realized profit or loss

Provider Performance Comparison

Use the Providers tab to compare providers side by side. Each provider card shows:

Accuracy rate -- Percentage of profitable signals.
Total signals sent -- Volume of signals over the provider's history.
Subscriber count -- Community size as a trust indicator.

The Provider Details modal expands on this with:

Performance chart showing daily results.
Win rate, average return, max drawdown, and Sharpe ratio.
Signal frequency and active duration.

Exporting Data

Click the Export button on the History tab to download your complete signal history. This is useful for external analysis, tax reporting, or auditing provider performance.

Tips

Start with notifications only before enabling auto-trade. Run the bot in notification-only mode for a period to evaluate signal quality without risking capital.
Use paper trading first. The bot supports a paper-trading mode that simulates all trades with a 0.1% fee. Use this to validate your configuration before going live.
Evaluate provider track records before following. Check the accuracy rate, total signal count, subscriber count, and performance metrics in the Provider Details modal before committing to a provider.
Set strict risk controls. Configure stop-loss and take-profit percentages, limit your maximum open positions, and set a daily trade cap to contain downside risk.
Diversify across multiple providers. Relying on a single provider concentrates risk. Add several providers and compare their performance over time.
Monitor provider reliability scores. Accuracy and win rate can change over time. Regularly review the Providers tab and mute or remove underperforming providers.
Keep position sizes small when starting. Use a conservative position size percentage (such as 2-5% of your portfolio) until you are confident in a provider's consistency.
Review the History tab regularly. Use the performance analytics charts and summary cards to track overall bot performance and identify trends.
Use the Emergency Stop when needed. If market conditions deteriorate or something seems wrong, the Emergency Stop button in the Settings tab immediately halts all trading activity.

Related Guides