Monitoring Trading Bots

Learn how to track your Trading Bot's performance, analyze results, and optimize your trading.

Bot Dashboard

Access your bot's dashboard:

  1. Navigate to Trading Bots
  2. Click on your bot's card
  3. View the detailed dashboard

Dashboard Overview

The bot dashboard displays:

  • Status indicator - Current bot state
  • Performance metrics - Key statistics
  • Recent activity - Latest spins and trades
  • Quick actions - Pause, configure, delete

Performance Metrics

Key Statistics

MetricDescriptionGood Value
Total PnLCumulative profit/lossPositive
ROI %Return on investmentAbove 0%
Win RateProfitable trades / Total tradesAbove 50%
Total TradesNumber of completed tradesVaries
Avg WinAverage profit per winning tradeHigher than Avg Loss
Avg LossAverage loss per losing tradeLower than Avg Win
Profit FactorGross profit / Gross lossAbove 1.5
Max DrawdownLargest peak-to-trough declineBelow 20%
Sharpe RatioRisk-adjusted returnAbove 1.0

New: Enhanced analytics now include Sharpe Ratio and detailed risk metrics accessible via the Analytics API.

Understanding Metrics

Win Rate

Win Rate = Winning Trades / Total Trades × 100

Example: 60 wins / 100 trades = 60% win rate

Interpretation:

  • Above 60%: Excellent
  • 50-60%: Good
  • 40-50%: Acceptable with good R:R
  • Below 40%: Review strategy

Profit Factor

Profit Factor = Gross Profit / Gross Loss

Example: $5,000 profit / $2,500 loss = 2.0 profit factor

Interpretation:

  • Above 2.0: Excellent
  • 1.5-2.0: Good
  • 1.0-1.5: Marginal
  • Below 1.0: Losing money

Maximum Drawdown

Max Drawdown = (Peak - Trough) / Peak × 100

Example: ($10,000 - $8,000) / $10,000 = 20% drawdown

Interpretation:

  • Below 10%: Conservative
  • 10-20%: Moderate
  • 20-30%: Aggressive
  • Above 30%: High risk

Period Selection

View metrics for different time periods:

PeriodUse Case
TodayCurrent session performance
This WeekCurrent week-to-date
This MonthCurrent month-to-date
Last 7 DaysRolling 7-day window
Last 30 DaysRolling 30-day window
Last 90 DaysRolling 90-day window
Year to DateYTD performance
All TimeTotal lifetime performance
Custom RangeSpecify exact start/end dates

New: You can now select custom date ranges and compare performance across multiple periods.

Spin History

Viewing Spin Logs

Access detailed spin information:

  1. Navigate to bot dashboard
  2. Click Spin History tab
  3. Browse or search spins

Spin Details

Each spin shows:

FieldDescription
TimestampWhen spin executed
DurationExecution time (ms)
StatusSuccess, Error, or Timeout
SignalsTrade signals generated
LogsStrategy output messages

Spin Statuses

StatusIconMeaning
SuccessGreenCompleted normally
No SignalGrayNo trade generated
SignalBlueTrade signal created
ErrorRedExecution failed
TimeoutOrangeExceeded time limit

Log Messages

Strategy logs help debug behavior:

// Example log output
[INFO] Strategy tick: RSI=28.5, Price=50000
[INFO] Entry signal: RSI oversold
[TRADE] BUY 0.1 BTC @ $50,000

Log levels:

  • INFO - General information
  • TRADE - Trade execution
  • WARN - Warnings
  • ERROR - Errors

Trade History

Viewing Trades

Access completed trades:

  1. Navigate to bot dashboard
  2. Click Trade History tab
  3. View all executed trades

Trade Details

Each trade shows:

FieldDescription
SymbolTrading pair
SideLong or Short
Entry PricePosition open price
Exit PricePosition close price
SizePosition size
PnLProfit or loss
PnL %Percentage return
DurationHow long held
ReasonEntry/exit reason

Filtering Trades

Filter trade history by:

  • Date range - Specific time period
  • Side - Long or short only
  • Result - Winners or losers
  • Symbol - Specific trading pair

Exporting Trades

Export trade data for analysis:

  1. Click Export button
  2. Choose format (CSV, JSON)
  3. Select date range
  4. Download file

Real-Time Monitoring

