Documentation

What NBE is

Node Breach Engine (NBE) is a TradingView indicator that combines volume profile structure with rule-based breach/touch signals. It builds profiles (Swing-based or Session-based), identifies key nodes like POC and POV, and then watches how price interacts with those nodes to print clear long/short labels and fire alerts.

NBE is built to answer one core question:

“When price hits an important volume node, is it likely to reject, revert, or break?”

What NBE does

NBE continuously:

• Builds a Volume Profile over a chosen window (Swing or Session).

• Calculates the Value Area (VA), including VAH and VAL.

• Finds and plots:

  • POC (Point of Control): highest-volume price node (the “most accepted” price area).

  • POV (Point of Void): lowest-volume node inside the value area (an LVN within VA).

• Extends these levels forward and tracks touches / breaches.

• Prints POC / POV long & short labels when your selected filters confirm the setup.

• Optionally provides deepdive tooltips on signals (ATR, wick %, distance to node, trend state, etc.).

• Exposes hidden “API” plots so other scripts can read your node levels and signals.

  
  

Core concepts

Volume Profile window types

NBE can build profiles in two ways:

1) Swing profiles

• A profile is created pivot-to-pivot using a swing length.

• Good for traders who want market structure anchored to swings.

2) Session profiles

• A profile is created for a defined trading session (e.g., 09:30–16:00).

• Good for traders who want consistent daily/regular session structure.

POC (Point of Control)

The POC is the price row with the highest traded volume in the profile.

• Think of it as the strongest acceptance level.

• Price often reacts here because it’s where the most business was done.

POV (Point of Void)

The POV is the lowest-volume node (LVN) within the Value Area.

• Think of it as a thin spot inside “fair value”.

• Price often moves quickly around LVNs and can reject sharply when conditions match.

Value Area (VA), VAH, VAL

The Value Area is the portion of the profile containing X% of total volume (default 68%).

• VAH: top boundary of value.

• VAL: bottom boundary of value.

How to use NBE

A practical workflow

1. Pick your profile type

   • Swing if you trade structure and pivots.

   • Session if you trade regular market hours and session behavior.

2. Enable the nodes you care about

   • Start with POC.

   • Add POV if you want LVN-style signals inside VA.

3. Decide your signal style

   • If you want “first touch” behavior: keep default touch/breach logic.

   • If you want structured repeats: enable Retest Mode.

4. Set filters to match your style

   • Use Require Rejection Close to avoid noisy touches.

   • Use Skip Big Momentum (ATR guard) to avoid chasing extremes.

   • Add Wick Filter for more “rejection-like” candles.

   • Use Time Filter to limit signals to your trading window.

   • Keep EMA Trend Filter ON if you want trend alignment.

5. Execute

   • Treat POC/POV signals as location-based triggers.

   • Your entry can be the close of the signal candle, or the next candle—depending on your system.

Signal behavior

NBE prints POC and POV labels when price “touches/breaches” a node and your chosen confirmations pass.

Direction logic

Internally, NBE determines the “side” using the prior close vs the node level:

• If close[1] >= level, the engine treats the event as Long-oriented.

• If close[1] < level, the engine treats the event as Short-oriented.

Then filters decide if the label prints.

Settings reference

🔎 Profile Scope

Profile Type

Options: Swing, Session

• Swing: Profiles are built pivot-to-pivot using Swing Width.

• Session: A new profile starts each session.

Session Hours (Profile Type = Session)

Defines the session window used to build Session profiles. Uses the symbol’s exchange timezone.

⚙️ Settings ▸ Profile Window

Profile Window

Options: Current, Closed Profiles

• Current: Focuses on the developing profile from last pivot to now.

• Closed Profiles: Iterates historical pivot-to-pivot profiles.

Bars Scan

Safety cap to limit how many bars are scanned to avoid TradingView object/CPU limits.

📐 Settings ▸ Volume Profile

Swing Width

Pivot length used to define swing windows.

• Higher = fewer, wider swings (more stable, fewer profiles)

• Lower = more swings (more profiles, more reactive)

Show Volume Profile

Toggles the histogram rendering.

Histogram Rows

Vertical resolution of the profile histogram.
More rows = more detail (slightly heavier).

(%) Show Swing Change

Displays % change labels between swing highs/lows.

Show Profile Buy/Sell Bar

Draws a buy/sell pressure bar (up vs down volume) for the whole profile.

Bar thickness (rows)

Thickness of the buy/sell bar expressed in profile rows.

Colors & Backdrop

• Inside Value Area: histogram color for VA rows

• Outside Value Area: histogram color outside VA

• Background (toggle + color): optional backdrop fill for the profile window

• Up Volume / Down Volume / Text: colors for the profile buy/sell bar

🛡️ Settings ▸ Value Area

Value Area Coverage (%)

How much of total profile volume is considered “value”.
Typical: 68%, 70%, 80%.

Show VAH / Show VAL

Toggles VAH and VAL lines.

Fill VA

Fills the value area between VAH and VAL.

🌡️ Settings ▸ Point of Control (POC)

Show POC

Plots the POC level.

