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:
- Navigate to Trading Bots
- Click on your bot's card
- 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
| Metric | Description | Good Value |
|---|---|---|
| Total PnL | Cumulative profit/loss | Positive |
| ROI % | Return on investment | Above 0% |
| Win Rate | Profitable trades / Total trades | Above 50% |
| Total Trades | Number of completed trades | Varies |
| Avg Win | Average profit per winning trade | Higher than Avg Loss |
| Avg Loss | Average loss per losing trade | Lower than Avg Win |
| Profit Factor | Gross profit / Gross loss | Above 1.5 |
| Max Drawdown | Largest peak-to-trough decline | Below 20% |
| Sharpe Ratio | Risk-adjusted return | Above 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:
| Period | Use Case |
|---|---|
| Today | Current session performance |
| This Week | Current week-to-date |
| This Month | Current month-to-date |
| Last 7 Days | Rolling 7-day window |
| Last 30 Days | Rolling 30-day window |
| Last 90 Days | Rolling 90-day window |
| Year to Date | YTD performance |
| All Time | Total lifetime performance |
| Custom Range | Specify 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:
- Navigate to bot dashboard
- Click Spin History tab
- Browse or search spins
Spin Details
Each spin shows:
| Field | Description |
|---|---|
| Timestamp | When spin executed |
| Duration | Execution time (ms) |
| Status | Success, Error, or Timeout |
| Signals | Trade signals generated |
| Logs | Strategy output messages |
Spin Statuses
| Status | Icon | Meaning |
|---|---|---|
| Success | Green | Completed normally |
| No Signal | Gray | No trade generated |
| Signal | Blue | Trade signal created |
| Error | Red | Execution failed |
| Timeout | Orange | Exceeded 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 informationTRADE- Trade executionWARN- WarningsERROR- Errors
Trade History
Viewing Trades
Access completed trades:
- Navigate to bot dashboard
- Click Trade History tab
- View all executed trades
Trade Details
Each trade shows:
| Field | Description |
|---|---|
| Symbol | Trading pair |
| Side | Long or Short |
| Entry Price | Position open price |
| Exit Price | Position close price |
| Size | Position size |
| PnL | Profit or loss |
| PnL % | Percentage return |
| Duration | How long held |
| Reason | Entry/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:
- Click Export button
- Choose format (CSV, JSON)
- Select date range
- Download file
Real-Time Monitoring
Live Position
If bot has an open position:
| Field | Description |
|---|---|
| Side | Long or Short |
| Entry | Average entry price |
| Current | Live market price |
| Size | Position size |
| Unrealized PnL | Current profit/loss |
| Stop Loss | SL price if set |
| Take Profit | TP 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:
| Event | Description |
|---|---|
| Trade Executed | When bot opens/closes position |
| Stop Loss Hit | When SL triggers |
| Take Profit Hit | When TP triggers |
| Bot Error | When spin fails |
| Drawdown Alert | When drawdown exceeds threshold |
Notification Channels
Receive alerts via:
- Dashboard - In-app notifications
- Email - Email alerts
- Telegram - Instant messages
Configuring Alerts
- Go to Settings → Notifications
- Connect notification channels
- Enable desired alert types
- 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:
| Metric | Description | Alert Level |
|---|---|---|
| Current Exposure | Percentage of capital at risk | Above 80% |
| Daily Loss Used | Amount of daily loss limit consumed | Above 75% |
| Consecutive Losses | Current losing streak | Above 3 |
| Risk Score | Overall risk rating (1-10) | Above 7 |
Risk Levels
| Level | Score | Description | Action |
|---|---|---|---|
| Low | 1-2 | Conservative, minimal risk | Continue monitoring |
| Moderate | 3-4 | Balanced risk/reward | Monitor closely |
| High | 5-7 | Aggressive trading | Consider reducing exposure |
| Extreme | 8-10 | Very high risk | Immediate action required |
New: Access detailed risk metrics via the
/api/tradedroid/bots/[id]/riskendpoint.
Comparing Bots
If running multiple bots:
| Metric | Bot A | Bot B | Better |
|---|---|---|---|
| ROI | 15% | 12% | Bot A |
| Win Rate | 55% | 62% | Bot B |
| Max DD | 12% | 8% | Bot B |
| Sharpe | 1.2 | 1.5 | Bot B |
| Risk Score | 4.5 | 3.2 | Bot B |
Consider:
- Risk-adjusted returns (Sharpe ratio)
- Drawdown tolerance
- Consistency over time
- Risk score and exposure levels
Next Steps
- Configure Bot - Optimize settings
- Explore Strategies - Try new strategies
- Backtesting - Test changes before applying