‍

VolDivergence — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript, separate panel) What it does: A single-panel oscillator combining order-flow direction, volume-vs-price conviction, a trend/chop regime reference, and a real-time (no-lag) divergence score with directional alert arrows.

Note: This indicator's internal calculations are proprietary. This guide covers how to install, configure, and read the indicator — it intentionally does not document the underlying formulas or calculation methodology.

1. What Problem This Solves

Most oscillators either tell you direction (like RSI) or volume behavior (like OBV) but rarely combine them with a sense of how confident that reading is, or whether the broader market is trending vs. choppy. VolDivergence blends these into one panel:

• A direction + conviction reading (how strong the order-flow signal is, weighted by whether volume is confirming or contradicting the price move)
• A regime reference line showing whether the market is currently behaving more trend-like or more choppy/mean-reverting
• A continuous divergence score that compares where price sits in its recent range against where the oscillator sits in its own recent range — updating every bar, with no need to wait for a confirmed price pivot

3. What's On the Panel

Composite

• Appearance: Thick colored histogram bars (teal = bullish, coral = bearish)
• What It Represents: The main direction + conviction reading. Bars above zero suggest bullish pressure; below zero, bearish pressure. Taller bars indicate a stronger reading.

Regime

• Appearance: Thin gold line
• What It Represents: A reference for whether the market is currently trend-prone or choppy. Above zero leans trending, below zero leans choppy. This line is informational only — it does not change how the Composite bars are calculated.

Divergence

• Appearance: Thin purple line
• What It Represents: A continuous measure of tension between price action and the Composite reading, updating every bar.

Live label above the panel

• Appearance: Text reading "Bull NN", "Bear NN", or "Neutral"
• What It Represents: The current divergence reading in plain terms, with its 0–100 magnitude score.

Guide lines

• Appearance: Dashed teal/coral lines + a gray zero line
• What It Represents: Visual reference levels: the zero line and your Entry Threshold levels above/below it.

Arrows on the price panel

• Appearance: Teal up-arrow / coral down-arrow with a number
• What It Represents: Fire the moment the divergence score crosses your alert threshold — a real-time signal, not delayed by waiting for a confirmed pivot. The number shown is the live divergence score (0–100).

4. Settings Reference

Lookback (volume & price-move z-scores)

• Description: Window length used to gauge whether current volume and price movement are unusual relative to recent history
• Default: 20

Order Flow Sigma Period

• Description: Window length used to normalize bar-to-bar price change for the order-flow direction reading
• Default: 20

Order Flow Aggregation Period

• Description: How many bars of order-flow reading are aggregated together for the Composite's direction component
• Default: 10

Hurst Lookback

• Description: Window length used for the Regime reference line
• Default: 30

Divergence Scale (conviction tanh sensitivity)

• Description: Controls how sensitive the conviction component is to volume/price divergence
• Default: 1.5

Divergence Range Lookback

• Description: Window length used to compare price's position in its range against the oscillator's position in its own range
• Default: 20

Entry Threshold

• Description: Sets where the upper/lower dashed guide lines are drawn on the panel (visual reference, range 0–1)
• Default: 0.5

Divergence Alert Threshold (0-100)

• Description: The divergence score level that must be crossed to trigger an alert arrow
• Default: 50

5. How to Read the Panel

• Tall teal bars above zero = strong bullish direction with good conviction (volume is backing the move).
• Tall coral bars below zero = strong bearish direction with good conviction.
• Small/short bars near zero = weak or uncertain reading — direction and volume aren't lining up strongly either way.
• Gold Regime line above zero = conditions currently look more trend-prone; below zero = more choppy/range-bound. Use this as context, not as a trading trigger on its own.
• Purple Divergence line pulling away from zero, or the live "Bull/Bear NN" label showing a rising number = growing tension between what price is doing and what the oscillator is confirming — often a warning sign that the current move may be losing steam.
• Arrow appearing on the price chart = the divergence score just crossed your alert threshold in that direction. A down-arrow suggests bearish tension (price may turn down); an up-arrow suggests bullish tension (price may turn up). The number next to it is the live strength of that reading.

6. Suggested Starting Points

• Faster/more reactive readings: shorten the Lookback, Sigma Period, and Aggregation Period settings. Expect more signals, with more noise.
• Smoother/slower readings: lengthen those same settings. Expect fewer, more deliberate signals.
• Fewer divergence alerts: raise the Divergence Alert Threshold (closer to 100) so only strong tension triggers an arrow.
• More divergence alerts: lower the Divergence Alert Threshold (closer to the low end) to catch earlier, weaker tension.
• Regime line as a filter: many traders favor divergence signals occurring in a choppy regime (below zero) as a cleaner mean-reversion setup, and treat divergence during a strong trending regime (above zero) with more caution.

7. Troubleshooting

No bars/lines show up for the first stretch of the chart

• Likely Cause: The indicator needs a warm-up period based on your longest lookback setting
• Fix: Normal behavior — wait for enough bars, or load more chart history.

Divergence label always shows "Neutral"

• Likely Cause: Price and the Composite reading are staying in sync, or the small ±5 neutral zone around zero is filtering it out
• Fix: This can be a genuinely quiet market. Check if it changes on a more active session or shorter lookback settings.

No alert arrows appear

• Likely Cause: Divergence Alert Threshold may be set too high for current volatility
• Fix: Try lowering the threshold, or check that the panel is actively updating (bars are printing history/live data).

Composite bars seem to flip color very frequently

• Likely Cause: Lookback/Sigma settings may be too short for the instrument's typical noise level
• Fix: Lengthen Lookback , Order Flow Sigma Period , or Order Flow Aggregation Period .

Regime line rarely moves

• Likely Cause: Hurst Lookback may be long relative to your chart's typical price behavior
• Fix: Try shortening Hurst Lookback , or note that some instruments/timeframes are simply persistently trend-like or persistently choppy.

Quick Start Summary

1. Add the indicator to your chart (named VolumePriceConfluence in the indicator list; nicknamed VolDivergence ). It opens in its own panel.
2. Watch the Composite histogram for the primary direction + conviction read.
3. Use the gold Regime line as context for whether conditions favor trend-following or mean-reversion behavior.
4. Watch the purple Divergence line and the live "Bull/Bear NN" label for building tension between price and the oscillator.
5. Tune the Divergence Alert Threshold to control how many arrow alerts you get, and treat them as real-time — not delayed — signals.

‍

‍

‍

SMC Suite — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: An all-in-one Smart Money Concepts / ICT-style toolkit. Plots Fair Value Gaps (FVGs), tracks when they flip polarity into Inverse Fair Value Gaps (IFVGs), fires continuation entry signals when price retraces into a zone that agrees with the current trend, and draws Asia/London/New York session high-low levels. Every feature can be turned on or off independently.

1. What Problem This Solves

Manually marking Fair Value Gaps, watching for them to invert, tracking market structure, and drawing session ranges is time-consuming and easy to get inconsistent. SMC Suite automates all of it in one indicator, with clear toggles so you can use just the pieces you want — whether that's only FVGs, only session levels, or the full suite together with continuation signals.

3. Core Concepts (How Each Feature Works)

Fair Value Gaps (FVG)

