gavindiaz/FxMathQuantWebApp
1
0
Fork 0
mirror of https://github.com/FxPouya/FxMathQuantWebApp.git synced 2026-07-29 03:07:44 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
ebbbb3e71f3aafff8d93b89da49b2c7055942396
FxMathQuantWebApp/USER_MANUAL.md
T
FxPouya ad50cc66cb Add files via upload
2025-12-24 13:07:51 +03:30

444 lines
11 KiB
Markdown
Raw Blame History

# 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. [Generating Strategies](#generation)
7. [Viewing Results](#results)
8. [Downloading Strategies](#downloading)
9. [Troubleshooting](#troubleshooting)
10. [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%
---
## 🎯 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
**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**: See `downloads/README.md`
- **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
© 2025 FxMath Solution. All rights reserved.
Reference in New Issue View Git Blame Copy Permalink