Nebryx BandPulse Matrix
- Indicateurs
- Version: 1.0
Nebryx BandPulse Matrix
Professional Bollinger Bands Volatility Context Indicator for MetaTrader 5
PRODUCT OVERVIEW
Nebryx BandPulse Matrix is a clean volatility-context indicator built around Bollinger Bands. It is designed for traders who want more than a standard band overlay. The indicator combines classic Bollinger Bands with volatility squeeze detection, expansion confirmation, band-walk trend context, stretch/overextension markers, and a compact chart status label.
The product focuses on market context, not automatic buy or sell promises. It helps the user understand whether the market is compressed, expanding, walking a band, or temporarily stretched outside the channel.
KEY FEATURES
- Professionally calculated Bollinger Bands with upper, middle, and lower lines.
- Optional light fill between the bands to show the volatility channel clearly.
- BandWidth-based squeeze detection using a relative BandWidth SMA threshold.
- Confirmed expansion markers after a squeeze, printed only on closed bars.
- Bullish and bearish band-walk context based on price position and middle-band slope.
- Upper Stretch and Lower Stretch markers when price closes outside the bands.
- Compact chart label showing confirmed state, volatility condition, stretch context, %B, and BandWidth.
- Optional alerts for squeeze, expansion, and band-walk context.
- Alerts are OFF by default.
- No DLL, no WebRequest, no file access, no trading operations, no external indicator dependency, and no account or broker restriction.
HOW IT WORKS
The indicator calculates the Bollinger Bands directly inside the code. It does not call iCustom and does not depend on any external custom indicator. The middle band is calculated from the selected applied price and selected moving average method. The upper and lower bands are then calculated with standard deviation and the selected deviation multiplier.
Nebryx BandPulse Matrix then analyzes the relationship between price, band width, band slope, and confirmed closed-bar behavior to produce chart context. It is intended to support discretionary analysis, not to replace trader judgment.
BOLLINGER BANDS LOGIC EXPLANATION
The middle band is calculated using the selected moving average method. The upper band is:
Upper Band = Middle Band + Standard Deviation * Deviation Multiplier
The lower band is:
Lower Band = Middle Band - Standard Deviation * Deviation Multiplier
The standard deviation is calculated from the selected applied price over the Bollinger Bands period. The default configuration uses a 20-period setting and a 2.0 deviation multiplier, which is a common starting point for volatility analysis.
SQUEEZE AND EXPANSION EXPLANATION
BandWidth is calculated as:
BandWidth = (Upper Band - Lower Band) / abs(Middle Band)
A squeeze is detected when the current BandWidth falls below the BandWidth SMA multiplied by the SqueezeThreshold input. This helps identify low-volatility compression periods.
An expansion is detected only after a prior squeeze condition and only on a confirmed closed bar. The indicator checks that BandWidth is increasing and that the new BandWidth is strong enough versus the threshold and ExpansionMultiplier. Expansion marks are not printed on the live bar.
BAND WALK CONTEXT EXPLANATION
A bullish band walk is detected when price closes near the upper band across the selected lookback window and the middle band is sloping upward. A bearish band walk is detected when price closes near the lower band across the selected lookback window and the middle band is sloping downward.
The middle band changes color according to the detected context:
- Neutral: no confirmed band-walk context.
- Bullish Walk: price is persistently near the upper band with upward middle-band slope.
- Bearish Walk: price is persistently near the lower band with downward middle-band slope.
MEAN REVERSION / STRETCH CONTEXT
When price closes above the upper band, the indicator can mark an Upper Stretch. When price closes below the lower band, it can mark a Lower Stretch. These markers are not buy or sell signals. They simply show that price is outside the volatility channel on a confirmed closed bar.
%B AND BANDWIDTH CONTEXT
The chart label displays %B and BandWidth for the latest confirmed closed bar. %B shows where the selected applied price is located inside or outside the band range. BandWidth shows the relative width of the Bollinger channel.
NON-REPAINTING EXPLANATION
The indicator does not use future bars. Important events such as squeeze markers, expansion markers, band-walk alerts, and stretch markers are confirmed on closed bars only. The live bar may update the band lines and live visual context while the candle is still forming, but confirmed signal markers are not printed on the current live bar.
This design prevents historical closed-bar markers from changing because of future data.
RECOMMENDED USAGE
Nebryx BandPulse Matrix can be used on Forex, indices, commodities, metals, crypto CFDs, and stocks if supported by the broker in MetaTrader 5. It can be used on multiple timeframes. Higher timeframes may provide cleaner volatility regimes, while lower timeframes may show more frequent compression and expansion cycles.
Suggested workflow:
1. Identify squeeze periods when volatility is compressed.
2. Watch for confirmed expansion after compression.
3. Use band-walk context to understand whether the market is trending along a band.
4. Treat stretch markers as overextension context, not as automatic reversal signals.
5. Combine the indicator with price action, support/resistance, session timing, and risk management.
INPUTS EXPLANATION
MaxHistoryBars: Limits how many recent bars are processed and displayed on first load. This helps keep the indicator efficient.
BBPeriod: Period used for the Bollinger Bands calculation.
DeviationMultiplier: Standard deviation multiplier for upper and lower bands.
AppliedPrice: Price type used in band calculations.
MAMethod: Moving average method used for the middle band.
SqueezeLookback: Lookback length for the BandWidth SMA baseline.
SqueezeThreshold: Relative threshold used to define squeeze. Lower values make squeeze detection stricter.
ExpansionMultiplier: Strength factor required to confirm expansion after squeeze.
WalkLookback: Number of bars used to evaluate band-walk context.
WalkDistanceFactor: Maximum distance from the active band as a fraction of the band range.
ShowBandFill: Turns the light volatility channel fill on or off.
ShowSqueeze: Turns squeeze context on or off.
ShowSqueezeZone: Turns squeeze zone dots and latest squeeze label on or off.
ShowExpansion: Turns expansion context on or off.
ShowExpansionMarks: Turns expansion markers on or off.
ShowBandWalkState: Shows or hides the chart state label.
ShowStretchMarks: Shows or hides Upper Stretch and Lower Stretch markers.
EnableAlerts: Master switch for alerts. Default is OFF.
AlertOnSqueeze: Enables squeeze alerts when EnableAlerts is true.
AlertOnExpansion: Enables expansion alerts when EnableAlerts is true.
AlertOnBandWalk: Enables band-walk alerts when EnableAlerts is true.
RISK DISCLAIMER
Trading financial markets involves risk. Nebryx BandPulse Matrix is an analytical tool and does not guarantee future results, winning trades, or profits. It does not provide financial advice and should not be used as the only basis for trading decisions. Always test any trading approach on a demo account or in the Strategy Tester before using it on a live account.
INSTALLATION INSTRUCTIONS
1. Open MetaTrader 5.
2. Go to File > Open Data Folder.
3. Open MQL5 > Indicators.
4. Copy NebryxBandPulseMatrix.ex5 or NebryxBandPulseMatrix.mq5 into the Indicators folder.
5. Restart MetaTrader 5 or refresh the Navigator panel.
6. Attach Nebryx BandPulse Matrix to a chart.
7. Adjust the inputs according to the symbol, timeframe, and personal analysis style.
NOTES FOR MQL5 MARKET USERS
- The indicator does not use DLL imports.
- The indicator does not use WebRequest.
- The indicator does not read or write files.
- The indicator does not execute trades.
- The indicator does not use iCustom or external custom indicators.
- Alerts are disabled by default.
- All important markers are based on closed-bar confirmation.
- The indicator is designed for efficient calculation using prev_calculated and MaxHistoryBars.