A Fair Value Gap is a 3-bar price imbalance: - Bullish FVG: the low of the current bar is above the high of the bar two bars back — a gap on the upside. - Bearish FVG: the high of the current bar is below the low of the bar two bars back — a gap on the downside.

Each detected FVG is drawn as a colored rectangle box on the chart and tracked until it's either invalidated or ages out.

Inverse Fair Value Gaps (IFVG)

A plain FVG "flips polarity" the first time a candle closes all the way through it (a wick poking into the zone does not count — only a full close through it triggers the flip). Once inverted, the zone can flip again to fully "failed/removed" if price later closes back through the opposite side. Inverted zones are drawn in their own distinct colors.

Market Structure / Trend

The indicator determines trend using a simple break-of-structure (BOS) method based on fractal swing highs/lows (using your chosen Swing strength ). The trend flips bullish on a close above the last confirmed swing high, and bearish on a close below the last confirmed swing low.

Continuation Entries

When the current trend is bullish and price wicks into an active bullish FVG/IFVG zone and then closes back above it on an up-close bar, a continuation signal fires (mirrored for bearish trend + bearish zones). Each zone can only fire one continuation signal.

Trend-Restricted Display

Optionally, FVG and IFVG zones can be hidden unless their polarity currently matches the trend (e.g., only show bullish zones while the trend is bullish). The zone is still tracked internally either way — this setting only affects whether its box is drawn — so inversion bookkeeping and continuation signals keep working even while a zone is temporarily hidden from view.

Session High/Low Levels

Draws the high and low range for the Asia, London, and New York sessions, extended forward as solid lines while the session is active, then as dashed lines afterward until price closes through them (at which point that particular line is marked "broken" and stops extending).

Time zone handling: Session start/end times are defined in whichever time zone you choose under Session time zone . The indicator automatically reads your actual chart bar timestamps from NinjaTrader's own Options → General → Time Zone setting and converts between the two — including daylight saving time — so you don't need to manually shift the session hours to match your chart.

4. Settings Reference

1) FVG

Show FVG

• Description: Toggles plain (non-inverted) FVG zones
• Default: On

Restrict FVG display to trend

• Description: Only draws FVG zones whose polarity matches the current trend
• Default: Off

Max FVG/IFVG zones tracked

• Description: Maximum number of zones kept active at once; oldest is dropped when the limit is exceeded
• Default: 15

Max bars to keep a zone alive

• Description: How many bars a zone can persist before it's automatically removed
• Default: 750

2) IFVG

Show IFVG

• Description: Toggles inverted FVG zones
• Default: On

Restrict IFVG display to trend

• Description: Only draws IFVG zones whose polarity matches the current trend
• Default: Off

3) Continuation

Show continuation signals

• Description: Toggles the continuation entry arrows
• Default: On

Swing strength (bars each side)

• Description: Number of bars on each side used to confirm a fractal swing high/low for trend detection
• Default: 3

4) Session Time Zone

Session time zone (Windows TZ ID)

• Description: The time zone the session Start/End hours below are defined in. Type a Windows time zone ID, e.g. Eastern Standard Time , Central Standard Time , Mountain Standard Time , Pacific Standard Time , GMT Standard Time (London), Tokyo Standard Time , UTC .
• Default: Eastern Standard Time

5) Asia Session

Show Asia session H/L

• Description: Toggles the Asia session range
• Default: On

Asia start hour / minute

• Description: Session start time (24-hour)
• Default: 18:00

Asia end hour / minute

• Description: Session end time (24-hour)
• Default: 03:00

6) London Session

Show London session H/L

• Description: Toggles the London session range
• Default: On

London start hour / minute

• Description: Session start time (24-hour)
• Default: 03:00

London end hour / minute

• Description: Session end time (24-hour)
• Default: 08:00

7) New York Session

Show NY session H/L

• Description: Toggles the New York session range
• Default: On

NY start hour / minute

• Description: Session start time (24-hour)
• Default: 08:00

NY end hour / minute

• Description: Session end time (24-hour)
• Default: 17:00

8) Colors

Bullish FVG

• Description: Color of bullish (non-inverted) FVG zones
• Default: Lime Green

Bearish FVG

• Description: Color of bearish (non-inverted) FVG zones
• Default: Orange Red

Bullish IFVG

• Description: Color of inverted zones now acting bullish
• Default: Cyan

Bearish IFVG

• Description: Color of inverted zones now acting bearish
• Default: Hot Pink

Continuation Up arrow

• Description: Color of bullish continuation signal arrows
• Default: Lime

Continuation Down arrow

• Description: Color of bearish continuation signal arrows
• Default: Red

Asia session lines

• Description: Color of Asia session high/low lines
• Default: Goldenrod

London session lines

• Description: Color of London session high/low lines
• Default: Medium Orchid

NY session lines

• Description: Color of New York session high/low lines
• Default: Deep Sky Blue

5. How to Read the Chart

• Green box = bullish FVG zone (default color)
• Orange/red box = bearish FVG zone (default color)
• Cyan box = inverted zone now acting bullish (IFVG)
• Pink box = inverted zone now acting bearish (IFVG)
• Lime up-arrow = bullish continuation signal (trend is up, price retraced into a bullish zone and closed back above it)
• Red down-arrow = bearish continuation signal (mirrored for downtrend)
• Solid session lines = the session is currently active; the high/low is still being updated live
• Dashed session lines = the session has ended; the line remains as a reference level until price closes through it, at which point that line stops extending

6. Suggested Starting Points

• New to the suite: start with all features on at their defaults to see the full picture, then turn off whichever pieces you don't use (e.g. disable sessions if you only want FVG/IFVG zones).
• Cleaner chart, fewer zones: lower Max FVG/IFVG zones tracked and/or Max bars to keep a zone alive .
• Trade only with-trend setups: turn on Restrict FVG display to trend and Restrict IFVG display to trend so only zones aligned with the current structure are visible — useful if you're pairing this with the companion ICTFVGStrategy, since it mirrors the same filter.
• Faster/slower trend detection: decrease Swing strength for a more reactive (but noisier) trend read; increase it for a slower, more confirmed read.
• Non-US trading sessions: adjust the session hours and the Session time zone setting to match the sessions relevant to your instrument.

7. Troubleshooting

No FVG/IFVG zones appear

• Likely Cause: Show FVG / Show IFVG are off, or Restrict ... to trend is hiding zones that don't currently match the trend
• Fix: Confirm the Show toggles are on; temporarily turn off the trend-restriction toggles to confirm zones are being detected at all.

Zones disappear quickly

• Likely Cause: Max bars to keep a zone alive is set low, or Max FVG/IFVG zones tracked is capping the count and pushing out older zones
• Fix: Increase either setting.

No continuation arrows appear

• Likely Cause: Show continuation signals is off, or price simply hasn't retraced into a zone matching the current trend
• Fix: Confirm the toggle is on; note this signal requires the zone's polarity to match the trend, so it won't fire during counter-trend retracements by design.

Session lines appear at the wrong time of day

• Likely Cause: Session time zone doesn't match what you intended, or NinjaTrader's own Options → General → Time Zone setting has changed
• Fix: Double check the Session time zone field against the actual times you want; the indicator converts automatically from NinjaTrader's platform time zone, so as long as that platform setting is correct, only the Session time zone field needs adjusting.

