gavindiaz/mql5
1
0
Fork 0
mirror of https://github.com/softwaredevelop/mql5.git synced 2026-08-12 20:08:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor(docs): Simplified 5-Zone Thermal Heatmap

Browse Source
This commit is contained in:
Toh4iem9
2026-03-15 15:55:50 +01:00
parent e09b15d971
commit 5468c44f49
1 changed files with 38 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Indicators/MyIndicators/Quant/VScore_Pro.md
+38 -23
View File
@@ -2,50 +2,65 @@
## 1. Summary
**V-Score Pro** (Volume-Weighted Score) is an institutional Mean Reversion indicator. While standard Z-Scores measure deviation from a simple time-based average (SMA), the V-Score measures deviation from the **Volume-Weighted Average Price (VWAP)**.
**V-Score Pro** (Volume-Weighted Z-Score) is an institutional-grade quantitative indicator. While standard Z-Scores measure deviation from a simple time-based average (SMA), the V-Score measures the statistical deviation from the **Volume-Weighted Average Price (VWAP)**.
This distinction is critical: VWAP represents the "True Value" or the average price paid by all participants. Therefore, V-Score tells you if the current price is "Expensive" or "Cheap" relative to where the real money has been transacted.
VWAP represents the "True Value"—the average price weighted by actual capital flow. Therefore, V-Score precisely identifies whether the current price is "Expensive" or "Cheap" relative to where the institutional money has been transacted, utilizing a **5-Zone Thermal Heatmap** for zero-latency visual processing.
## 2. Methodology & Logic
The indicator calculates how many Standard Deviations ($\sigma$) the price is away from the VWAP.
The indicator calculates how many Standard Deviations ($\sigma$) the price has stretched away from the VWAP.
### The Formula
$$V\text{-}Score = \frac{\text{Price} - \text{VWAP}}{\sigma_{(Price - VWAP)}}$$
* **Numerator:** The distance between the current price and the VWAP.
* **Numerator:** The absolute distance between the current price and the VWAP.
* **Denominator:** The standard deviation of this distance over a rolling window ($N$).
### Interpretation
### The Institutional Z-Score Levels
The indicator oscillates around **0.0** (which is the VWAP line).
The indicator oscillates around **0.0** (Fair Value). Understanding the specific deviation levels is critical for interpreting market phases:
* **+2.0 Sigma (Orange/Red):** Price is statistically expensive given the volume profile. The elastic band is stretched. Reversion to VWAP is likely.
* **-2.0 Sigma (Blue):** Price is statistically cheap. Good area for value buying.
* **0.0 (Gray):** Price is at fair value (on the VWAP).
* **0.0 to $\pm$1.0 (The Noise Zone):**
* *Meaning:* Algorithmic chop. No clear institutional directional flow.
* *Visual:* Histogram is **Gray** (Neutral).
* **$\pm$1.5 (The Point of No Return):**
* *Meaning:* The breakout threshold. Statistically, if the price breaches and holds the 1.5 level, the momentum is strong enough that it will likely reach the 2.0 extreme.
* *Visual:* Marked by a dashed horizontal line. Histogram shifts to **Coral** (Bull Flow) or **LightSkyBlue** (Bear Flow).
* **$\pm$1.5 to $\pm$2.0 (The Flow / Momentum Zone):**
* *Meaning:* Active institutional accumulation or distribution. This is the optimal zone to be in a trend-following position.
* **$\pm$2.0 to $\pm$2.5 (The Extreme Zone):**
* *Meaning:* **WARNING.** The trend is statistically overextended. The elastic band is stretched tight.
* *Action:* Do not open new trend-following positions here.
* *Visual:* Histogram shifts to **OrangeRed** (Bull Extreme) or **DeepSkyBlue** (Bear Extreme). Marked by solid lines.
* **$\pm$2.5 to $\pm$3.0+ (The Statistical Wall):**
* *Meaning:* **STOP.** 99% probability of mean reversion or momentum exhaustion.
* *Action:* Mandatory profit-taking zone. The market is at a climax. Marked by the outermost solid lines.
## 3. MQL5 Implementation Details
* **Engine (`VScore_Calculator.mqh`):**
* Integrates the `CVWAPCalculator` engine to ensure the VWAP baseline matches the standard institutional calculation (anchored to Session, Week, or Month).
* Calculates standard deviation dynamically on the deviation array, not just raw price variance.
* **Visuals:**
* Colored Histogram for instant state recognition.
* Strictly adheres to **O(1) incremental calculation**. It does not recalculate the history on every tick, ensuring zero performance drop even on 1-second charts.
* Integrates the `CVWAPCalculator` engine to ensure the VWAP baseline matches standard institutional calculations.
* **Visuals (`VScore_Pro.mq5`):**
* **5-Color Thermal Heatmap:** Groups complex statistical data into an easily readable format (Gray $\rightarrow$ Warming/Cooling $\rightarrow$ Hot/Freezing).
* Explicitly draws the 1.5 (Dashed), 2.0 (Solid), and 2.5 (Solid) reference levels.
## 4. Parameters
* `InpPeriod`: The rolling window for standard deviation calculation (Default: `20`). A shorter period makes the bands tighter and the score more volatile.
* `InpPeriod`: The rolling window for standard deviation calculation (Default: `20`). A shorter period makes the indicator more sensitive and volatile.
* `InpVWAPReset`: The anchor for the VWAP calculation.
* `PERIOD_SESSION` (Default): Resets daily. Use for Intraday trading.
* `PERIOD_WEEK`: Resets weekly. Use for Swing trading.
* `PERIOD_MONTH`: Resets monthly. Use for Position trading.
* `PERIOD_SESSION` (Default): Resets daily. Used for Intraday trading.
* `PERIOD_WEEK`: Resets weekly. Used for Swing trading.
* `PERIOD_MONTH`: Resets monthly. Used for Position trading.
## 5. Strategic Usage
1. **Mean Reversion:**
When the V-Score hits **+2.0** or **+3.0** and starts to curl back down, it is a high-probability short signal targeting the VWAP (0.0).
2. **Trend Continuation (The "Value" Play):**
In a strong uptrend, wait for the V-Score to drop below **-1.0** or **-2.0** (Oversold relative to VWAP) to enter Long. Do not buy when V-Score is already > 2.0.
3. **Squeeze Confluence:**
If `Squeeze_Pro` shows a Squeeze (Low Volatility) and V-Score is near 0.0, a significant move is imminent, launching from Fair Value.
1. **The "Point of No Return" Breakout:**
Wait for the V-Score to cross above **+1.5** (Coral) or below **-1.5** (LightSkyBlue) with strong price action. This confirms that the move out of the "Noise" zone is legitimate and has institutional backing.
2. **Mandatory Profit Taking (The Wall):**
If you are in a Long position and the V-Score touches or exceeds **+2.5**, instantly scale out or close the position. Do not be greedy; statistical exhaustion is guaranteed.
3. **Absorption / Divergence (BULL_ABS / BEAR_ABS):**
If the price makes a *New High*, but the V-Score fails to reach the Extreme Zone (> 2.0) and stays lower than it was at the previous price high, this is **Bull Absorption** (exhaustion of buyers). A sharp mean-reversion drop to the VWAP (0.0) is imminent.
4. **Squeeze Confluence:**
If `Squeeze_Pro` indicates a Squeeze (Low Volatility) and the V-Score is near **0.0**, a massive, high-R/R move is loading, ready to launch directly from Fair Value.