FxMathQuantWebApp/USER_MANUAL.md

FxMathQuant Strategy Finder - User Manual

AI-Powered Trading Strategy Generator

---

📋 Table of Contents

1. Getting Started
2. License Activation
3. Exporting Data from MT4/MT5
4. Uploading Data
5. Configuring Strategy Generation
6. Understanding Monte Carlo Results
7. Generating Strategies
8. Viewing Results
9. Downloading Strategies
10. Troubleshooting
11. Contact Support

---

🚀 Getting Started

What is FxMathQuant?

FxMathQuant is an AI-powered trading strategy generator that uses genetic algorithms to discover profitable trading strategies from your historical price data.

System Requirements

• Web Browser: Chrome, Firefox, Safari, or Edge (latest version)
• MetaTrader: MT4 or MT5 (for data export)
• License Key: Required for access

---

🔑 License Activation

Step 1: Obtain License Key

Purchase a license from:

• Website: https://fxmath.com
• Email: fxmathsolution@gmail.com
• Telegram: https://t.me/FxMath

Step 2: Activate License

1. Open the application in your web browser
2. Enter your license key in the format: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
3. Click "Activate License"
4. Wait for validation (requires internet connection)
5. You'll be redirected to the main application

License Types

• Lifetime License: Never expires, unlimited use
• Time-Limited License: Valid for specified days (30, 90, 365, etc.)

Session Duration

• Active Session: Remains active until you logout or clear browser data
• Auto-Logout: No automatic logout (session persists)
• Manual Logout: Click the logout button in the top-right corner

---

📊 Exporting Data from MT4/MT5

Download Data Provider EA

1. Download the EA from the application:

   • MT4: FxMathQuant_DataExporter_MT4.ex4
   • MT5: FxMathQuant_DataExporter_MT5.ex5

2. Install in MetaTrader:

   • Copy to MQL4/Experts/ (MT4) or MQL5/Experts/ (MT5)
   • Restart MetaTrader
   • Find in Navigator → Expert Advisors

Export Historical Data

1. Open a chart (e.g., XAUUSD H1)
2. Drag the EA onto the chart
3. Configure settings:
   • Bars to Export: 10,000 (recommended)
   • Remove Suffix: true (removes broker suffix)
   • Export Folder: FxMathQuant
4. Click "Export to CSV" button
5. Wait for completion message
6. Find your file: MQL4/Files/FxMathQuant/XAUUSD_H1.csv

Recommended Data

Timeframe	Bars	Use Case
M15	10,000	Scalping strategies
H1	10,000	Intraday trading
H4	5,000	Swing trading
D1	3,000	Position trading

---

📤 Uploading Data

Step 1: Upload CSV File

1. Click "Browse" or drag-and-drop your CSV file
2. Select the file exported from MT4/MT5
3. Wait for parsing (10,000 bars ≈ 2-3 seconds)
4. Confirmation: "Data loaded successfully: X bars"

Supported Format

Time,Open,High,Low,Close,Tick_Volume,Spread,Real_Volume
2024-04-18 01:00:00,2361.73,2367.69,2361.37,2365.29,2325,7,0

Note: Column names can be lowercase or capitalized.

---

⚙️ Configuring Strategy Generation

Genetic Algorithm Settings

Parameter	Default	Range	Description
Population Size	100	50-500	Number of strategies per generation
Generations	50	10-200	Number of evolution cycles
Mutation Rate	0.1	0.01-0.5	Probability of random changes
Crossover Rate	0.7	0.3-0.9	Probability of combining strategies
Elite Size	5	1-20	Best strategies preserved each generation

Strategy Criteria

Criteria	Default	Description
Min Profit Factor	1.5	Minimum ratio of profit to loss
Min Win Rate	50%	Minimum percentage of winning trades
Min Total Trades	30	Minimum number of trades
Max Drawdown	30%	Maximum equity drawdown allowed

Recommended Settings

For Beginners:

• Population: 100
• Generations: 50
• Min Profit Factor: 1.5
• Min Win Rate: 50%

For Advanced Users:

• Population: 200-300
• Generations: 100-150
• Min Profit Factor: 2.0
• Min Win Rate: 55%

Monte Carlo Simulation

What is Monte Carlo Simulation?

Monte Carlo simulation is a powerful risk analysis tool that tests strategy robustness by randomly shuffling the order of trades thousands of times. This reveals whether your strategy's performance is due to genuine edge or just lucky trade sequencing.

Why Use Monte Carlo?

• Risk Assessment: Understand the range of possible outcomes
• Robustness Testing: Verify strategy works under different conditions
• Confidence Intervals: Know the probability of different results
• Risk of Ruin: Calculate probability of catastrophic losses

Settings:

Parameter	Default	Range	Description
Enable Monte Carlo	Off	On/Off	Activate Monte Carlo analysis
Iterations	1,000	100-10,000	Number of random shuffles
Risk of Ruin Threshold	20%	10-50%	Loss threshold for RoR calculation

Recommended Settings:

• Quick Analysis: 1,000 iterations (1-2 seconds)
• Standard Analysis: 5,000 iterations (3-4 seconds)
• Thorough Analysis: 10,000 iterations (6-8 seconds)

Requirements:

• Minimum 20 trades for meaningful results
• More trades = more accurate analysis
• Enable before generating strategies

How to Use:

1. Enable Monte Carlo in configuration section
2. Set iterations (1,000 recommended for start)
3. Generate strategies as normal
4. Click "🎲 MC" button on any strategy card
5. View professional modal with:
   • Equity distribution histogram
   • Risk assessment
   • Percentile analysis
   • Confidence intervals

---

📊 Understanding Monte Carlo Results

Risk Assessment Banner

The modal displays a color-coded risk assessment:

• ✅ LOW RISK (< 5% RoR): Excellent robustness, safe to trade
• ⚠️ MODERATE RISK (5-15% RoR): Acceptable, monitor closely
• ❌ HIGH RISK (> 15% RoR): High variance, reduce position size

Key Metrics Explained

Expected Return

• Average outcome across all simulations
• More reliable than single backtest result
• Positive value indicates profitable strategy

Risk of Ruin (RoR)

• Probability of losing threshold % of capital
• Lower is better (< 5% is excellent)
• Accounts for worst-case scenarios

Standard Deviation

• Measure of result variability
• Lower = more consistent
• Higher = more unpredictable

Percentiles

Percentile	Meaning	Use Case
5th	Worst 5% of outcomes	Downside risk assessment
25th	Below average	Pessimistic scenario
50th (Median)	Typical outcome	Most likely result
75th	Above average	Optimistic scenario
95th	Best 5% of outcomes	Upside potential

Confidence Intervals

• 90% Range: 90% of outcomes fall within this range
• 50% Range: 50% of outcomes fall within this range
• Narrower range = more predictable strategy

Equity Distribution Histogram

The histogram shows the distribution of final equity across all simulations:

Color Coding:

• Red bars: Worst 5% of outcomes (below 5th percentile)
• Orange bars: Below average (5th-25th percentile)
• Green bars: Typical range (25th-75th percentile)
• Teal bars: Best outcomes (above 75th percentile)

What to Look For:

• Normal distribution: Bell curve shape is ideal
• Skewed right: More upside potential
• Skewed left: More downside risk
• Wide spread: High variability (risky)
• Narrow spread: Consistent results (safer)

Interpreting Results

Excellent Strategy:

• Risk of Ruin < 5%
• 5th percentile is positive
• Narrow confidence intervals
• Normal distribution shape

Good Strategy:

• Risk of Ruin 5-10%
• 5th percentile near breakeven
• Moderate confidence intervals
• Slight positive skew

Risky Strategy:

• Risk of Ruin > 15%
• 5th percentile is negative
• Wide confidence intervals
• High standard deviation

Warning Signs:

• Very wide distribution
• Negative 25th percentile
• High risk of ruin (> 20%)
• Bimodal distribution (two peaks)

Best Practices

Before Trading:

1. Run Monte Carlo on all strategies
2. Only trade strategies with RoR < 10%
3. Check 5th percentile is acceptable
4. Verify normal distribution

Position Sizing:

• Low Risk (< 5% RoR): Standard position size
• Moderate Risk (5-15% RoR): Reduce position by 50%
• High Risk (> 15% RoR): Avoid or use micro lots

Ongoing Monitoring:

• Re-run Monte Carlo monthly
• Compare live results to MC predictions
• Stop trading if results fall below 5th percentile
• Adjust position size based on actual variance

---

🎯 Generating Strategies

Step 1: Start Generation

1. Review your settings
2. Click "Start Generation"
3. Monitor progress:
   • Current generation
   • Strategies found
   • Best fitness score
   • Time elapsed

Step 2: Wait for Completion

• Time estimate: 30 seconds to 5 minutes
• Depends on:
  • Population size
  • Number of generations
  • Data size
  • Computer speed

Step 3: Review Results

• Strategies found: Number of strategies meeting criteria
• Best strategy: Highest fitness score
• Generation: When the strategy was discovered

---

📈 Viewing Results

Strategy List

Each strategy shows:

• Profit Factor: Ratio of gross profit to gross loss
• Win Rate: Percentage of winning trades
• Total Trades: Number of trades executed
• Net Profit: Total profit in currency
• Max Drawdown: Largest equity drop

Strategy Details

Click "View Details" to see:

1. Performance Metrics:

   • Profit Factor, Win Rate, Total Trades
   • Net Profit, Max Drawdown, Recovery Factor
   • Average Win/Loss, Largest Win/Loss

2. BUY Rules:

   • Entry conditions (e.g., RSI(14) < 30)
   • All rules must be true for BUY signal

3. SELL Rules:

   • Entry conditions (inverted from BUY)
   • All rules must be true for SELL signal

4. Equity Curve:

   • Visual representation of account growth
   • Shows drawdown periods

5. Hourly Performance:

   • Best/worst trading hours
   • Win rate by hour
   • Profit by hour