Session lines don't show at all

• Likely Cause: The relevant Show ... session H/L toggle is off
• Fix: Turn on Show Asia/London/NY session H/L as needed.

Trend seems to flip more/less often than expected

• Likely Cause: Swing strength controls how strict the fractal swing detection is
• Fix: Increase for fewer, more confirmed trend flips; decrease for a faster-reacting trend read.

Quick Start Summary

1. Add the indicator to your chart (named ICTFVGSuite in the indicator list; nicknamed SMC Suite ).
2. Leave all features on at their defaults for the full experience, or disable pieces you don't need.
3. Watch for colored zone boxes (FVG/IFVG) and continuation arrows for entry context.
4. Use the Asia/London/NY session lines as reference levels — solid while active, dashed and inactive once the session ends, until price closes through them.
5. If you want the chart to only highlight trend-aligned zones, turn on Restrict FVG display to trend and Restrict IFVG display to trend .
6. Double-check Session time zone matches your intended session hours if the levels look off.

‍

‍

Ribbon Pro — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: Draws a 6-line moving-average "ribbon" (default lengths 8/13/21/34/55/89) with extra blended lines packed between each pair, colored in a smooth light-blue → navy gradient — so instead of 6 thin separate lines, it reads as one solid, filled-looking ribbon. The moving average type used for all 6 lines is now selectable (EMA, SMA, WMA, HMA, VMA, KAMA, or VWMA). It also fires an alert the moment all 6 lines snap into perfect bullish or bearish alignment.

1. What Problem This Solves

A classic multi-line "ribbon" is normally just several separate moving average lines. When they're spread apart it can look thin and hard to read at a glance. Ribbon Pro fills in the visual gaps between each pair of lines with extra interpolated lines and a color gradient, so the ribbon looks like a solid, filled band without needing NinjaScript's more complex polygon-fill drawing tools. It also gives you a one-time alert (not a repeating spam of alerts) when the ribbon becomes "fully stacked" — a classic sign of trend confirmation.

What's new in this version: Previously the ribbon was built only from EMAs. You can now choose which moving average type powers all 6 lines, so the ribbon's character can be tuned — from smoother/laggier (SMA) to faster/more adaptive (HMA, KAMA) — without changing the underlying ribbon/gradient logic.

3. How It Works (Plain English)

• The indicator calculates 6 "real" moving average lines at the lengths you set (default: 8, 13, 21, 34, 55, 89 — a Fibonacci-style spread), all using whichever MA Type you've selected.
• Between every pair of neighboring lines, it adds 3 extra lines that are simple straight-line blends between the two real values — not separate calculations of their own.
• All 21 lines (6 real + 15 blended) are colored along one smooth gradient from light sky blue (shortest length) to navy (longest length). The 6 real lines are drawn slightly thicker so you can still pick them out if needed.
• Packed tightly together with the gradient, the whole thing reads visually as a single filled ribbon rather than 6 separate wires.
• Separately, it watches only the 6 real lines : if they ever line up in perfect order — each one above the next (bullish) or each one below the next (bearish) — that's a "fully stacked" ribbon, a classic sign the trend is well confirmed across all the lengths in the ribbon. The alert for this fires once , right when the stack first forms, not on every bar it continues to hold.

4. Settings Reference

1. Ribbon

Ribbon Length 1

• Description: Shortest MA length
• Default: 8

Ribbon Length 2

• Description: 2nd MA length
• Default: 13

Ribbon Length 3

• Description: 3rd MA length
• Default: 21

Ribbon Length 4

• Description: 4th MA length
• Default: 34

Ribbon Length 5

• Description: 5th MA length
• Default: 55

Ribbon Length 6

• Description: Longest MA length
• Default: 89

MA Type

• Description: Which moving average type powers all 6 ribbon lines — EMA, SMA, WMA, HMA, VMA, KAMA, or VWMA
• Default: EMA

VMA Volatility Period

• Description: Volatility lookback used only when MA Type = VMA
• Default: 20

KAMA Fast Period

• Description: Fast-end period used only when MA Type = KAMA
• Default: 2

KAMA Slow Period

• Description: Slow-end period used only when MA Type = KAMA
• Default: 30

2. Alerts

Enable Alignment Alerts

• Description: Turns on the "fully stacked" bullish/bearish alert
• Default: On

5. Choosing an MA Type

EMA (default)

• Character: Balanced responsiveness; weights recent bars more heavily
• Good For: General-purpose ribbon use, most trading styles

SMA

• Character: Smoothest, slowest to react
• Good For: Longer-term trend context, fewer false stacks

WMA

• Character: Similar to EMA but with a straight-line weighting taper
• Good For: Slightly different responsiveness curve than EMA

HMA (Hull MA)

• Character: Fast and smooth, reduces lag noticeably
• Good For: Traders wanting quicker signals without as much choppiness

VMA

• Character: Adjusts its own responsiveness based on volatility (uses VMA Volatility Period )
• Good For: Instruments where volatility regime changes often

KAMA

• Character: Adaptive; speeds up in trends and slows down in chop (uses KAMA Fast/Slow Period )
• Good For: Choppy instruments where you want fewer whipsaws

VWMA

• Character: Weights by volume instead of just time
• Good For: Instruments where volume spikes are meaningful (e.g. futures, active stocks)

Note: VMA Volatility Period , KAMA Fast Period , and KAMA Slow Period only matter when their corresponding MA Type is selected — they're ignored otherwise.

6. How to Read the Chart

• Ribbon color leaning light blue near price, navy further away = normal gradient look, no directional meaning by itself.
• Ribbon widening / lines spreading apart = increasing separation between short and long lines, generally a sign of a strengthening trend.
• Ribbon narrowing / lines converging or crossing = lines bunching together, generally a sign of consolidation or a potential trend change.
• Price sitting cleanly above the whole ribbon = broadly bullish positioning.
• Price sitting cleanly below the whole ribbon = broadly bearish positioning.
• Price chopping through the middle of the ribbon = no clear trend / choppy conditions.
• "Fully stacked" alert firing = all 6 real lines have just lined up in perfect ascending (bullish) or descending (bearish) order — a stronger trend-confirmation signal than just 2 lines crossing.

7. Suggested Starting Points

• Default lengths (8/13/21/34/55/89) with EMA work well as a general-purpose trend ribbon on most timeframes.
• Shorter set (e.g. 5/8/13/21/34/55) reacts faster, good for lower timeframes or more active trading — but will "stack/unstack" more often.
• Longer set (e.g. 13/21/34/55/89/144) smooths things out for swing trading or higher timeframes, at the cost of slower signals.
• Choppy instruments: try KAMA or VMA instead of EMA — both are designed to adapt to changing volatility/trend conditions and can reduce false "stacked" alerts.
• Want less lag with less noise than EMA: try HMA .
• Keep the lengths in ascending order (Length 1 < Length 2 < ... < Length 6) — the ribbon assumes that ordering for both the visual layout and the alignment alert logic.

8. Troubleshooting

No lines show up for the first stretch of the chart

