FxMathQuantWebApp/USER_MANUAL.md

# FxMathQuant Strategy Finder - User Manual

**AI-Powered Trading Strategy Generator**

---

## 📋 Table of Contents

1. [Getting Started](#getting-started)
2. [License Activation](#license-activation)
3. [Exporting Data from MT4/MT5](#exporting-data)
4. [Uploading Data](#uploading-data)
5. [Configuring Strategy Generation](#configuration)
6. [Understanding Monte Carlo Results](#understanding-monte-carlo-results)
7. [Generating Strategies](#generation)
8. [Viewing Results](#results)
9. [Downloading Strategies](#downloading)
10. [Troubleshooting](#troubleshooting)
11. [Contact Support](#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

```csv
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](ea-guide.html)
- **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.