167 lines
No EOL
5.1 KiB
Markdown
167 lines
No EOL
5.1 KiB
Markdown
<p align="center">
|
|
<img src="./Img/MultiStrategyRanges.png" alt="Multi Strategy Ranges Indicator Logo" width="1150" height="175"/>
|
|
</p>
|
|
|
|
<p align="center">
|
|
MetaTrader 5 Indicator that detects consolidation ranges and generates signals based on three customizable strategies
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/badge/Language-MQL5-1B6CA8?style=flat-square"/>
|
|
<img src="https://img.shields.io/badge/Platform-MetaTrader%205-0D1B2A?style=flat-square"/>
|
|
<img src="https://img.shields.io/badge/Author-nique__372%20And%20Leo-C9D6DF?style=flat-square&logoColor=white"/>
|
|
<img src="https://img.shields.io/badge/Articles-mql5.com-1B6CA8?style=flat-square"/>
|
|
<a href="./LICENSE">
|
|
<img src="https://img.shields.io/badge/License-Nique%26Leo%20FPU-orange.svg"/>
|
|
</a>
|
|
</p>
|
|
|
|
---
|
|
|
|
## Main Features
|
|
|
|
- Three detection strategies: direct breakout, breakout with retest, and false breakout with re-entry
|
|
- ATR-based or fixed-point range difference thresholds
|
|
- Swing high/low detection via pure swings or ZigZag
|
|
- Fully customizable rectangle style (color, fill, line width, line style)
|
|
- Configurable wait bars for retest and re-entry strategies
|
|
- Built-in alert system (popup and push notification)
|
|
- Multi-timeframe support
|
|
|
|
---
|
|
|
|
## Strategies
|
|
|
|
| Strategy | Description |
|
|
|----------|-------------|
|
|
| **Direct Breakout** | Generates a signal on the bar that breaks the range |
|
|
| **Breakout + Retest** | Waits for price to return and retest the broken level before signaling |
|
|
| **Re-entry (Manipulation)** | Signals when price re-enters the range after a false breakout |
|
|
|
|
---
|
|
|
|
## Input Parameters
|
|
|
|
### General
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `strategy_mod` | Strategy type: Breakout, Breakout + Retest, or Re-entry |
|
|
| `strategy_tf` | Timeframe for range detection |
|
|
|
|
### Retest Strategy
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `max_espera_reetest` | Maximum bars to wait for a retest (default: 40) |
|
|
| `type_retest` | Strict or non-strict retest validation |
|
|
|
|
### Re-entry Strategy
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `max_espera_re_entry` | Maximum bars to wait for re-entry (default: 40) |
|
|
|
|
### Range Detection
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `inp_type_get_swing` | Min/max detection mode: Pure Swings or ZigZag |
|
|
| `lenth_swing` | Swing candle length (used when Pure Swings mode is selected) |
|
|
| `period_zz` | ZigZag period (used when ZigZag mode is selected) |
|
|
| `inp_type_max_diff` | Max diff type: ATR-based or fixed points |
|
|
| `inp_atr_multiplier` | ATR multiplier for range width threshold |
|
|
| `inp_atr_period` | ATR period |
|
|
| `max_diff_in_high_lows_range_in_points` | Fixed max diff in points |
|
|
|
|
### Visual
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `fill_rect_range` | Fill the range rectangle |
|
|
| `clr_range` | Rectangle color |
|
|
| `style_range` | Line style |
|
|
| `width_range` | Line width |
|
|
|
|
### Alerts
|
|
| Parameter | Description |
|
|
|-----------|-------------|
|
|
| `enable_alerts` | Enable/disable alerts |
|
|
| `range_alerts_flasg` | Alert types: `Notification`, `Alert`, or both |
|
|
|
|
|
|
---
|
|
|
|
## Preview
|
|
|
|
### Direct Breakout
|
|
|
|
|
|
### Breakout + Retest
|
|
|
|
|
|
### Re-entry (Manipulation)
|
|
|
|
|
|
---
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
MultiStrategyRangesIndicator/
|
|
├── Src/ # Core strategy logic (MultyEstrategieRange.mqh, Global.mqh, etc.)
|
|
├── Img/ # Repo banner and assets
|
|
└── Multi Strategy Ranges Indicator.mq5 # Main indicator file
|
|
```
|
|
|
|
---
|
|
|
|
## Requirements
|
|
|
|
See `dependencies.json` for the full dependency list.
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
- Clone the repository into your MT5 `MQL5\Shared Projects\` folder via CMD
|
|
- Or contact me on MQL5 (user: `nique_372`) to be added as a collaborator with read-only access — the repository will appear automatically in your Shared Projects folder
|
|
- Or fork the repository
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
1. Download the latest `.ex5` from the Releases section
|
|
2. Copy the `.ex5` file into your MT5 `MQL5\Indicators\` folder
|
|
3. Attach the indicator to any chart and configure the inputs
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
**[Read Full License](./LICENSE)**
|
|
|
|
By downloading or using this repository, you accept the license terms.
|
|
|
|
---
|
|
|
|
## Disclaimer
|
|
|
|
**Trading involves substantial risk of loss.**
|
|
|
|
- This software is a technical tool, not financial advice
|
|
- Past performance does not guarantee future results
|
|
- You are solely responsible for your trading decisions
|
|
- Always test thoroughly before deploying with real capital
|
|
- Use appropriate risk management at all times
|
|
|
|
The authors assume no liability for trading losses, system failures, or any damages arising from the use of this software.
|
|
|
|
---
|
|
|
|
## Contact and Support
|
|
|
|
- **MQL5 Product Page:** https://www.mql5.com/en/market/product/133514
|
|
- **Comments & Community Support:** https://www.mql5.com/en/market/product/133514/comments
|
|
- **Profile:** https://www.mql5.com/es/users/nique_372
|
|
- **Issues:** Use the repository issue tracker for bug reports and feature requests
|
|
|
|
---
|
|
|
|
**Copyright © 2025 Nique-Leo. All rights reserved.** |