• Likely Cause: Needs enough bars to warm up (based on your longest ribbon length)
• Fix: Normal — wait for enough bars to load, or load more chart history.

Ribbon looks like separate thin lines instead of a solid band

• Likely Cause: Chart zoomed out too far, or the 6 lengths are spread very far apart
• Fix: Zoom in, or bring the 6 lengths closer together for a tighter-looking ribbon.

Alignment alert never fires

• Likely Cause: Lengths aren't in increasing order, or the instrument simply hasn't had a clean 6-line stack occur
• Fix: Double check Length 1 < Length 2 < ... < Length 6. Otherwise, this is a real (if infrequent) signal — it only fires on genuine full alignment.

Alert fires only once even though the trend is still going

• Likely Cause: This is by design — it's meant to flag the moment the stack forms, not repeat every bar it holds
• Fix: If you want ongoing reminders, this indicator doesn't include that; consider pairing it with another continuation-alert indicator.

Changing MA Type doesn't seem to change anything

• Likely Cause: VMA/KAMA-specific settings only apply when that type is selected; other types will look different from each other but may look visually similar at a glance depending on your lengths
• Fix: Compare with a shorter lookback or on a more volatile instrument to see the difference more clearly.

Colors look off / not a smooth gradient

• Likely Cause: Custom lengths changed how many total plots exist, or a NinjaTrader color theme is overriding it
• Fix: The gradient logic itself doesn't depend on the ribbon lengths or MA Type, so this is unlikely — try removing and re-adding the indicator after any changes.

Quick Start Summary

1. Add the indicator to your chart (named MMRibbonAvg in the indicator list; nicknamed Ribbon Pro ).
2. Leave the default Fibonacci-style lengths (8/13/21/34/55/89) and EMA for general use, or adjust to taste — keeping lengths in ascending order.
3. Pick an MA Type that suits your instrument/style — EMA for balance, SMA for smoothness, HMA for responsiveness, VMA/KAMA for adaptive volatility handling, VWMA for volume-weighted behavior.
4. Read ribbon width and slope for trend strength/direction; watch for price crossing through it.
5. Turn on Enable Alignment Alerts to get a one-time notification when all 6 lines snap into full bullish or bearish alignment.

‍

‍

Our strategies do NOT ship with recommened parameters, users are responible for testing and entering parameters that meet their needs. You are responsible for defining and executing your own parameters.

Scalp Bands — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: A Bollinger Band mean-reversion signal tool. It watches for price rejecting the outer Bollinger Bands, filters those rejections through a session-time window, a "choppy market" regime check, and a "band walk" strength filter, then plots Long/Short arrows with volume-profile-based conviction, dashed take-profit/stop-loss lines, and an optional volatility-regime background tint.

1. What Problem This Solves

A basic "price touched the Bollinger Band" signal fires constantly and is often wrong — especially when the market is trending strongly (band walking) rather than ranging. Scalp Bands stacks several filters on top of the raw signal so it only fires when conditions look more favorable for a reversion trade:

• Only trade during a chosen time window (e.g. morning session)
• Only trade when regime suggests the market is choppy, not strongly trending
• Skip signals if price has been "walking the band" (repeatedly closing/wicking outside it) — that's trend behavior, not reversion behavior
• Boost confidence in a signal if it lines up with the session's Point of Control (the price level with the most traded volume)
• Automatically draws a suggested take-profit and stop-loss for each signal

3. How It Works (Plain English)

Signals are only generated when all enabled filters agree . The logic runs in this order each bar:

1. Session Filter — if enabled, only bars inside your chosen start/end time count. Outside that window, no signals are generated at all.
2. Rolling Point of Control (POC) — over your chosen lookback, the indicator tallies volume at each price level to find the single price with the most traded volume recently. This is used later for "conviction" labeling.
3. Volatility Regime background — if enabled, tints the chart background based on whether the Bollinger Band width is currently wider or narrower than it was N bars ago (expanding vs. contracting volatility).
4. Band Walk Filter — looks back over recent bars and scores how much price has been closing or wicking outside the bands. If that score is too high (price has been "walking" the band, i.e., trending), no new signal fires — that's not a mean-reversion setup.
5. MR Regime Engine (RSI filter) — if enabled, requires RSI to be inside a "chop zone" (between your lower and upper thresholds) before allowing a signal. This tries to avoid taking reversion trades during a strong directional move.
6. Signal check:
7. Short signal: the current bar opened above the upper band, closed back below/at it, and closed red (bearish) — a rejection of the upper band.
8. Long signal: the current bar opened below the lower band, closed back above/at it, and closed green (bullish) — a rejection of the lower band.
9. Target selection: the take-profit target band (upper/middle/lower) is chosen based on the current ADX reading — low ADX (weak trend) aims for the far band, mid ADX aims for the middle band. The actual TP line is placed at a percentage of the way to that target band ( TP Percent ). Stop-loss is placed a fixed number of ticks away ( Stop Loss Ticks ).
10. POC Conviction: if the signal's direction agrees with where price sits relative to the rolling POC, the label is shown in gold ("POC Reversion Signal") instead of the normal signal color — a visual cue that this setup has extra confluence.

4. Settings Reference

1. Session Filter

Enable Session Filter

• Description: Turns the time window on/off
• Default: On

Session Start (HHMMSS)

• Description: Start of the allowed trading window, in 24-hour HHMMSS format (e.g. 80000 = 8:00:00 AM)
• Default: 80000

Session End (HHMMSS)

• Description: End of the allowed trading window
• Default: 125500 (12:55:00 PM)

2. MR Regime Engine

Enable MR Regime Engine

• Description: Requires Regime to be in the chop zone before signals fire

Look Back Multiplier

• Description: Regime period

Anti Down Trend Parameter

• Description: Lower regime bound of the chop zone

Anti Up Trend Parameter

• Description: Upper regime bound of the chop zone

3. Band Walk Filter

Candle Look Back

• Description: How many recent bars to score for band-walking behavior

Threshold

• Description: Score above which a new signal is blocked (market judged to be "walking" the band)

Close Outside Weight

• Description: Points added per bar where the close was outside the band (a stronger signal of walking)

Wick Outside Weight

• Description: Points added per bar where only a wick poked outside the band

4. POC Conviction

POC Lookback Bars

• Description: How many recent bars are used to build the rolling volume profile / find POC

TP/SL Line Width (bars)

• Description: How far back (visually) the TP/SL dashed lines extend on the chart

5. Trade Management

BB Period

• Description: Bollinger Band period

BB Std Dev

• Description: Bollinger Band standard deviation multiplier

ADX Period

• Description: ADX period, used to pick the TP target band

Low ADX Threshold (target = far band)

• Description: Below this ADX, TP targets the far/opposite band

Mid ADX Threshold (target = middle)

• Description: Between Low and Mid, TP targets the middle band; at/above Mid it also targets the far band per current logic

Stop Loss Ticks

• Description: Fixed stop-loss distance, in ticks

TP Percent

• Description: How far (as a % of the distance to the target band) the take-profit is placed

6. Volatility Regime

Enable Volatility Regime

• Description: Turns the background tint on/off
• Default: On

BB Width Lookback (bars)

• Description: How many bars back to compare current band width against

7. EMA

