Documentation

What ORB-PE is

Open Range Breakout Profile Engine (ORB-PE) is a TradingView indicator that builds an adaptive Open Range during a session, then locks that range when volatility cools off (ATR drops from the session peak). Once locked, it focuses on strict breakouts only—printing clean long/short triangles and firing alerts.

ORB-PE is built to answer one core question:

“When the open range is finished, did price break out cleanly and decisively?”

What ORB-PE does

ORB-PE continuously:

• Detects a session window (e.g., 09:30–16:00).

• Builds the Open Range High and Open Range Low while the range is still “forming”.

• Tracks ATR peak during the session and locks the OR when ATR drops by a chosen percentage.

• Calculates Session VWAP.

• Optionally draws a VWAP-centered gradient profile between VWAP and OR boundaries (visual structure).

• Prints strict breakout signals:

  • Long only when candles are fully above OR High.

  • Short only when candles are fully below OR Low.

• Uses a one-shot trigger (won’t spam signals) until price re-enters the range.

• Provides built-in alerts for long, short, and overall breakouts.

Core concepts

Open Range (OR)

The Open Range is the evolving high/low of price during the session’s early phase.

• OR High updates with new highs.

• OR Low updates with new lows.

Once the OR is locked, OR High/Low stop moving and become fixed reference levels.

ATR-based OR lock

Instead of locking OR at a fixed clock time, ORB-PE locks it when volatility fades:

• It tracks the session’s ATR peak.

• The OR is locked when:

ATR < ATR_peak × (1 − ATR_drop%)

This makes the open range length adaptive: some days it locks fast, some days it takes longer.

Strict breakouts (clean-only signals)

ORB-PE uses strict conditions so you avoid “wick breaks” and noisy tags.

Strict long requires:

• open > OR High

• close > OR High

• low > OR High

Strict short requires:

• open < OR Low

• close < OR Low

• high < OR Low

One-shot signals (no spam)

Once a breakout signal fires, it won’t fire again in the same direction until price re-enters the open range.

Re-entry condition:

• close is between OR Low and OR High

This creates clean “one attempt per breakout” behavior.

VWAP + gradient profile (context layer)

ORB-PE calculates session VWAP and can draw a horizontal gradient between VWAP and OR boundaries after the OR locks.

This gives you a quick read of:

• Where VWAP sits relative to the OR.

• How stretched price is relative to VWAP and the locked range.

How to use ORB-PE

A practical workflow

1) Set your session
Use the market session you trade (e.g., 09:30–16:00 for US cash).

2) Let the OR form
During the opening phase, OR High/Low expand as price makes new extremes.

3) Wait for the OR lock
Once ATR falls enough from the session peak, the OR locks and becomes your breakout frame.

4) Trade strict breakouts

• Long triangle = clean break above OR High

• Short triangle = clean break below OR Low

Because signals are strict, you usually get fewer but higher clarity triggers.

5) Use VWAP + gradient for context

• If VWAP is near the middle, the OR is more “balanced”.

• If VWAP is skewed, you often get asymmetry in how breakouts behave.

6) Manage the one-shot behavior
If you want another signal, price must first re-enter the OR (close back inside the range).

Signal behavior

ORB-PE prints triangles when a strict breakout occurs and the trigger state allows it.

OR lock gating (optional)

If Toggle ORB lock is ON:

• Signals only print after the OR is locked.

If it’s OFF:

• Signals can print even while OR is still forming.

Long signal

A long prints when:

• OR lock condition passes (depending on setting)

• Candle opens above OR High

• Candle closes above OR High

• Candle low stays above OR High

• No prior long was triggered (until re-entry)

Short signal

A short prints when:

• OR lock condition passes (depending on setting)

• Candle opens below OR Low

• Candle closes below OR Low

• Candle high stays below OR Low

• No prior short was triggered (until re-entry)

Settings reference

Session

Session

Defines the session window the engine uses for OR building and VWAP calculation.

ATR Logic

ATR Length

ATR period used to track volatility and determine the session ATR peak.

ATR drop % to end OR

How much ATR must drop from the session peak before the OR locks.

Example: 0.30 means lock when ATR drops 30% from the peak.

Volume

Volume MA length

Length of the SMA used to determine whether current volume is above average.

Note: the code calculates this, but it isn’t currently used to gate signals (it’s available if you extend logic).

Profile / Visuals

Show VWAP + Gradient

Toggles VWAP plotting and the gradient fill between VWAP and OR boundaries (after lock).

Gradient steps

Number of gradient bands used between VWAP and OR High/Low.

More steps = smoother gradient (slightly heavier).

Signals

Toggle ORB lock

If ON, signals only print after OR is locked (ATR drop condition met).

If OFF, signals can print even before OR is locked (more aggressive).

Alerts

Built-in alerts

• OutsiderEdge ORB Long

• OutsiderEdge ORB Short

• OutsiderEdge ORB Overall Breakout

Use cases

• Webhook routing (Discord / server / execution layer)

• Mobile notifications

• Journaling breakouts per session

Best-practice presets (quick starting points)

Conservative (cleanest breakouts)

• Toggle ORB lock: ON

• ATR drop % to end OR: 0.30–0.45

• Show VWAP + Gradient: ON

• Gradient steps: 5–7

Aggressive (earlier triggers)

• Toggle ORB lock: OFF

• ATR drop % to end OR: 0.20–0.30

• Show VWAP + Gradient: optional

• Gradient steps: 3–5

Notes & limitations

• The OR lock is volatility-adaptive, so the OR duration can vary by day.

• Strict breakouts reduce noise, but they can also miss “barely breaks then runs” moves (that’s the tradeoff).

• Performance is typically light (plots/fills only), but if you want a cleaner chart, reduce gradient steps or disable VWAP + gradient.