Viprasol Volume Momentum Breakout Engine## Overview
The Volume Momentum Breakout Engine is an oscillator-based signal system that detects high-conviction entries by combining volume analysis with price momentum. It normalizes volume-weighted price changes into a z-score oscillator, then uses either pivot-level breakouts or overbought/oversold crossovers to generate signals. When the oscillator triggers, a signal box appears on the price chart — a confirmed breakout from that box produces the final entry signal with automatic TP/SL management.
Built for traders who want volume-confirmed entries without the noise of traditional volume indicators.
## How It Works
**Volume Momentum Oscillator (VMO):**
1. Volume is z-score normalized against its own rolling average and standard deviation
2. This normalized volume is multiplied by the bar's price change (close - previous close)
3. The resulting raw momentum is z-score normalized again and scaled by 10
4. The output oscillates around zero — positive values indicate bullish volume momentum, negative values indicate bearish
**Two Signal Modes:**
*Pivot Breakout Mode (default):*
- The oscillator's own pivot highs (above the OB level) and pivot lows (below the OS level) create horizontal lines
- When the oscillator breaks above a high pivot line or below a low pivot line, a signal box is created on the price chart
- The box captures the signal candle's high and low
- When price subsequently breaks out of the box, a confirmed trade entry fires
*OB/OS Continuation Mode:*
- Simpler approach — signals fire when the oscillator crosses above the OB level or below the OS level
- Box creation and breakout logic still applies
**Risk Management:**
Each confirmed breakout automatically draws entry, SL, and up to 3 TP levels using ATR-based or percentage-based risk calculation. Lines auto-close when SL or the furthest TP is hit.
## Key Features
- Volume momentum oscillator with double z-score normalization for clean signals
- Two signal modes: Pivot Breakout (higher quality) and OB/OS Continuation (more signals)
- Signal boxes on price chart with breakout confirmation
- Bar-close confirmation filter to reduce false breakouts from wicks
- Signal cooldown to prevent clustering in volatile conditions
- Optional EMA trend filter — only take longs above EMA, shorts below
- ATR-based or percentage-based stop-loss with configurable R:R take-profit levels
- Auto-closing TP/SL lines with shaded risk/reward fill zones
- Volume surge detection with background highlighting
- Dashboard showing oscillator value, volume status, active boxes, signal counts, and trade info
- Fully customizable colors, toggles, and display options
- 6 alert conditions with dynamic messages
## How to Use
**Getting Started:**
1. Add to any chart — works on all markets and timeframes
2. The oscillator appears in a separate pane below the chart
3. Signal boxes and TP/SL lines appear on the price chart via overlay
**Reading the Oscillator:**
- Values above the OB level (default 15) = strong bullish volume momentum
- Values below the OS level (default -15) = strong bearish volume momentum
- In Pivot mode, horizontal lines mark key oscillator levels — breaks trigger signals
- Yellow background highlights indicate unusual volume surges
**Trading the Signals:**
- Green background flash = bullish oscillator signal (box created)
- Red background flash = bearish oscillator signal (box created)
- Triangle UP below bar = confirmed long breakout from box
- Triangle DOWN above bar = confirmed short breakout from box
- Entry/SL/TP lines appear automatically with risk/reward fill
**Recommended Settings:**
- Crypto/Forex (5m-15m): Volume Window 15, OB/OS 12/-12, Cooldown 3
- Stocks (15m-1H): Volume Window 20, OB/OS 15/-15, Cooldown 5
- Indices (1H-4H): Volume Window 25, OB/OS 18/-18, Cooldown 8
## Settings
**Core Settings:** Signal mode selection, volume lookback window, OB/OS threshold levels.
**Pivot Settings:** Left/right bars for pivot detection, price direction filter, max pivot line length.
**Signal Filters:** Bar-close confirmation, signal cooldown, optional EMA trend filter.
**Risk Management:** ATR or percentage SL, ATR period, SL multiplier, TP1/TP2/TP3 risk-reward ratios.
**TP/SL Display:** Individual toggles for SL, TP1, TP2, TP3 lines.
**Visuals:** Oscillator color, band colors, bull/bear signal colors, volume surge highlighting.
**Dashboard:** Show/hide toggle and font size.
## Alerts
1. **Bullish Box Breakout** — Price breaks above a signal box (confirmed long entry)
2. **Bearish Box Breakout** — Price breaks below a signal box (confirmed short entry)
3. **Any Box Breakout** — Either direction breakout
4. **Bullish Oscillator Signal** — Oscillator triggers bullish (box created, before breakout)
5. **Bearish Oscillator Signal** — Oscillator triggers bearish (box created, before breakout)
6. **Volume Surge Detected** — Volume exceeds the surge multiplier threshold
All alerts include {{ticker}}, {{close}}, and {{interval}} for dynamic notification messages.
## Limitations & Disclaimer
- The oscillator uses z-score normalization which requires sufficient historical data — early bars may produce unstable readings
- Volume data quality varies across brokers and instruments; results may differ between data providers
- Signal boxes extend until broken — in low-volatility sideways markets, boxes may accumulate
- Pivot detection has inherent lag equal to the right lookback period
- TP/SL lines are visual guides — they do not execute trades automatically
- Past performance does not guarantee future results
- This indicator is for educational and analytical purposes only — it is not financial advice. Always use proper risk management.
---
*Based on a concept by Uncle_the_shooter. Significantly enhanced with signal filtering (bar-close confirmation, cooldown, trend filter), volume surge detection, dashboard, 6 alert conditions, tooltips, and visual customization by Viprasol.*
אינדיקטור Pine Script®






