Show EMA

• Description: Toggles the EMA overlay line

EMA Period

• Description: EMA length

8. Bollinger Bands

Show Bollinger Bands

• Description: Toggles the visible BB lines (bands are still calculated internally even if hidden, since signals depend on them)

5. How to Read the Chart

• Green rectangle + up arrow below a bar = Long signal (rejection of the lower band)
• Red rectangle + down arrow above a bar = Short signal (rejection of the upper band)
• Gold-colored label ("... POC Reversion Signal") = the signal has extra conviction because it agrees with the rolling Point of Control
• Plain colored label ("... Mean Reversion") = a normal signal without POC confluence
• Green dashed line labeled "TP" = suggested take-profit level for that signal
• Red dashed line labeled "SL" = suggested stop-loss level for that signal
• Soft blue background tint = volatility regime judged to be expanding (bands widening)
• Soft orange background tint = volatility regime judged to be contracting (bands narrowing)
• White line = EMA (if enabled)
• Blue outer lines + gray dashed middle line = Bollinger Bands (if enabled)

Important: the TP/SL lines and labels drawn on the chart are visual suggestions only — this indicator does not place trades or manage orders. You'd need a connected strategy or manual execution to act on them.

6. Suggested Starting Points

• Tighter/faster scalping: shorter BB Period, tighter Session window, lower Stop Loss Ticks.
• Fewer, higher-conviction signals: raise the Band Walk Threshold requirement (lower the threshold value itself to be stricter), tighten the RSI chop zone, and pay attention mainly to gold "POC Reversion" labels.
• Choppier/range-bound instruments tend to suit this indicator's core premise (band rejection) better than strongly trending ones — that's exactly what the Band Walk and RSI Regime filters are trying to detect and avoid.
• Always validate Session Start/End against your own time zone and NinjaTrader's chart time settings — HHMMSS is a raw 24-hour format with no AM/PM label.

7. Troubleshooting

No signals ever appear

• Likely Cause: Session Filter window may not match your chart's time zone, or filters are too strict
• Fix: Double-check Session Start/End against your chart's actual time. Try temporarily disabling the MR Regime Engine and Band Walk filter to confirm the base signal logic is firing.

Signals only appear at certain times of day

• Likely Cause: This is expected — the Session Filter restricts signals to your chosen window
• Fix: Adjust or disable Enable Session Filter if you want signals all session.

Background isn't changing color

• Likely Cause: Volatility Regime disabled, or band width hasn't crossed the lookback comparison yet
• Fix: Confirm Enable Volatility Regime is on and enough bars have loaded ( CurrentBar > BB Width Lookback ).

TP/SL lines look extremely far away or very close

• Likely Cause: ADX-based target selection and TP Percent are doing their job, but may need tuning for your instrument's volatility
• Fix: Adjust TP Percent , Low/Mid ADX Threshold , and Stop Loss Ticks to match your instrument's typical range.

Too many signals during strong trends

• Likely Cause: Band Walk Filter or RSI Regime filter may be too lenient
• Fix: Lower the Band Walk Threshold (stricter) and/or tighten the RSI chop zone (raise the lower bound, lower the upper bound).

EMA or Bollinger Bands not visible

• Likely Cause: Their respective "Show" toggles are off
• Fix: Enable Show EMA and/or Show Bollinger Bands .

Quick Start Summary

1. Add the indicator to your chart (named ScalperProIND in the indicator list; nicknamed Scalp Bands ).
2. Set your Session Start/End to match the hours you actually want to trade.
3. Leave the MR Regime Engine and Band Walk Filter on for a start — they exist specifically to cut down on bad signals during trending conditions.
4. Watch for green/red arrows with rectangles; gold-colored labels indicate extra POC-based conviction.
5. Use the drawn TP/SL dashed lines as a starting reference, and adjust TP Percent / Stop Loss Ticks to match your own risk tolerance.
6. This indicator only draws signals and levels — it does not place or manage trades automatically.

‍

‍

Our strategies do NOT ship with recommened parameters, users are responible for testing and entering parameters that meet their needs. You are responsible for defining and executing your own parameters.

VWAP Reversion — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: Plots a session VWAP (Volume-Weighted Average Price) with ±1 and ±2 standard deviation bands, shades the outer deviation zones, and draws arrows when price has spent a stretch of time beyond the ±1σ band and then closes back inside it — a classic "reversion to VWAP" signal.

1. What Problem This Solves

VWAP is one of the most widely watched intraday reference levels — it tells you the average price paid so far in the session, weighted by volume. This indicator goes further than a plain VWAP line by adding:

• Statistically-based deviation bands (like Bollinger Bands, but anchored to VWAP)
• Shaded "extreme" zones so you can see at a glance when price is stretched
• Automatic arrows that mark the moment price snaps back inside the ±1σ band after spending a confirmed stretch of time beyond it

3. How It Works (Plain English)

• VWAP calculation: Each bar's typical price (High+Low+Close ÷ 3), weighted by that bar's volume, is accumulated from the session reset point onward. VWAP = total volume-weighted price ÷ total volume so far.
• Standard deviation bands: The indicator also tracks how far price has varied from VWAP (volume-weighted), and plots bands at your chosen multiples above and below VWAP (default ±1σ and ±2σ).
• Session reset: Once per calendar day, when the bar time reaches your chosen Session Reset Time , all VWAP totals reset to zero and a fresh calculation begins. This uses a straightforward time/date check rather than NinjaTrader's built-in "first bar of session" flag, specifically so it lines up with your actual reset time (e.g. the 9:30 AM RTH open) rather than the overnight Globex session open.
• Reversion arrows: If price closes beyond the ±1σ band for a set number of consecutive bars ( Bars To Confirm ), the setup becomes "armed." The arrow is drawn the moment price then closes back inside the ±1σ band — this is the reversion signal.

4. Settings Reference

1. VWAP Settings

Std Dev 1

• Description: Multiplier for the inner band (±1σ)
• Default: 1.0

Std Dev 2

• Description: Multiplier for the outer band (±2σ)
• Default: 2.0

Session Timezone

• Description: Label only — tells you which timezone to enter the reset time in (Eastern, UTC, London, Tokyo). It does not convert anything automatically.
• Default: Eastern

Session Reset Time (HHMMSS)

• Description: The time of day VWAP resets, as a 24-hour HHMMSS integer, entered in whatever timezone your chart's timestamps are displayed in. E.g. 93000 = 09:30:00.
• Default: 93000 (9:30:00 AM)

2. Zone Display

Show Zones

• Description: Toggles the shaded deviation zones
• Default: On

Zone Opacity %

• Description: Transparency of the shaded zones
• Default: 25

Upper Zone Color (+1σ to +2σ)

• Description: Color of the shaded zone above the +1σ band
• Default: Red

Lower Zone Color (-2σ to -1σ)

• Description: Color of the shaded zone below the -1σ band
• Default: Green

3. Breakout Arrows

Show Reversion Arrows

• Description: Toggles the reversion arrow signals
• Default: On

Bars To Confirm

• Description: Number of consecutive bars price must close beyond ±1σ before the setup is "armed" for a reversion arrow
• Default: 3

5. How to Read the Chart