POC Line

Color for the POC line/box.

Show Developing POC

Shows a live-updating POC path while the profile is developing.

Developing Line

Color for the developing POC path.

Highlight POC Row

Highlights the entire histogram row containing the POC.

Row Highlight Color

Color of the highlighted POC row.

Toggle POC Buy/Sell Pressure

Shows relative up/down volume at the POC row (more granular than the full-profile bar).

Toggle POC Strength

Displays POC row volume as % of total profile volume (node dominance).

Toggle POC Deepdive

Enables rich hover tooltip on POC markers with extra context.

Use Touch Margin (POC)

Treats a touch as valid if price enters a ± margin around the POC.

± Margin (%)

Defines the margin size around the node (as a % of node price).
Use this if you want “near touches” to count.

🕳️ Settings ▸ Point of Void (POV)

Show POV

Enables POV detection (LVN inside value area).

POV Line

Color for POV level.

Show Developing POV

Shows a live-updating POV while the profile is developing.

Developing Line

Color for the developing POV line.

Highlight POV Row

Highlights the POV row in the histogram.

Row Highlight Color

Color used for POV row highlighting.

Extend POV until breach

Keeps the POV projected forward until price breaches it.

Use Touch Margin (POV)

Same idea as POC margin, but applied to POV.

± Margin (%)

Margin size for POV touches/breaches.

🧰 Settings ▸ Breach Filters & Confirmation

These filters decide if a touch/breach becomes a real label.

Require Rejection Close

If enabled, the candle must close in the direction of the signal. This helps avoid “tag and run” noise.

Skip Big Momentum

ATR-based guard. Filters out bars with extreme range (avoid chasing expansion).

(x) ATR Multiplier

Threshold: skip when (High−Low) > ATR(14) × multiplier.

Wick Size Filter

Requires a minimum wick-to-bar ratio on the relevant side:

• Long signals check lower wick

• Short signals check upper wick

Min Wick (%)

Minimum wick ratio required.

Use Time Filter

Limits signals to a specific session window (or suppresses signals during that window).

Time Filter Mode

• Trade Inside: allow signals only during the session

• Skip Inside: suppress signals during the session

Session

Session window used by the time filter (not the profile window—this is for signals).

🔁 Settings ▸ Retests

Enable Retest Mode

Changes behavior from “first touch removes the level” to “count valid retests”.

Max Retests

How many valid retests must occur before the level stops extending.

Only Signal At Last Retest

• OFF: you get a signal on each valid retest.

• ON: you only get a signal when the final retest count is reached.

Retest definition used by NBE

A retest is counted when:

• Previous candle was fully above/below the level band (no touch), and

• Current candle touches the band and closes back on the same side (rejection)

🔎 Breach • Deepdive

Toggle Breach Deepdive

Adds detailed tooltip data on breach labels (ATR, wick %, distance, trend state, etc.).

Show Extra Ratios

Shows numeric ratios like wick %, range/ATR, etc. If off, deepdive becomes more compact.

📈 Settings ▸ EMA Trend Filter & Wave

Enable Trend Filter

If enabled:

• Long labels require bullish EMA context

• Short labels require bearish EMA context

EMA Length

Base EMA length.

Smoothing Type

Optional smoothing applied to the base EMA: None, SMA, EMA, SMMA (RMA), WMA, VWMA.

Smoothing Length

Length of the smoothing MA.

Offset

Visual offset for plots.

Wave styling

• Show Trend Wave: draws a shaded wave band based on EMA delta strength

• Wave Thickness: thickness of the wave band

• Gradient Lookback: normalization window for gradient intensity

• Wave Bullish / Wave Bearish / Smoothed Line / EMA Color: visual controls

Alerts

Built-in alerts

• POC (Control) Breach LONG

• POC (Control) Breach SHORT

• PoV (LVN) Breach LONG

• PoV (LVN) Breach SHORT

• Overall breach alert (any node signal)

Use cases

• Webhook routing

• Notifications

• Automated trades

Data outputs

Exported series

• POC/POV breach signals (long/short)

• Last known POC/POV level

• Margin bands (top/bottom)

• Filter OK flags

• Trend state (EMA trend)

• Diagnostics like ATR, range/ATR, wick ratio, distance to node

Useful for

• A separate execution engine

• A dashboard panel

• A multi-indicator confluence system

Best-practice presets (quick starting points)

Conservative (high quality signals)

• Require Rejection Close: ON

• Skip Big Momentum: ON

• Wick Size Filter: ON (Min Wick 35–45%)

• EMA Trend Filter: ON

• Time Filter: ON (your main trading hours)

Aggressive (more signals)

• Require Rejection Close: OFF or ON

• ATR Guard: OFF or higher multiplier

• Wick Filter: OFF

• EMA Filter: optional

• Retest Mode: ON for structure-based repeats

Notes & limitations

Performance tips

Heavy rendering options (high rows, large lookbacks, lots of boxes/labels) can hit TradingView object limits. If your chart slows down, reduce:

• Bars Scan

• Histogram Rows

• Extra visuals (CVD bars, deepdive labels, highlighting)