Live Position

If bot has an open position:

FieldDescription
SideLong or Short
EntryAverage entry price
CurrentLive market price
SizePosition size
Unrealized PnLCurrent profit/loss
Stop LossSL price if set
Take ProfitTP price if set

Live Indicators

View current indicator values:

  • RSI, MACD, ADX readings
  • Moving average values
  • Bollinger Band levels
  • Custom indicator values

Activity Feed

Real-time updates:

  • Spin executions
  • Trade signals
  • Order fills
  • Errors/warnings

Alerts & Notifications

Setting Up Alerts

Configure notifications for:

EventDescription
Trade ExecutedWhen bot opens/closes position
Stop Loss HitWhen SL triggers
Take Profit HitWhen TP triggers
Bot ErrorWhen spin fails
Drawdown AlertWhen drawdown exceeds threshold

Notification Channels

Receive alerts via:

  • Dashboard - In-app notifications
  • Email - Email alerts
  • Telegram - Instant messages

Configuring Alerts

  1. Go to Settings → Notifications
  2. Connect notification channels
  3. Enable desired alert types
  4. Set thresholds (e.g., drawdown %)

Performance Analysis

Equity Curve

Visualize your bot's performance over time:

  • Line chart showing balance progression
  • Drawdown overlay showing decline periods
  • Trade markers showing entry/exit points
  • Interactive tooltips with detailed trade information
  • Zoom and pan for detailed analysis

Enhanced: The equity curve now includes interactive features and real-time updates via the Analytics API endpoint.

Trade Distribution

Analyze trade outcomes:

  • Win/Loss pie chart
  • PnL histogram
  • Trade duration distribution

Time Analysis

Performance by time:

  • Best/worst hours
  • Best/worst days
  • Monthly performance breakdown

Troubleshooting Performance

Low Win Rate

Possible causes:

  • Strategy not suited for current market
  • Parameters need optimization
  • Too many false signals

Solutions:

  • Backtest on recent data
  • Adjust indicator thresholds
  • Add confirmation filters

High Drawdown

Possible causes:

  • Position size too large
  • Stop loss too wide or missing
  • Excessive leverage

Solutions:

  • Reduce position size
  • Tighten stop loss
  • Lower leverage

Few Trades

Possible causes:

  • Parameters too restrictive
  • Timeframe too high
  • Market conditions not suitable

Solutions:

  • Loosen entry conditions
  • Use lower timeframe
  • Wait for market regime change

Execution Errors

Possible causes:

  • Exchange API issues
  • Insufficient balance
  • Invalid parameters

Solutions:

  • Check exchange connection
  • Ensure adequate balance
  • Review bot configuration

Best Practices

Daily Monitoring

  • Check bot status
  • Review any errors
  • Verify open positions

Weekly Review

  • Analyze win rate and PnL
  • Compare to benchmark
  • Identify patterns

Monthly Analysis

  • Calculate monthly returns
  • Review drawdown periods
  • Consider parameter adjustments

Quarterly Assessment

  • Evaluate strategy effectiveness
  • Compare to alternative strategies
  • Plan optimizations

Risk Metrics Dashboard

Real-Time Risk Monitoring

Monitor your bot's risk exposure:

MetricDescriptionAlert Level
Current ExposurePercentage of capital at riskAbove 80%
Daily Loss UsedAmount of daily loss limit consumedAbove 75%
Consecutive LossesCurrent losing streakAbove 3
Risk ScoreOverall risk rating (1-10)Above 7

Risk Levels

LevelScoreDescriptionAction
Low1-2Conservative, minimal riskContinue monitoring
Moderate3-4Balanced risk/rewardMonitor closely
High5-7Aggressive tradingConsider reducing exposure
Extreme8-10Very high riskImmediate action required

New: Access detailed risk metrics via the /api/tradedroid/bots/[id]/risk endpoint.

Comparing Bots

If running multiple bots:

MetricBot ABot BBetter
ROI15%12%Bot A
Win Rate55%62%Bot B
Max DD12%8%Bot B
Sharpe1.21.5Bot B
Risk Score4.53.2Bot B

Consider:

  • Risk-adjusted returns (Sharpe ratio)
  • Drawdown tolerance
  • Consistency over time
  • Risk score and exposure levels

Next Steps