• Gold line = VWAP (the volume-weighted average price for the current session)
• Dim gray lines = ±1σ bands
• Red line = +2σ band (upper)
• Green line = -2σ band (lower)
• Shaded red zone = price is between +1σ and +2σ — stretched to the upside
• Shaded green zone = price is between -1σ and -2σ — stretched to the downside
• Red down-arrow = price spent your confirmed number of bars beyond +1σ, then closed back inside — a potential downward reversion toward VWAP
• Green up-arrow = price spent your confirmed number of bars beyond -1σ, then closed back inside — a potential upward reversion toward VWAP

Important: an important detail about the "Session Timezone" setting — it is a label only , meant to remind you which timezone to think in. It does not automatically convert your Reset Time. Always enter the Reset Time to match whatever timezone your chart's own timestamps are displayed in, or the reset will fire at the wrong point in the session.

6. Suggested Starting Points

• Standard RTH VWAP (US equity index futures like ES/NQ): keep the default 93000 reset time if your chart is in Eastern time.
• 24-hour or non-US session instruments: set the Reset Time to whatever your true session open is, matched to your chart's timezone.
• Fewer, more confirmed reversion signals: increase Bars To Confirm .
• More frequent, faster signals: decrease Bars To Confirm , at the cost of more false signals from brief spikes.
• Widen or tighten the "stretched" definition: adjust Std Dev 1 and Std Dev 2 — smaller values make the bands (and therefore the zones/arrows) trigger more easily; larger values require a bigger move from VWAP.

7. Troubleshooting

VWAP resets at the wrong time of day

• Likely Cause: Session Reset Time doesn't match your chart's displayed timezone
• Fix: Re-enter the Reset Time using the same timezone your chart's x-axis shows, referencing the Session Timezone label as a reminder of which zone you intended.

VWAP looks like it never resets, or resets more than once a day

• Likely Cause: Reset logic compares calendar date, so this shouldn't happen under normal daily sessions — check for unusual session templates or multi-day bar types
• Fix: Confirm you're on an intraday bar type with normal daily sessions; this indicator is designed for a once-per-day reset, not multi-day or tick-based edge cases.

No shaded zones appear

• Likely Cause: Show Zones is off, or not enough bars have loaded yet
• Fix: Turn on Show Zones ; confirm the chart has at least a couple of bars since session reset.

No arrows appear

• Likely Cause: Show Reversion Arrows is off, or price hasn't held beyond ±1σ for the full Bars To Confirm length
• Fix: Turn on Show Reversion Arrows ; try lowering Bars To Confirm to see if signals appear with a shorter confirmation requirement.

Zone colors look off after changing them

• Likely Cause: Direct2D brushes are cached for performance and only rebuilt when needed
• Fix: This should update automatically; if not, try removing and re-adding the indicator.

Quick Start Summary

1. Add the indicator to your chart (named SVWAP Indicator in the indicator list; nicknamed VWAP Reversion ).
2. Set Session Reset Time to match your session's true open, in your chart's own displayed timezone.
3. Leave Std Dev 1/2 at defaults (1.0 / 2.0) for a standard reversion read, or widen/tighten to taste.
4. Watch for price entering the shaded zones, then look for the arrow marking the close back inside ±1σ as the reversion signal.
5. Tune Bars To Confirm to balance signal frequency against confirmation strength.

‍

‍

‍

Market Structure + — User Guide

(NinjaScript file name: MarketStructureSRPatterns.cs )

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: A beginner-friendly, all-in-one price-action toolkit combining four independently toggleable features: Market Structure (Higher High/Higher Low/Lower High/Lower Low labeling with an optional zig-zag line), Support & Resistance (auto-drawn, auto-removed rays from confirmed swing points), Candlestick Patterns (Hammer, Shooting Star, Bullish/Bearish Engulfing), and Chart Patterns (Double Top, Double Bottom, Head & Shoulders, Inverse Head & Shoulders).

1. What Problem This Solves

Most traders learning price action end up needing several separate tools — one for swing structure, one for support/resistance, one for candlestick patterns, one for chart patterns — each with its own visual language that doesn't always match the others. Market Structure + combines all four into a single indicator with one consistent color rule everywhere : green means bullish, red means bearish. It's also designed specifically to stay readable — labels scale with volatility instead of using fixed pixel/tick offsets, tiny insignificant swings are filtered out, and candlestick signals use small shapes with a cooldown period instead of piling up overlapping text.

3. The Four Features (Plain English)

1) Market Structure

Identifies swing highs and lows using a symmetric fractal check (a certain number of bars on each side must be lower/higher), then labels each new swing relative to the prior one of the same type: - HH (Higher High) — bullish structure signal - HL (Higher Low) — bullish structure signal - LH (Lower High) — bearish structure signal - LL (Lower Low) — bearish structure signal

An optional zig-zag line connects consecutive swing points so you can see the overall structure shape at a glance. A built-in noise filter ignores swings that are too small (as a % move) to be meaningful, which keeps the chart from getting cluttered during choppy, sideways action.

2) Support & Resistance

Every confirmed swing high draws a resistance ray; every confirmed swing low draws a support ray. Nearby levels within your tolerance are merged rather than duplicated, only your configured maximum number of levels per side are kept (oldest drop off first), and a level is automatically marked "broken" — and optionally removed — once price closes convincingly through it.

3) Candlestick Patterns

Detects three classic single/two-candle reversal patterns: - Hammer — small body, long lower wick, short upper wick; bullish reversal signal (shown as a green triangle/arrow). - Shooting Star — small body, long upper wick, short lower wick; bearish reversal signal (shown as a red triangle/arrow). - Bullish/Bearish Engulfing — a candle whose body fully engulfs the prior candle's body in the opposite direction (shown as a colored diamond).

These can optionally require trend context (e.g. a Hammer is only flagged if it occurs at a fresh recent low) and always respect a cooldown period so the same pattern type doesn't fire repeatedly bar after bar.

4) Chart Patterns

Built from the same swing-pivot detection as Market Structure, looking for: - Double Top — two similar-height swing highs in a row → bearish label - Double Bottom — two similar-depth swing lows in a row → bullish label - Head & Shoulders — three swing highs where the middle one is meaningfully higher than the two outer ones (which are roughly equal) → bearish label - Inverse Head & Shoulders — the mirrored bullish version using swing lows

4. Settings Reference

1. Market Structure

Enable Market Structure

• Description: Master toggle for this feature
• Default: On

Swing Strength (bars each side)

• Description: How many bars on each side must confirm a swing point; higher = fewer, more significant swings
• Default: 8

Noise Filter: Min Swing Move %

• Description: Ignores swings smaller than this % move from the last one, to reduce clutter in choppy markets
• Default: 0.10

Show Higher Highs (HH)

• Description: Toggles the HH label
• Default: On

Show Higher Lows (HL)

• Description: Toggles the HL label
• Default: On

Show Lower Highs (LH)

• Description: Toggles the LH label
• Default: On

Show Lower Lows (LL)

• Description: Toggles the LL label
• Default: On

Show ZigZag Line

• Description: Connects consecutive swing points with a line
• Default: On

2. Support Resistance

Enable Support & Resistance

• Description: Master toggle for this feature
• Default: On

