HarmonicVision Pro
HarmonicVision Pro v2.10: Complete Feature Guide
A comprehensive walkthrough of every setting and feature in HarmonicVision Pro, the advanced harmonic pattern projection engine for MetaTrader 5.
Introduction
Harmonic trading is one of the most precise approaches to technical analysis, using Fibonacci ratios to identify high-probability reversal zones. However, manually scanning charts for harmonic patterns across multiple timeframes is extremely time-consuming and error-prone. Missing a single ratio or misjudging a pivot point can lead to invalid pattern identification.
HarmonicVision Pro is an advanced harmonic pattern projection engine for MetaTrader 5 that automatically detects, validates, and projects harmonic patterns directly on your chart. It supports over 15 pattern types including Gartley, Bat, Butterfly, Crab, Deep Crab, Shark, Cypher, Nen Star, 5-0, AB=CD, 3 Drives, and more. The indicator uses a multi-wave analysis system that scans up to 6 different wave lengths simultaneously, giving you coverage from short-term scalping patterns to long-term swing setups.
Whether you are a harmonic trading veteran looking for a reliable scanner or a newer trader learning to identify these patterns, this guide covers every parameter and feature in detail so you can configure the tool for your specific trading approach.
Part 1: Getting Started
Installation:
- Copy HarmonicVision_Pro.ex5 to your Indicators folder
- Restart MT5 or click "Refresh" in the Navigator panel
- Drag the indicator onto your chart
- The indicator will begin scanning for harmonic patterns immediately
What You See on the Chart
When loaded, HarmonicVision Pro draws detected harmonic patterns directly on your chart. Each pattern is displayed with connecting wave lines, point labels (X, A, B, C, D), optional Fibonacci ratio annotations, projected completion zones, and target levels. Bullish patterns appear in green and bearish patterns appear in red by default.
| Visual Element | Description |
|---|---|
| Wave Lines | Solid trend lines connecting each pivot point of the pattern (X-A-B-C-D) |
| Point Labels | Letters (X, A, B, C, D) placed at each pivot for easy identification |
| Pattern Name | The detected pattern name displayed at Point D (e.g., "Gartley", "Bat") |
| Triangle Fills | Semi-transparent filled triangles forming the pattern body (wings) |
| Projection Zone | Dashed lines and filled area showing where Point D is projected to complete |
| Target Levels | Horizontal lines showing Stop Loss, Point D entry, and 4 take-profit targets |
| Ratio Lines | Optional diagonal lines with Fibonacci ratio values between key points |
| Arrow Signals | Green upward arrow for bullish patterns, red downward arrow for bearish patterns at Point D |
Part 2: Draw Settings
The Draw Settings group controls which visual elements appear on your chart. These settings let you customize the level of detail displayed, from a minimal clean view showing only pattern lines to a fully detailed view with ratios, targets, and labels.
Draw Pattern Lines
Draw Pattern Lines: true
Enables or disables the main wave lines connecting each pivot point. When enabled, you see the full X-A-B-C-D structure drawn on the chart. Disabling this hides all pattern lines but arrow signals at Point D still appear.
Draw Pattern Names
Draw Pattern Names: true
Shows the detected pattern name at Point D. When multiple patterns overlap at the same location, all matching pattern names are displayed on separate lines. For example, you might see both "Gartley" and "Bat" identified at the same point.
Draw Point Letters
Draw Point Letters: true
Displays the letters X, A, B, C, and D at each pivot point. This is helpful for learning and verifying patterns. Experienced traders who prefer a cleaner chart can disable this.
Draw Ratios and Lines
Draw Ratios and Lines: false
When enabled, diagonal lines are drawn between key points (X-B, A-C, B-D, X-D) with the Fibonacci ratio values displayed at the midpoint. This is particularly useful for studying patterns and verifying their validity. Disabled by default to keep the chart clean.
Draw Target Levels
Draw Target Levels: true
Shows horizontal target levels extending to the right of Point D, including a Stop Loss level, the D entry level, and up to 4 take-profit targets based on Fibonacci percentages. These levels help you plan your trade management.
Wait for Confirmation
Wait for Confirmation: false
When set to false (default), patterns are detected as they form in real-time, which means the pattern can update as new bars develop. When set to true, the indicator waits for one additional pivot to confirm before displaying the pattern. This reduces false signals but delays detection by one swing.
Tip: Use "false" for early entries and projections. Switch to "true" if you prefer confirmed patterns only.
Part 3: Supported Harmonic Patterns
HarmonicVision Pro detects two categories of patterns: classic Harmonic Patterns (based on Scott Carney's work) and additional community patterns. Each pattern can be individually enabled or disabled.
Harmonic Patterns (XABCD)
| Pattern | Default | Description |
|---|---|---|
| Gartley (222) | Enabled | The original harmonic pattern, known for high accuracy at the 0.786 XAD completion |
| Bat | Enabled | A deep retracement pattern completing at 0.886 XAD, offering tight stop placement |
| Bat Alternate | Enabled | An extended version of the Bat with a 1.13 XAD completion |
| Butterfly | Enabled | An extension pattern completing beyond X, typically at 1.27 XAD |
| Crab | Enabled | The most extended pattern with a 1.618 XAD completion for deep reversals |
| Deep Crab | Enabled | Similar to Crab but with a deeper 0.886 XAB retracement |
| Shark | Enabled | A newer harmonic pattern using 0-5 structure with extended BC leg |
| AB=CD | Enabled | The foundational harmonic pattern where AB and CD legs are equal in price and time |
| AB=CD Alternate | Enabled | Extended AB=CD where CD is 1.272 or 1.618 of AB in both price and time |
| 5-0 | Enabled | A 6-point (YXABCD) pattern signaling trend exhaustion and reversal |
Other Patterns
| Pattern | Default | Description |
|---|---|---|
| Cypher | Enabled | A wide pattern with BC extending beyond 1.13 of AB, completing at 0.786 XC |
| Nen Star | Enabled | Similar structure to Cypher with different completion ratios |
| ABCD Classic | Disabled | Classic 4-point ABCD pattern using standard Fibonacci retracements |
| ABCD Extended | Disabled | Extended ABCD where CD exceeds AB by Fibonacci extension ratios |
| 3 Drives | Enabled | A 6-point reversal pattern with three symmetrical pushes into exhaustion |
| 121 | Disabled | A simpler pattern based on specific XAB and BCD ratio ranges |
| Double Bottom/Top | Disabled | Classic double bottom and double top reversal patterns |
Tip: Start with the default enabled patterns. Once you become familiar with the indicator, enable ABCD Classic, ABCD Extended, 121, or Double Bottom/Top for additional signals.
Part 4: Projected Point D Ratios
One of the most powerful features of HarmonicVision Pro is the ability to customize the projected Point D ratio for each pattern individually, with separate settings for bullish and bearish formations. The projected D ratio determines where the indicator expects the pattern to complete, and it draws the projection zone accordingly.
How Projection Works
When a partial pattern is detected (X, A, B, C points identified), the indicator calculates where Point D should appear based on the configured ratio. This projected zone is drawn on the chart as dashed lines and a filled area, giving you advance notice of where to look for a potential entry.
Default D Ratios
| Pattern | Bull D Ratio | Bear D Ratio |
|---|---|---|
| Gartley | 0.786 | 0.786 |
| Bat | 0.886 | 0.886 |
| Bat Alternate | 1.130 | 1.130 |
| Butterfly | 1.270 | 1.270 |
| Crab | 1.618 | 1.618 |
| Deep Crab | 1.618 | 1.618 |
| Shark | 1.130 | 1.130 |
| Cypher | 0.786 | 0.786 |
| Nen Star | 1.272 | 1.272 |
| AB=CD | 1.130 | 1.130 |
| ABCD | 1.618 | 1.618 |
| 5-0 | 1.500 | 0.500 |
Example: If you trade Gartley patterns and prefer to enter slightly earlier, you could adjust the Gartley Bull D Ratio from 0.786 to 0.750. If you prefer to wait for deeper completion, increase it to 0.800.
Part 5: Display Projection Settings
These settings control the visual appearance of the projection zone, which shows where Point D is expected to complete.
Fill BD Line
Fill BD Line: true
BD Fill Alpha: 170 (0-255)
When enabled, a dashed line is drawn from Point B to the projected Point D location. The alpha value controls the transparency of this line, where 0 is fully visible and 255 is fully transparent. The default of 170 provides a subtle visual guide.
Fill CD Line
Fill CD Line: true
CD Fill Alpha: 170 (0-255)
Similar to the BD line, this draws a dashed projection line from Point C to the projected Point D. Together with the BD line, these form the projection zone triangle.
Part 6: Triangle Fill (Solid Body)
HarmonicVision Pro can fill the pattern body with semi-transparent triangles, making it easier to visually identify the pattern structure at a glance.
Enable Filled Triangles: true
Bullish Fill Color: PaleGreen
Bearish Fill Color: MistyRose
When enabled, the indicator draws filled triangles for each "wing" of the pattern. For XABCD patterns, two triangles are drawn: the left wing (X-A-B) and the right wing (B-C-D). A third projection triangle (B-C-projected D) shows the expected completion zone. The fill colors are fully customizable.
Tip: Use soft, light colors for the fills to keep them visible without overwhelming price action. PaleGreen and MistyRose work well on both light and dark chart backgrounds.
Part 7: Ratio Settings
The Ratio Settings control how Fibonacci ratio annotations appear when "Draw Ratios and Lines" is enabled.
Ratio Precision: 1 [%]
Ratio Line Color: Silver
Ratio Line Style: Dotted
Ratio Line Width: 1
Ratio Precision is a critical parameter that controls the tolerance for pattern detection. It defines how closely the measured ratios must match the theoretical Fibonacci ratios for a pattern to be considered valid.
Example: With Ratio Precision set to 1%, a Gartley pattern requires the XAB ratio to be within 1% of 0.618. This means any value between approximately 0.612 and 0.624 would qualify. Increasing this value to 3% would widen the acceptable range, detecting more patterns but with less precision. Decreasing to 0.5% would require near-perfect ratios, showing fewer but more accurate patterns.
Part 8: Target Level Settings
Target levels provide automatic trade management guidelines based on the detected pattern. These horizontal levels extend to the right of Point D, giving you clear visual references for stop loss and take-profit placement.
Level Width: 20 (bars)
Stop Loss: -2.5 [%]
SL Color: Red
Point D: 0.0 [%]
D Color: Orange
Target 1: 23.6 [%]
Target 2: 50.0 [%]
Target 3: 61.8 [%]
Target 4: 78.6 [%]
T1-T4 Color: DodgerBlue
Level Width determines how many bars forward the target levels extend on the chart. A value of 20 means the levels are drawn 20 bars to the right of Point D.
Stop Loss is set as a percentage of the C-D leg. The default of -2.5% places the stop just beyond Point D in the direction opposite to the expected reversal.
Target Levels (T1 through T4) are based on Fibonacci retracement percentages of the C-D leg. The default values of 23.6%, 50.0%, 61.8%, and 78.6% represent standard Fibonacci retracement levels, providing a structured exit strategy.
Example: On a bullish Gartley pattern where Point C is at 1.2000 and Point D is at 1.1900 (CD leg = 100 pips), the targets would be:
Stop Loss (-2.5%): Below D by 2.5 pips = 1.1875
Point D (0.0%): 1.1900 (entry zone)
Target 1 (23.6%): 1.1924
Target 2 (50.0%): 1.1950
Target 3 (61.8%): 1.1962
Target 4 (78.6%): 1.1979
Part 9: Wave Settings
The multi-wave system is what makes HarmonicVision Pro truly powerful. Instead of scanning at a single lookback length, the indicator runs up to 6 independent wave scanners simultaneously, each with its own pivot detection length. This allows you to see patterns forming at different scales on the same chart.
Wave Colors and Style
Bullish Color: Lime
Bearish Color: Red
Wave Line Style: Solid
Wave Line Width: 2
These settings apply to all waves. Bullish patterns use the Bullish Color and bearish patterns use the Bearish Color.
Individual Wave Configuration
| Wave | Default Enabled | Default Length | Typical Use |
|---|---|---|---|
| Wave 1 | Yes | 8 | Short-term / Scalping patterns |
| Wave 2 | Yes | 13 | Intraday patterns |
| Wave 3 | Yes | 21 | Swing trading patterns |
| Wave 4 | Yes | 55 | Position trading patterns |
| Wave 5 | No | 89 | Long-term macro patterns |
| Wave 6 | No | 144 | Very long-term / Monthly analysis |
The wave length determines the minimum number of bars a pivot high or pivot low must dominate on both sides to be considered valid. A length of 8 means the pivot high must be the highest high within 8 bars to the left and 8 bars to the right (16-bar window total).
Tip: The default lengths (8, 13, 21, 55) follow the Fibonacci sequence. Shorter lengths detect smaller, more frequent patterns; longer lengths detect larger, rarer but more significant patterns. For day trading on M15, waves 1-3 are typically sufficient. For swing trading on H4 or D1, consider enabling waves 4-5.
Part 10: Other Settings
Max Pivot Size
Max Pivot Size: 300
Controls the maximum number of pivot points stored in memory for each wave. A higher value allows the indicator to look further back in history but uses more memory. The default of 300 is suitable for most use cases.
Max Patterns on Chart
Max Patterns: 50
Limits the total number of patterns displayed on the chart at any given time. This prevents chart clutter on instruments or timeframes where many patterns are detected simultaneously.
Part 11: Configuration Recommendations
Scalping Setup (M1-M15)
Wave 1: Enabled, Length 5
Wave 2: Enabled, Length 8
Wave 3: Enabled, Length 13
Wave 4-6: Disabled
Ratio Precision: 2%
Wait for Confirmation: false
Draw Targets: true
Level Width: 10 bars
For scalping, shorter wave lengths detect quick patterns forming on lower timeframes. A slightly wider ratio precision (2%) captures more setups. Disable higher waves to reduce chart clutter.
Day Trading Setup (M15-H1)
Wave 1: Enabled, Length 8
Wave 2: Enabled, Length 13
Wave 3: Enabled, Length 21
Wave 4: Enabled, Length 34
Wave 5-6: Disabled
Ratio Precision: 1%
Wait for Confirmation: false
Draw Targets: true
Level Width: 20 bars
The default settings work well for day trading. Four active waves give you coverage across multiple swing sizes within the trading day.
Swing Trading Setup (H4-D1)
Wave 1: Disabled
Wave 2: Enabled, Length 13
Wave 3: Enabled, Length 21
Wave 4: Enabled, Length 55
Wave 5: Enabled, Length 89
Wave 6: Disabled
Ratio Precision: 1%
Wait for Confirmation: true
Draw Targets: true
Level Width: 30 bars
For swing trading, disable the shortest wave and enable longer waves. Using "Wait for Confirmation" reduces false signals on higher timeframes where each bar represents more time.
Minimal Clean View
Draw Pattern Lines: true
Draw Pattern Names: true
Draw Point Letters: false
Draw Ratios and Lines: false
Draw Target Levels: false
Enable Filled Triangles: false
If you prefer a clean chart with minimal visual elements, disable letters, ratios, targets, and triangle fills. You will still see the pattern lines and names.
Full Analysis View
Draw Pattern Lines: true
Draw Pattern Names: true
Draw Point Letters: true
Draw Ratios and Lines: true
Draw Target Levels: true
Enable Filled Triangles: true
For detailed analysis and learning, enable everything. This gives you the complete picture including all ratio values and target levels.
Part 12: Buffer Data Access (For Developers)
HarmonicVision Pro provides two indicator buffers that can be accessed programmatically from Expert Advisors or other indicators using the iCustom function.
| Buffer Index | Description | Signal |
|---|---|---|
| 0 | Bullish Pattern Arrow | Non-zero value = bullish pattern detected at Point D |
| 1 | Bearish Pattern Arrow | Non-zero value = bearish pattern detected at Point D |
// Example: Reading HarmonicVision Pro buffers from an EA
double bullSignal = iCustom(_Symbol, _Period, "HarmonicVision Pro", 0, 0);
double bearSignal = iCustom(_Symbol, _Period, "HarmonicVision Pro", 1, 0);
if(bullSignal != 0) // Bullish harmonic pattern detected
if(bearSignal != 0) // Bearish harmonic pattern detected
Conclusion
HarmonicVision Pro provides a professional-grade harmonic pattern detection and projection engine for MetaTrader 5 traders:
- Comprehensive Pattern Library — Over 15 patterns including Gartley, Bat, Butterfly, Crab, Shark, Cypher, 5-0, AB=CD, 3 Drives, and more
- Multi-Wave Analysis — Up to 6 simultaneous wave scanners covering scalping through position trading timeframes
- Customizable Projections — Individual D-point ratio settings for each pattern, separate for bullish and bearish formations
- Visual Clarity — Filled triangle bodies, projection zones, point labels, ratio annotations, and target levels
- Trade Management — Built-in stop loss and 4 Fibonacci-based take-profit target levels
- Developer Access — Two buffer outputs for integration with Expert Advisors via iCustom
The key to success with harmonic patterns is matching the configuration to your trading style. Start with the default settings on a demo account, study the patterns the indicator identifies, and gradually customize wave lengths, ratio precision, and target levels as you develop your edge.
Need Help?
Join our MQL5 community group for support, updates, and discussions with other users.
More Products
Click here to explore my other products for MetaTrader 5.
Disclaimer: Trading involves substantial risk of loss. HarmonicVision Pro is a technical analysis tool that assists with harmonic pattern identification — it does not provide trading signals or guarantee results. Always trade responsibly and use proper risk management.