quantumbotx/docs/strategy_switching_guide.md

QuantumBotX Automatic Strategy Switching Guide

Overview

The Automatic Strategy Switching system is an advanced feature of QuantumBotX that automatically evaluates and switches between different strategy/instrument combinations based on their performance and current market conditions. This ensures your trading bots are always using the most profitable and suitable strategies for the current market environment.

How It Works

1. Performance Evaluation

The system continuously evaluates all configured strategy/instrument combinations using:

• Profitability Score: Based on net profit, win rate, and profit factor
• Risk Control Score: Based on maximum drawdown and risk/reward ratio
• Consistency Score: Based on trade frequency and profit consistency
• Activity Level Score: Based on the number of trades generated
• Market Fit Score: Based on strategy compatibility with instrument type and market conditions

2. Market Condition Detection

The system analyzes each instrument to determine:

• Market Condition: Trending vs. ranging markets
• Volatility Regime: High vs. low volatility periods
• Session Status: Active trading sessions

3. Automatic Switching

Based on the composite performance scores and market conditions, the system:

• Switches to the highest-performing strategy/instrument combination
• Respects cooldown periods to prevent excessive switching
• Maintains a history of all switches for review

Dashboard Features

Strategy Switcher Dashboard

Access the dashboard through the "Strategy Switcher" link in the sidebar.

Current Status

• Active Strategy: The currently active strategy
• Active Symbol: The currently active trading instrument
• Last Switch: Timestamp of the last strategy switch
• Cooldown Status: Indicates if switching is currently in cooldown

Strategy Performance Rankings

Shows all strategy/instrument combinations ranked by their composite performance scores:

• Rank: Position in the rankings
• Strategy/Symbol: The strategy and instrument combination
• Composite Score: Overall performance score (0-1)
• Profitability: Profitability component score
• Risk Control: Risk management component score
• Market Fit: Compatibility with market conditions

Recent Strategy Switches

Displays a history of recent strategy switches with details:

• Action: Type of switch (Initial setup or strategy switch)
• From/To: Previous and new strategy/instrument combinations
• Reason: Reason for the switch
• Score: Performance score of the new combination
• Improvement: Performance improvement from the switch

Monitored Instruments & Strategies

Lists all instruments and strategies being monitored by the system.

Trading Bot Integration

Enabling Strategy Switching

When creating or editing a trading bot, you can enable automatic strategy switching:

1. Navigate to the Trading Bots page
2. Click "Create Bot" or edit an existing bot
3. Check the "Aktifkan Automatic Strategy Switching" checkbox
4. Save the bot configuration

When enabled, the bot will automatically switch to the best-performing strategy/instrument combination as determined by the strategy switcher system.

API Endpoints

The strategy switching system provides REST API endpoints for integration:

Status Endpoints

• GET /api/strategy-switcher/status - Get current strategy switcher status
• GET /api/strategy-switcher/recent-switches - Get recent strategy switches

Evaluation Endpoints

• POST /api/strategy-switcher/evaluate - Manually trigger strategy evaluation
• POST /api/strategy-switcher/manual-trigger - Manually trigger strategy evaluation and switch

Data Endpoints

• GET /api/strategy-switcher/rankings - Get current strategy performance rankings
• GET /api/strategy-switcher/market-conditions - Get current market conditions
• GET /api/strategy-switcher/configuration - Get strategy switcher configuration

Configuration Endpoints

• GET /api/strategy-switcher/configuration - Get current configuration
• PUT /api/strategy-switcher/configuration - Update configuration

Configuration

Monitored Instruments

The system monitors a configurable list of instruments including:

• Indices (US500, US30, DE30, etc.)
• Forex pairs (EURUSD, GBPUSD, etc.)
• Gold (XAUUSD)
• Cryptocurrencies (BTCUSD, etc.)

Test Strategies

The system evaluates a configurable list of strategies:

• INDEX_BREAKOUT_PRO
• MA_CROSSOVER
• RSI_CROSSOVER
• TURTLE_BREAKOUT
• QUANTUMBOTX_HYBRID

Settings

• Switching Cooldown: 24 hours (minimum time between switches)
• Performance Evaluation Period: 500 bars
• Minimum Performance Score: 0.6 (minimum score to consider switching)
• Switch Threshold: 0.1 (minimum score improvement to trigger switch)

Best Practices

For Optimal Performance

1. Diversify Instruments: Monitor a variety of instruments to find the best opportunities
2. Regular Evaluation: The system automatically evaluates performance, but you can manually trigger evaluations
3. Review Switches: Regularly review the switch history to understand system behavior
4. Adjust Settings: Fine-tune configuration parameters based on your trading preferences

Monitoring Recommendations

1. Check Dashboard Regularly: Review the strategy switcher dashboard for insights
2. Review Notifications: Pay attention to strategy switch notifications
3. Analyze Performance: Compare manual vs. automatic strategy selection performance
4. Adjust Parameters: Modify strategy parameters based on market conditions

Troubleshooting

Common Issues

1. No Switches Occurring: Check if all monitored instruments have data files
2. Poor Performance: Review strategy parameters and market conditions
3. Frequent Switching: Increase the switching cooldown period or switch threshold

Data Requirements

The system requires historical data files in the lab/backtest_data directory:

• Format: CSV files with time, open, high, low, close, volume columns
• Naming: {SYMBOL}_H1_data.csv (e.g., EURUSD_H1_data.csv)
• Content: Sufficient historical data for backtesting (minimum 500 bars)

Conclusion

The Automatic Strategy Switching system provides a powerful way to optimize your trading performance by automatically selecting the best strategy/instrument combinations based on real-time performance analysis and market conditions. By enabling this feature on your trading bots, you can ensure they're always using the most profitable approaches without manual intervention.