Max Levels Per Side

• Description: Maximum number of active support/resistance rays kept at once, per side
• Default: 4

Merge/Break Tolerance (%)

• Description: How close a new swing must be to an existing level to merge into it, and how far price must close beyond a level to mark it broken
• Default: 0.15

Line Width

• Description: Thickness of the drawn rays
• Default: 2

Remove Level When Broken

• Description: Deletes a level's drawing once price breaks through it (otherwise it stays but is marked inactive)
• Default: On

3. Candlestick Patterns

Enable Candlestick Patterns

• Description: Master toggle for this feature
• Default: On

Show Hammer

• Description: Toggles Hammer detection
• Default: On

Show Shooting Star

• Description: Toggles Shooting Star detection
• Default: On

Show Engulfing

• Description: Toggles Bullish/Bearish Engulfing detection
• Default: On

Show Text Labels (in addition to shapes)

• Description: Adds a text label alongside the shape marker
• Default: Off

Max Body / Range Ratio

• Description: Maximum candle body size (as a fraction of its full range) to qualify as a Hammer/Star
• Default: 0.30

Min Long-Wick / Range Ratio

• Description: Minimum long-wick size (as a fraction of range) required for a Hammer/Star
• Default: 0.60

Max Short-Wick / Range Ratio

• Description: Maximum size allowed for the opposite (short) wick
• Default: 0.15

Require Trend Context

• Description: Only flags Hammer/Star patterns occurring at a fresh recent low/high
• Default: On

Trend Lookback (bars)

• Description: Lookback window used for the trend-context check
• Default: 10

Min Engulfing Body (x ATR)

• Description: Minimum candle body size, in ATR units, required to qualify as a genuine Engulfing pattern (filters out tiny noise candles)
• Default: 0.50

Cooldown Between Signals (bars)

• Description: Minimum bars between any two candlestick pattern signals
• Default: 3

4. Chart Patterns

Enable Chart Patterns

• Description: Master toggle for this feature
• Default: On

Show Double Top

• Description: Toggles Double Top detection
• Default: On

Show Double Bottom

• Description: Toggles Double Bottom detection
• Default: On

Show Head & Shoulders

• Description: Toggles Head & Shoulders detection
• Default: On

Show Inverse Head & Shoulders

• Description: Toggles Inverse Head & Shoulders detection
• Default: On

Peak/Trough Similarity Tolerance (%)

• Description: How close two peaks/troughs must be in price to count as "matching"
• Default: 0.25

Min Head Prominence (%)

• Description: How much higher/lower the "head" must be than the two "shoulders"
• Default: 0.15

5. Colors

Bullish Color

• Description: Used for HH/HL labels, bullish candlestick patterns, and bullish chart patterns
• Default: Lime Green

Bearish Color

• Description: Used for LH/LL labels, bearish candlestick patterns, and bearish chart patterns
• Default: Red

Resistance Line Color

• Description: Color of resistance rays
• Default: Orange

Support Line Color

• Description: Color of support rays
• Default: Dodger Blue

ZigZag Line Color

• Description: Color of the structure zig-zag line
• Default: Gray

6. Display

Show Legend

• Description: Displays an on-chart legend explaining the colors and shapes
• Default: On

5. How to Read the Chart

• Green "HH"/"HL" labels = bullish market structure (higher highs and/or higher lows forming).
• Red "LH"/"LL" labels = bearish market structure (lower highs and/or lower lows forming).
• Gray zig-zag line = connects the swing points so you can see the structure's overall shape.
• Orange lines = resistance levels; blue lines = support levels. A line disappearing (or turning inactive) means price closed through it.
• Green triangle below a candle = Hammer (bullish reversal signal).
• Red triangle above a candle = Shooting Star (bearish reversal signal).
• Colored diamond = Bullish or Bearish Engulfing pattern.
• Text labels like "Double Top," "Head & Shoulders," "Double Bottom," "Inv Head & Shoulders" = a completed chart pattern has been detected at that swing point.
• The on-chart legend (top-right, if enabled) summarizes all of this directly on the chart for quick reference.

6. Suggested Starting Points

• New to price action: leave all four features and the legend on to see the full picture, then turn off whichever ones you don't find useful once you're familiar with them.
• Chart feels too cluttered: increase Swing Strength and/or the Noise Filter: Min Swing Move % to reduce how many swings get labeled; increase Max Levels Per Side tolerance or lower it to reduce S/R lines; increase Cooldown Between Signals to reduce candlestick pattern frequency.
• Chart feels too quiet / missing signals: lower Swing Strength , the noise filter, or the candlestick body/wick ratio requirements to catch more (but noisier) signals.
• Just want structure and S/R, no pattern shapes: turn off Enable Candlestick Patterns and Enable Chart Patterns , leaving Market Structure and Support & Resistance active.
• Chart pattern false positives: tighten Peak/Trough Similarity Tolerance (%) and increase Min Head Prominence (%) to require cleaner, more textbook-shaped patterns.

7. Troubleshooting

No swing labels appear

• Likely Cause: Not enough bars loaded yet (needs at least 2 × Swing Strength bars), or Enable Market Structure is off
• Fix: Load more chart history; confirm the toggle is on.

Chart is covered in HH/HL/LH/LL labels

• Likely Cause: Swing Strength or Noise Filter: Min Swing Move % is too low for this instrument/timeframe
• Fix: Increase either or both to reduce label frequency.

Support/Resistance lines keep disappearing

• Likely Cause: Remove Level When Broken is on and price is repeatedly breaking through levels
• Fix: This is expected behavior; turn the toggle off if you'd rather levels stay visible (marked inactive) after being broken.

Too many/duplicate S/R lines close together

• Likely Cause: Merge/Break Tolerance (%) is too tight
• Fix: Increase it so nearby swings merge into a single level instead of creating separate ones.

No candlestick pattern shapes appear

• Likely Cause: Enable Candlestick Patterns is off, the shape/ratio requirements are too strict for this instrument, or a signal fired too recently (cooldown active)
• Fix: Confirm the toggle is on; try loosening Max Body/Range Ratio or Min Long-Wick/Range Ratio ; check Cooldown Between Signals .

No chart patterns detected

• Likely Cause: Enable Chart Patterns is off, or Peak/Trough Similarity Tolerance / Min Head Prominence are too strict for what's actually forming
• Fix: Confirm the toggle is on; loosen the tolerance settings to catch less-than-perfect pattern shapes.

Legend not visible

• Likely Cause: Show Legend is off
• Fix: Enable it in the Display group.

Quick Start Summary

1. Add the indicator to your chart (named MarketStructureSRPatterns in the indicator list; nicknamed Market Structure + ).
2. Leave all four features and the legend on at first to see everything together.
3. Watch for green/red HH/HL/LH/LL labels for structure, orange/blue lines for support/resistance, triangles/diamonds for candlestick patterns, and text labels for completed chart patterns.
4. Adjust Swing Strength , the noise filter, and the S/R tolerance to match how "busy" you want the chart to be.
5. Turn off any of the four feature groups you don't want, and disable the legend once you've learned what each color/shape means.

‍

‍

ConfluenceRibbon — User Guide

