Mirror of my ForgeMQL5 repository for MetaTrader 5. Synced to GitHub for backup and easier collaboration. - softwaredevelop/mql5

Welcome to QuantForge MQL5 Studio — a comprehensive, curated collection of MetaTrader 5 trading algorithms, utility scripts, and framework components designed for systematic traders, quantitative analysts, and algorithmic strategy developers. This repository serves as a structured archive and collaborative workspace, reflecting a continuous development workflow that bridges local experimentation with remote version control for resilience, transparency, and team-based iteration.

In the fast-paced world of automated trading, having a reliable, versioned, and organized codebase is not a luxury — it is a necessity. QuantForge MQL5 Studio transforms your MQL5 development pipeline by providing a modular architecture, reusable components, and a disciplined synchronization strategy that ensures every indicator, Expert Advisor (EA), and custom function is preserved, documented, and accessible from anywhere.

Whether you are fine-tuning a moving average crossover, building a multi-timeframe momentum scanner, or developing a portfolio-level risk management system, this repository is engineered to support you at every stage of the algorithmic lifecycle.

QuantForge MQL5 Studio is designed around a bi-directional synchronization model that mirrors your local ForgeMQL5 workspace directly to GitHub. This is not a simple backup — it is a live, versioned development environment that captures every incremental change, every optimization pass, and every bug fix. The architecture ensures zero data loss, instant rollback capability, and full historical traceability.

The repository is structured into logical component categories:

• Expert Advisors – Fully autonomous trading systems with configurable parameters
• Custom Indicators – Analytical tools for price action, volatility, and volume analysis
• Scripts – One-time execution utilities for trade management and data export
• Include Files – Reusable function libraries for signal processing, risk calculation, and order management

Each module is self-contained with its own parameter documentation, input validation, and error-handling routines.

The underlying framework supports multiple trading paradigms simultaneously:

• Trend-following systems
• Mean-reversion algorithms
• Breakout detection engines
• Volatility-based position sizing
• Machine learning signal integration (via external DLL bridges)

All strategies are designed to run concurrently within a single MetaTrader 5 instance, enabling portfolio-level optimization and risk correlation analysis.

Every component includes comprehensive logging mechanisms that record:

• Execution timestamps with millisecond precision
• Order placement and modification events
• Margin and equity calculations
• Connection status and symbol availability
• Custom error codes for rapid debugging

Logs are structured in CSV format for easy import into external analytics platforms.

Integrated risk controls include:

• Maximum drawdown limits (absolute and relative)
• Position size normalization based on account balance and volatility
• Maximum spread thresholds
• Trading session filters (day of week, hour, timezone)
• Cooldown periods between consecutive trades

These risk parameters are auditable, overridable, and persisted across MetaTrader 5 restarts.

The QuantForge MQL5 Studio architecture follows a layered design pattern:

// Conceptual architecture (pseudo-code for illustration)
// Layer 1: CoreEngine.mqh – Base class with event handling, timer management
// Layer 2: SignalProcessor.mqh – Abstract signal detection interface
// Layer 3: ExecutionManager.mqh – Order placement, modification, cancellation
// Layer 4: RiskController.mqh – Position sizing, drawdown monitoring
// Layer 5: StrategyLayer.mqh – User-defined trading logic

This separation allows developers to modify trading logic without affecting core infrastructure, and vice versa. The include files are compiled once and shared across all EAs and indicators, ensuring consistent behavior across your entire trading environment.

All code within this repository adheres to MetaTrader 5’s security guidelines:

• No hardcoded API keys, secret tokens, or authentication credentials
• All external resource calls are sandboxed and logged
• Trade execution uses MetaTrader 5’s native order management functions
• No unauthorized access to terminal file system or network endpoints

QuantForge MQL5 Studio is released under the MIT License. This means you are free to use, modify, distribute, and integrate the code into your own trading systems, even commercially. The only requirement is that the original copyright notice is retained in all copies or substantial portions of the software.

• ✅ Use in personal projects
• ✅ Use in commercial trading systems
• ✅ Modify, refactor, and extend
• ✅ Distribute as part of larger software
• ❌ Hold the authors liable for trading losses

IMPORTANT LEGAL NOTICE
The algorithms, strategies, and code contained in this repository are provided for educational and research purposes only. Trading in financial markets carries substantial risk of loss, and past performance of any algorithm or indicator does not guarantee future results. Nothing in this repository constitutes financial advice, investment recommendation, or solicitation to trade.

By using QuantForge MQL5 Studio, you acknowledge that:

• You understand the risks associated with automated trading
• You have tested all code in a demo environment before live deployment
• You assume full responsibility for any financial outcomes, both positive and negative
• The authors and contributors are not liable for any trading losses, system failures, or data inaccuracies

Always consult with a qualified financial professional before implementing any automated trading strategy.

• MetaTrader 5 terminal (version 2000 or higher)
• Basic knowledge of MQL5 programming or willingness to learn
• A GitHub account for collaboration features

1. Navigate to your MetaTrader 5 installation directory
2. Locate the MQL5 folder under the main terminal directory
3. Replace or merge the contents with the cloned repository structure
4. Restart MetaTrader 5 to compile all files
5. Open the Navigator panel (Ctrl+N) to see available EAs, indicators, and scripts

The first compilation may take 2–5 minutes depending on your system configuration.

QuantForge-MQL5-Studio/
├── Experts/           # Deployable Expert Advisors
├── Indicators/        # Custom analytical indicators
├── Scripts/           # Utility scripts (trade management, reporting)
├── Include/           # Shared libraries and base classes
├── Files/             # Data files, templates, configuration JSON
├── Docs/              # Documentation and changelogs
├── Tests/             # Optional test scripts for validation
├── LICENSE            # MIT License file
└── README.md          # This file

Each folder contains its own _index.txt file with a brief description of the contents and recommended usage patterns.

We welcome contributions that improve code quality, add new strategies, fix bugs, or enhance documentation. Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (feature/your-new-strategy)
3. Commit changes with clear, descriptive messages
4. Test thoroughly on a demo account
5. Submit a pull request

All contributions are subject to the same MIT License terms.

Join the conversation with other algorithmic traders using QuantForge MQL5 Studio. Share your adaptations, report issues, or request new features. The repository is continuously updated based on community feedback and real-world trading experience.

For sensitive inquiries, use the repository’s issue tracker with appropriate privacy settings.

All roadmap items are subject to change based on development priorities and community input.

Q: Is this compatible with MetaTrader 4?
A: No. This repository is exclusively for MetaTrader 5 (MQL5). MetaTrader 4 uses MQL4, which has a different syntax, function set, and compilation model.

Q: Can I use this on a VPS trading server?
A: Absolutely. The repository structure is designed for deployment on any Windows-based VPS running MetaTrader 5. Simply copy the directory structure to the VPS and compile.

Q: How often is this repository updated?
A: Updates are pushed as development progresses. The synchronization process ensures that the GitHub repository is never more than one commit behind the local development environment.

Q: Does using this repository improve trading profitability?
A: This repository provides tools and frameworks for systematic trading. Profitability depends entirely on your strategy logic, risk management, market conditions, and execution discipline. No algorithm guarantees profits.

QuantForge MQL5 Studio: Where algorithms evolve, and traders grow.