6. Trade Statement:

   • Complete list of all trades
   • Entry/exit times and prices
   • Profit/loss per trade

---

💾 Downloading Strategies

Available Formats

1. MetaTrader 4 (.mq4):

   • For MT4 platform
   • Includes all input parameters
   • Ready to compile and use

2. MetaTrader 5 (.mq5):

   • For MT5 platform
   • Includes all input parameters
   • Ready to compile and use

3. cTrader (.cs):

   • For cTrader platform
   • C# source code
   • Ready to compile

4. TradingView (Pine Script):

   • For TradingView platform
   • Pine Script v5
   • Ready to use

5. HTML Report:

   • Comprehensive performance report
   • Includes all charts and metrics
   • Shareable and printable

6. JSON Data:

   • Raw strategy data
   • For custom integrations
   • Machine-readable format

How to Download

1. Click "Download" button on strategy card
2. Select format from dropdown
3. File downloads automatically
4. Install in your platform:
   • MT4/MT5: Copy to Experts/ folder
   • cTrader: Import as cBot
   • TradingView: Copy-paste Pine Script

---

🐛 Troubleshooting

CSV Upload Issues

Error: "CSV must contain: time, open, high, low, close columns"

• Solution: Ensure CSV has required columns
• Check: Column names can be lowercase or capitalized
• Try: Re-export from MT4/MT5 using DataProvider EA

Error: "CSV file is empty"

• Solution: Check file has data rows
• Try: Open CSV in Excel/Notepad to verify

License Issues

Error: "Invalid license key"

• Solution: Check key format (32 characters with dashes)
• Try: Copy-paste from email (avoid typing)

Error: "License has expired"

• Solution: Contact support for renewal
• Email: fxmathsolution@gmail.com

Error: "License validation failed"

• Solution: Check internet connection
• Try: Disable VPN/proxy
• Contact: Support if issue persists

Generation Issues

No strategies found

• Solution: Relax criteria (lower Min Profit Factor, Win Rate)
• Try: Increase population size and generations
• Check: Data quality (enough bars, no gaps)

Generation too slow

• Solution: Reduce population size and generations
• Try: Use smaller dataset (fewer bars)
• Check: Close other browser tabs

Browser Issues

Page not loading

• Solution: Clear browser cache (Ctrl+Shift+R)
• Try: Use incognito/private mode
• Check: JavaScript is enabled

Charts not displaying

• Solution: Disable ad blockers
• Try: Different browser
• Check: Internet connection

---

📞 Contact Support

Get Help

Email: fxmathsolution@gmail.com

• Response time: 24-48 hours
• Include: License key, error message, screenshots

Telegram: https://t.me/FxMath

• Faster response
• Community support
• Updates and announcements

Telegram Group: https://t.me/FxMathQuant

• Community discussions
• Share strategies and results
• Get help from other users

Website: https://fxmath.com

• Documentation
• Video tutorials
• FAQ

Before Contacting Support

Please provide:

1. License key (first 8 characters)
2. Error message (exact text or screenshot)
3. Browser (Chrome, Firefox, etc.) and version
4. Steps to reproduce the issue
5. CSV file (if upload issue)

---

📚 Additional Resources

Video Tutorials

• Getting Started: https://fxmath.com/tutorials/getting-started
• Data Export: https://fxmath.com/tutorials/data-export
• Strategy Generation: https://fxmath.com/tutorials/generation
• Advanced Settings: https://fxmath.com/tutorials/advanced

Documentation

• DataProvider EA Guide: Open EA Guide
• API Documentation: For developers
• License System: Setup and management

Community

• Telegram Group: https://t.me/FxMath
• Discord: https://discord.gg/fxmath
• Forum: https://forum.fxmath.com

---

⚠️ Important Notes

Disclaimer

• Past performance does not guarantee future results
• Backtest results may differ from live trading
• Always test strategies on demo account first
• Risk management is essential
• No guarantee of profitability

Best Practices

1. Test thoroughly on demo before live
2. Use proper lot sizing (1-2% risk per trade)
3. Monitor performance regularly
4. Update data monthly for fresh strategies
5. Diversify across multiple strategies and pairs
6. Set stop-loss on all trades
7. Keep records of all trades

Data Privacy

• All data is processed locally in your browser
• No data is sent to external servers
• License validation only sends license key
• CSV files remain on your computer
• Strategies are yours to keep

---

🎓 Tips for Success

Data Quality

• Use quality broker with good historical data
• Export enough bars (10,000+ recommended)
• Check for data gaps (weekends are normal)
• Update regularly (monthly) for current market conditions

Strategy Selection

• Don't overfit: Avoid too many rules
• Diversify: Use multiple strategies
• Validate: Test on different time periods
• Monitor: Track live performance

Risk Management

• Never risk more than 2% per trade
• Use stop-loss always
• Position sizing: Based on account size
• Drawdown limit: Stop trading at 20% drawdown

---

Happy Trading! 🎯

For support: fxmathsolution@gmail.com | https://t.me/FxMath | https://t.me/FxMathQuant

© 2025 FxMath Solution. All rights reserved.