(NinjaScript file name: ConfluenceRibbon.cs )

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: A dual-confirmation regime tool. Two independent trend-detection signals each paint their own rail on the chart; the band between them fills green when both signals agree the trend is up, red when both agree it's down, and yellow when they disagree. A conviction readout and confirmation arrows round out the picture, so you can see both direction and how much the two signals trust that direction at a glance.

1. What Problem This Solves

Relying on a single trend signal means you're trusting one particular way of measuring "trend" — and every method has blind spots. ConfluenceRibbon runs two genuinely different trend-detection approaches side by side and only calls a trend "confirmed" when both agree. When they disagree, the ribbon turns yellow instead of quietly picking a side, so conflicting signals are visible instead of hidden. A separate conviction score (independent of the two signals themselves) tells you how strong the broader trend conditions look right now.

2. How It Works (Plain English)

The Ribbon

Both rails are drawn a fixed distance (in ATR terms) above and below an EMA basis line — this spacing is purely visual and doesn't drive the signals themselves. What matters is the color of the fill between the rails : - Green fill — Signal A and Signal B both currently point up. - Red fill — both currently point down. - Yellow fill — the two signals disagree.

Conviction Readout

A separate 0–100% score reflects how "trend-like" current conditions look overall, using whichever of three methods you select: - ADX — classic trend-strength reading, normalized against a configurable cap. - Choppiness Index — measures how much price has been oscillating versus moving directionally (inverted, so higher = less choppy = more conviction). - R-Squared — how well a straight line fits recent price action (a very clean, linear move scores high).

This conviction score is independent of Signal A/B's agreement — a market can show high conviction with disagreeing signals, or low conviction even when the two signals happen to agree.

Confirmation Markers

An arrow is drawn the moment the two signals move from disagreement (or the opposite direction) into fresh agreement — a green up-arrow for new confirmed-up agreement, a red down-arrow for new confirmed-down agreement. These only fire on the transition, not on every bar the agreement holds.

HUD

An optional on-chart panel (top-right) spells out, in plain text: Signal A's current direction, Signal B's current direction, the overall confluence state ("CONFIRMED UP" / "CONFIRMED DOWN" / "CONFLICT"), and the current conviction percentage.

3. Settings Reference

1. Confluence Signals

Signal A: Length

• Description: Lookback period for the channel breakout signal
• Default: 20

Signal B: Sensitivity

• Description: ATR multiplier controlling how far the volatility trailing stop sits from price — higher values make Signal B slower to flip
• Default: 2.0

2. Conviction

ATR Length

• Description: ATR period used for rail spacing and Signal B's trailing calculation
• Default: 14

Conviction Source

• Description: Which method drives the conviction score: ADX, Choppiness Index, or R-Squared
• Default: Choppiness Index

ADX: Period

• Description: Lookback for ADX, used only when Conviction Source = ADX
• Default: 14

ADX: Normalization Cap

• Description: ADX value treated as "100% conviction"; used only when Conviction Source = ADX
• Default: 40

Choppiness Index: Length

• Description: Lookback for the Choppiness Index, used only when Conviction Source = Choppiness Index
• Default: 14

R-Squared: Length

• Description: Lookback for the R-Squared calculation, used only when Conviction Source = R-Squared
• Default: 14

3. Visual

Show Rails

• Description: Toggles the two colored rail lines
• Default: On

Show Basis Line

• Description: Toggles the dashed gray EMA basis line between the rails
• Default: On

Show Fill

• Description: Toggles the green/red/yellow fill between the rails
• Default: On

Basis EMA Length

• Description: Length of the EMA the rails are centered around
• Default: 20

Rail Spacing (ATR mult, per side)

• Description: How far each rail sits from the basis line, in ATR units
• Default: 0.6

Fill Opacity

• Description: Transparency of the confluence fill (0 = invisible, 1 = solid)
• Default: 0.7

Show Confirmation Markers

• Description: Toggles the arrows that fire when agreement is freshly reached
• Default: On

Show HUD

• Description: Toggles the on-chart text summary panel
• Default: On

4. How to Read the Chart

• Green rail-to-rail fill — both signals agree the trend is up.
• Red rail-to-rail fill — both signals agree the trend is down.
• Yellow rail-to-rail fill — the two signals disagree; treat this as a lower-confidence/transitional period.
• Upper rail color (Signal A) and lower rail color (Signal B) — each rail is independently colored green or red based on that signal's own current direction, so you can see at a glance which signal (if either) is the "odd one out" during a yellow period.
• Green up-arrow / red down-arrow — marks the exact bar where the two signals just moved into fresh agreement.
• HUD conviction % — read this alongside the fill color, not instead of it. High conviction with a yellow fill means conditions look trend-like overall, but the two specific signals used here haven't agreed on direction yet.

5. Suggested Starting Points

• New to the indicator: leave the HUD and confirmation markers on so you can see the plain-text state alongside the visual fill while you get a feel for how it behaves.
• Faster/more reactive: shorten Signal A: Length and/or lower Signal B: Sensitivity ; expect more color flips.
• Slower/steadier: lengthen Signal A: Length and/or raise Signal B: Sensitivity ; expect fewer, more deliberate flips.
• Choosing a Conviction Source: ADX is the most familiar/classic choice; Choppiness Index tends to respond well to ranging-vs-trending regime shifts; R-Squared rewards especially clean, linear moves specifically.
• Cleaner chart: turn off Show Rails and/or Show Basis Line if you only care about the fill color and HUD, not the underlying rail lines themselves.

6. Troubleshooting

No fill or rails appear for the first stretch of the chart

• Likely Cause: Needs enough bars to warm up, based on the longest of your Signal/ATR/Conviction lookback settings
• Fix: Normal — wait for enough bars to load, or load more chart history.

Fill color never seems to turn yellow

• Likely Cause: Signal A and Signal B may be well correlated on this instrument/timeframe, or one setting is dominating the other's behavior
• Fix: This can be a genuine result; try adjusting Signal A: Length or Signal B: Sensitivity to see if their disagreement rate changes.

Conviction % doesn't seem to match what you'd expect

• Likely Cause: Different Conviction Source methods can disagree meaningfully in the same market conditions — this is expected, since they measure different things
• Fix: Try switching Conviction Source to compare ADX vs. Choppiness Index vs. R-Squared readings side by side.

HUD panel not visible

• Likely Cause: Show HUD is off
• Fix: Enable it in the Visual group.

Confirmation arrows seem to fire less often than fill color changes

• Likely Cause: Arrows only fire on the transition into agreement, not every bar the fill is green/red, and not on transitions into disagreement
• Fix: This is by design — check the fill color for ongoing state; use the arrows specifically to catch the moment agreement is freshly reached.

Quick Start Summary

1. Add the indicator to your chart (named ConfluenceRibbon in the indicator list).
2. Leave the defaults in place at first — Signal A length 20, Signal B sensitivity 2.0, Choppiness Index for conviction.
3. Watch the fill color for the current confluence state: green (confirmed up), red (confirmed down), yellow (conflict).
4. Use the HUD panel and confirmation arrows for a plain-text summary and the exact moment agreement is reached.
5. Read the conviction % alongside the fill color, not as a replacement for it — the two are independent reads.

‍

‍