Overview
Welcome to the Mad Turtle AI documentation. This comprehensive guide will walk you through every aspect of installing, configuring, and optimizing your AI-powered trading system for MetaTrader 5.
What is Mad Turtle AI?
Mad Turtle AI is a sophisticated machine learning trading system designed specifically for
XAUUSD (Gold) trading on the H4 timeframe. It utilizes ONNX neural network models to analyze
market patterns and execute high-probability trades with mathematical precision.
Key features include:
- Native ONNX Execution: Runs neural networks directly in MT5 without external dependencies
- Ensemble Learning: Combines multiple AI models for superior accuracy
- No Martingale: Safe, fixed-risk money management
- Adaptive Intelligence: Learns from market conditions in real-time
- Fully Automated: Set it and forget it - works 24/7
System Requirements
Minimum System Specifications
| Component | Minimum | Recommended |
|---|---|---|
| Platform | MetaTrader 5 (Build 3802+) | Latest MT5 Build |
| Operating System | Windows 10 (64-bit) | Windows 11 / Server 2019+ |
| RAM | 4GB | 8GB+ |
| Storage | 500MB free | 2GB+ SSD |
| Internet | Stable connection | Low latency (<50ms)< /td> |
Broker Requirements
- ONNX Support: Broker must support ONNX model execution in MT5
- XAUUSD Availability: Gold trading pair must be available
- Minimum Balance: $500 (recommended $1000+)
- Leverage: 1:100 or higher recommended
- Spread: Low spread broker preferred (under 20 pips average)
- Execution: ECN or STP execution preferred
Risk Warning
Trading involves substantial risk of loss. Never trade with money you cannot afford to lose.
Always test on a demo account before going live. Past performance does not guarantee future
results.
Installation Guide
Follow these steps carefully to install Mad Turtle AI on your MetaTrader 5 platform:
1
Download the Bot Package
Visit the official download page and acquire your Mad Turtle AI package:
https://infinityalgoacademy.net/item/ai-machine-learning-trading-bot-mad-turtle/
Your download will include:
MadTurtleAI.ex5- Main Expert Advisor executablemodel.onnx- Pre-trained neural network modelconfig.set- Default configuration presetREADME.txt- Quick start guide
2
Locate Your MT5 Data Folder
Open MetaTrader 5 and navigate to the data directory:
- Launch MT5 platform
- Click File → Open Data Folder
- Windows Explorer will open showing your MT5 data directory
C:\Users\[YourName]\AppData\Roaming\MetaQuotes\Terminal\[BrokerID]\
3
Install the Files
Copy the downloaded files to their respective folders:
- Copy
MadTurtleAI.ex5to:MQL5\Experts\ - Copy
model.onnxto:MQL5\Files\ - Copy
config.setto:MQL5\Presets\
Pro Tip
After copying files, restart MT5 completely to ensure all components are properly loaded
and recognized by the platform.
4
Enable Automated Trading
Configure MT5 to allow Expert Advisors:
- In MT5, click Tools → Options
- Navigate to the Expert Advisors tab
- Enable these settings:
- ✅ Allow automated trading
- ✅ Allow DLL imports
- ✅ Allow WebRequest for listed URL
- Click OK to save changes
5
Attach Bot to Chart
- Open a XAUUSD H4 chart (4-hour timeframe)
- Press Ctrl+N to open Navigator panel
- Expand Expert Advisors section
- Drag MadTurtleAI onto the XAUUSD H4 chart
- Settings window appears - click OK (we'll configure later)
- Verify: Look for a smiley face icon 😊 in top-right corner
Installation Complete!
If you see the smiley face icon and no error messages in the Experts tab (Ctrl+T), your
bot is successfully installed and ready to trade.
Configuration Settings
Understanding and properly configuring these parameters is crucial for optimal performance:
Risk Management Parameters
| Parameter | Default | Description |
|---|---|---|
| LotSize | 0.01 | Fixed lot size per trade. Recommended: 0.01 per $1000 balance |
| RiskPercent | 2.0 | Risk per trade as % of balance. Range: 1-5%. Conservative: 2%, Aggressive: 3-5% |
| MaxSpread | 200 | Maximum allowed spread in points. Bot won't trade if spread exceeds this |
| StopLoss | 500 | Stop loss in pips. Recommended: 400-600 for H4 timeframe |
| TakeProfit | 1200 | Take profit in pips. Recommended: 1000-1500 for optimal R:R |
AI Model Settings
| Parameter | Default | Description |
|---|---|---|
| ModelPath | model.onnx | Path to ONNX model file. Leave as default unless using custom model |
| ConfidenceThreshold | 0.75 | Minimum AI confidence (0.0-1.0). Higher = fewer but more confident trades |
| UseEnsemble | true | Enable multi-model voting. Recommended: true for better accuracy |
Trading Hours
| Parameter | Default | Description |
|---|---|---|
| TradingStartHour | 0 | Start trading at (0-23). Default: 0 (midnight) - trades 24/7 |
| TradingEndHour | 23 | Stop trading at (0-23). Default: 23 (11 PM) |
| AvoidNews | true | Pause during high-impact news. Recommended: true to avoid volatility spikes |
Example Configuration
// Recommended Settings for $1000 Account
LotSize = 0.01
RiskPercent = 2.0
StopLoss = 500
TakeProfit = 1200
ConfidenceThreshold = 0.75
UseEnsemble = true
AvoidNews = true
Optimization & Best Practices
Account Size Recommendations
| Account Size | Lot Size | Risk % | Strategy |
|---|---|---|---|
| $500-$1000 | 0.01 | 2% | Conservative - Focus on capital preservation |
| $1000-$5000 | 0.01-0.05 | 2-3% | Balanced - Steady growth with moderate risk |
| $5000+ | Scale proportionally | 2-4% | Aggressive - Consider multiple instances |
VPS Hosting (Highly Recommended)
For 24/7 uninterrupted operation, use a Virtual Private Server:
- OS: Windows Server 2016 or higher
- RAM: 2GB minimum, 4GB recommended
- Location: Near your broker's server for low latency
- Providers: Forex VPS, Vultr, AWS, or broker-provided VPS
- Cost: Typically $15-30/month
Why Use a VPS?
A VPS ensures your bot runs 24/7 without interruption from power outages, internet issues, or
computer restarts. It also provides faster execution with lower latency to broker servers.
Performance Monitoring
Track these key metrics weekly:
- Win Rate: Target 60%+ winning trades
- Profit Factor: Should be above 1.5
- Average Win/Loss Ratio: Aim for 2:1 or better
- Maximum Drawdown: Keep under 20%
- Sharpe Ratio: Higher is better (above 1.0 is good)
Frequently Asked Questions
Why isn't my bot trading?
Check these common issues:
- Ensure "AutoTrading" button is enabled (green) in MT5 toolbar
- Verify you're on XAUUSD H4 chart specifically
- Check current spread - if too high, bot waits for better conditions
- Confirm
model.onnxis inMQL5\Files\folder - Review Experts tab (Ctrl+T) for error messages
- Ensure sufficient account balance and margin
How many trades should I expect per week?
Mad Turtle AI is a quality-over-quantity system. On H4 timeframe, expect 3-8 trades per week
on average. During low-volatility periods, it may wait several days for optimal setups. This
is intentional - the AI only trades when confidence is high enough to justify the risk.
Can I use this on other pairs besides XAUUSD?
No. The neural network model is specifically trained on XAUUSD price patterns, volatility
characteristics, and market behavior. Using it on other pairs will result in poor
performance and losses. We're developing models for EUR/USD, GBP/USD, and other major pairs
- join our community for updates.
What's the expected monthly return?
Backtesting and forward testing show 8-15% monthly returns with proper risk management (2%
risk per trade). However, past performance does not guarantee future results. Market
conditions vary, and drawdown periods are normal. Some months may be flat or negative.
Always trade responsibly.
Do I need to update the model?
Yes. We release model updates quarterly (every 3 months) to adapt to evolving market
conditions and improve accuracy. Updates are completely free for all users. You'll receive
email notifications when new models are available. Simply replace the old
model.onnx file with the new one.
Can I run multiple instances simultaneously?
Yes, but only on different accounts or with different magic numbers. Running multiple
instances on the same account with the same symbol can cause order conflicts and unexpected
behavior. If you want to diversify, use separate broker accounts or wait for our multi-pair
models.
Is there a mobile app to monitor trades?
The bot runs on MT5, which has excellent mobile apps for iOS and Android. You can monitor
all trades, check performance, and even close positions manually from your phone. However,
the EA itself must run on a desktop/VPS. We recommend using MT5 mobile app for monitoring
while the bot runs on your VPS.
Troubleshooting
Error: "ONNX model not found"
Solution:
- Verify
model.onnxexists in:MQL5\Files\ - Check file name is exactly "model.onnx" (case-sensitive)
- Re-download if file is corrupted (check file size > 0 bytes)
- Restart MT5 completely after placing file
- Check file permissions - ensure MT5 can read the file
Error: "Trading is disabled"
Solution:
- Click the "AutoTrading" button in MT5 toolbar (should turn green)
- Go to Tools → Options → Expert Advisors
- Ensure "Allow automated trading" is checked
- Verify your broker allows EA trading (contact support if unsure)
- Check if account is in read-only mode
Bot opens trades but closes immediately
Possible causes and solutions:
- Stop loss too tight: Increase SL value to 500+ pips
- Spread widening: Check MaxSpread setting, increase if needed
- Broker restrictions: Some brokers have minimum trade duration - contact support
- Insufficient margin: Check account balance and leverage
- Conflicting EAs: Remove other EAs from the same chart
High drawdown / consecutive losses
Actions to take:
- Reduce risk per trade to 1-2% immediately
- Increase ConfidenceThreshold to 0.80 or 0.85
- Verify you're using the latest model version
- Consider pausing during extreme market volatility (major news events)
- Review broker spread and execution quality
- Check if you're trading during recommended hours
Drawdown is Normal
All trading systems experience drawdown periods. If you hit 15-20% drawdown, reduce lot size by
50% or pause trading until market conditions improve. Never increase lot size to "recover"
losses faster - this leads to account blowouts.
Still Having Issues?
If you've tried the above solutions and still experiencing problems, please contact our support team with:
- MT5 build number (Help → About)
- Broker name
- Screenshot of the error message
- Contents of the Experts tab (Ctrl+T)
- Your configuration settings
Support & Community
Get Help
We offer multiple support channels to assist you:
Email Support
Response time: 24-48 hours | Available: Mon-Fri, 9AM-6PM GMT
Telegram Community
Join our active trader community for real-time help, strategy discussions, and market insights.
Join TelegramDiscord Server
Technical discussions, direct access to developers, and exclusive alpha testing opportunities.
Join DiscordYouTube Channel
Video tutorials, setup guides, strategy explanations, and weekly market analysis.
Subscribe NowAdditional Resources
- View All Products - Explore complementary trading tools
- About Our Technology - Deep dive into how the AI works
- Contact Us - Business inquiries and partnerships
Ready to Start Trading?
Download Mad Turtle AI now and join thousands of traders using machine learning to navigate the
markets with precision and confidence.
Download Now
Download Now