mql5/Indicators/MyIndicators/PivotPoints_Pro.md

# Pivot Points Pro (v3.30) *Professional Quantitative Multi-Timeframe Support & Resistance Suite*

---

## 1. Summary (Introduction)

**Pivot Points Pro** is a high-performance, institutional-grade support and resistance indicator developed for MetaTrader 5 (2026 Edition). Designed specifically for active technical analysts and systematic traders, it eliminates the visual noise of historical lines by rendering levels **strictly for the active period** while extending them continuously across the entire chart workspace.

### Key Innovations in Version 3.30

* **Native Full-Workspace & Chart Shift Support:** Utilizes a zero-latency vector rendering engine (`OBJPROP_RAY_RIGHT`) that anchors lines to the exact period open (e.g., 00:00) and extends them seamlessly across current price action to the far-right price scale.
* **Dual-Layer Architecture:** Combines hardware-accelerated chart objects for flawless visuals with synchronized indicator buffers (`DRAW_NONE`) to ensure 100% compatibility with MetaTrader 5 **Data Window (`Ctrl+D`)** and automated Expert Advisors (`iCustom`).
* **Multi-Timeframe (MTF) Engine:** Real-time synchronization allowing Daily, Weekly, or Monthly pivots to be displayed on intraday timeframes (M1, M5, M15, H1).
* **5 Institutional Formula Modes:** Classic Floor, Fibonacci, Woodie, Camarilla, and Tom DeMark.
* **Heikin Ashi Filtered Source:** Dynamic transformation of OHLC prices into synthetic Heikin Ashi data to eliminate high-frequency false breakouts.

---

## 2. Mathematical Foundations

Pivot Points are computed using the High ($H$), Low ($L$), and Close ($C$) prices from the **previous completed** higher-timeframe bar. The Range is defined as:
$$\text{Range} = H - L$$

### 2.1. Calculation Modes

#### 1. Classic (Floor Trader)

The quintessential standard for intraday equilibrium and reaction bands:
$$PP = \frac{H + L + C}{3}$$
$$R1 = 2 \cdot PP - L \quad\quad S1 = 2 \cdot PP - H$$
$$R2 = PP + \text{Range} \quad\quad S2 = PP - \text{Range}$$
$$R3 = H + 2 \cdot (PP - L) \quad\quad S3 = L - 2 \cdot (H - PP)$$

#### 2. Fibonacci

Projects golden ratio intervals around the central equilibrium:
$$PP = \frac{H + L + C}{3}$$
$$R1 = PP + 0.382 \cdot \text{Range} \quad\quad S1 = PP - 0.382 \cdot \text{Range}$$
$$R2 = PP + 0.618 \cdot \text{Range} \quad\quad S2 = PP - 0.618 \cdot \text{Range}$$
$$R3 = PP + 1.000 \cdot \text{Range} \quad\quad S3 = PP - 1.000 \cdot \text{Range}$$

#### 3. Woodie

Weights the settlement price more heavily to account for late-session momentum:
$$PP = \frac{H + L + 2 \cdot C}{4}$$
$$R1 = 2 \cdot PP - L \quad\quad S1 = 2 \cdot PP - H$$
$$R2 = PP + \text{Range} \quad\quad S2 = PP - \text{Range}$$
$$R3 = H + 2 \cdot (PP - L) \quad\quad S3 = L - 2 \cdot (H - PP)$$

#### 4. Camarilla

Specifically calibrated for mean-reverting range scalping and explosive breakout triggers:
$$PP = \frac{H + L + C}{3}$$
$$R1 = C + \text{Range} \cdot \frac{1.1}{12} \quad\quad S1 = C - \text{Range} \cdot \frac{1.1}{12}$$
$$R2 = C + \text{Range} \cdot \frac{1.1}{6} \quad\quad S2 = C - \text{Range} \cdot \frac{1.1}{6}$$
$$R3 = C + \text{Range} \cdot \frac{1.1}{4} \quad\quad S3 = C - \text{Range} \cdot \frac{1.1}{4}$$

#### 5. Tom DeMark

A conditional predictive model based on open-close directional pressure:
$$\text{If } C < O \implies X = H + 2 \cdot L + C$$
$$\text{If } C > O \implies X = 2 \cdot H + L + C$$
$$\text{If } C = O \implies X = H + L + 2 \cdot C$$

$$PP = \frac{X}{4}$$
$$R1 = \frac{X}{2} - L \quad\quad S1 = \frac{X}{2} - H$$

---

### 2.2. Median Equilibrium Levels (Mid-Points)

When enabled, arithmetic midpoints are calculated to provide intermediate micro-structure targets:
$$M_1 = \frac{S1 + S2}{2}, \quad M_2 = \frac{S1 + PP}{2}, \quad M_3 = \frac{PP + R1}{2}$$
$$M_4 = \frac{R1 + R2}{2}, \quad M_5 = \frac{R2 + R3}{2}, \quad M_6 = \frac{S2 + S3}{2}$$

---

### 2.3. Heikin Ashi Synthetic Price Model

When `InpSourceType = PIVOT_SRC_HEIKIN_ASHI`, prices are filtered prior to level calculations:
$$C_{\text{ha}} = \frac{O + H + L + C}{4}$$
$$O_{\text{ha}} = \frac{O_{\text{prev}} + C_{\text{prev}}}{2}$$
$$H_{\text{ha}} = \max(H, \max(O_{\text{ha}}, C_{\text{ha}}))$$
$$L_{\text{ha}} = \min(L, \min(O_{\text{ha}}, C_{\text{ha}}))$$

---

## 3. MQL5 Architecture & Technical Implementation

```text

┌────────────────────────────────────────────────────────┐
│               PivotPoint_Calculator.mqh                │
│    (Core Math Engine - Stateful O(1) Cache Memory)     │
└──────────────────────────┬─────────────────────────────┘
                           │ Computes Levels & Period Start
                           ▼
┌────────────────────────────────────────────────────────┐
│                  PivotPoints_Pro.mq5                   │
│   (Thin Wrapper - Vector Ray Engine & Data Buffers)    │
├──────────────────────────┬─────────────────────────────┤
│   Buffer Layer (13)      │   Extended Object Engine    │
│   • Data Window (Ctrl+D) │   • Ray Right Vector Lines  │
│   • iCustom EA Ready     │   • Future Shift Labels     │
└──────────────────────────┴─────────────────────────────┘

```

1. **Stateful HTF Caching ($O(1)$ Efficiency):** Calculations run only once when a new HTF session bar opens. Subsequent ticks retrieve levels from cached memory.
2. **Extended Ray Objects:** Utilizes `OBJ_TREND` with `OBJPROP_RAY_RIGHT = true` and `OBJPROP_BACK = true`. This prevents line clipping at the live bar index and fills the Chart Shift workspace cleanly.
3. **Smart Label Engine:** Text labels (`OBJ_TEXT`) automatically float into the forward workspace margin (`InpLabelShift` bars ahead) to avoid obscuring the current price action.
4. **Resource Management:** Safe pointer deletion (`CheckPointer`) and prefix-based object purging (`ObjectsDeleteAll`) prevent ghost objects during symbol, timeframe, or parameter updates.

---

## 4. Parameters Reference

### Timeframe Settings

* `InpTimeframe` (*default: `PERIOD_D1`*): The Higher Timeframe used for calculation. Must be greater than or equal to the current chart timeframe.

### Calculation Settings

* `InpPivotType` (*default: `PIVOT_CLASSIC`*): Formula selection (`PIVOT_CLASSIC`, `PIVOT_FIBONACCI`, `PIVOT_WOODIE`, `PIVOT_CAMARILLA`, `PIVOT_DEMARK`).
* `InpSourceType` (*default: `PIVOT_SRC_STANDARD`*): Price series source (`PIVOT_SRC_STANDARD` or `PIVOT_SRC_HEIKIN_ASHI`).

### Visual Settings - Pivot Point

* `InpColorPP` (*default: `clrGold`*): Color of the central equilibrium level (PP).
* `InpStylePP` (*default: `STYLE_SOLID`*): Line style of the central PP.
* `InpWidthPP` (*default: `2`*): Line thickness of the central PP.

### Visual Settings - Resistance Levels

* `InpColorRes` (*default: `clrDodgerBlue`*): Color applied to R1, R2, and R3.
* `InpStyleRes` (*default: `STYLE_SOLID`*): Line style for resistance lines.
* `InpWidthRes` (*default: `1`*): Line thickness for resistance lines.

### Visual Settings - Support Levels

* `InpColorSup` (*default: `clrFireBrick`*): Color applied to S1, S2, and S3.
* `InpStyleSup` (*default: `STYLE_SOLID`*): Line style for support lines.
* `InpWidthSup` (*default: `1`*): Line thickness for support lines.

### Visual Settings - Medians

* `InpShowMedians` (*default: `true`*): Toggle arithmetic midpoint levels between main pivots.
* `InpColorMed` (*default: `clrSilver`*): Color for median lines.
* `InpStyleMed` (*default: `STYLE_DOT`*): Line style for median lines.
* `InpWidthMed` (*default: `1`*): Line thickness for median lines.

### Labels

* `InpShowLabels` (*default: `true`*): Toggle text identifiers (PP, R1, S1, etc.) on the chart.
* `InpLabelShift` (*default: `8`*): Offset distance (in bars) extending into the forward chart shift space.
* `InpFontSize` (*default: `8`*): Font size of the text identifiers.

---

## 5. Usage & Trading Interpretation

### 5.1. Directional Bias (The Central Pivot)

* **Bullish Bias:** Price established above $PP$. Look for pullbacks toward $PP$ or momentum continuations toward $R1$, $R2$, and $R3$.
* **Bearish Bias:** Price established below $PP$. Look for pullbacks toward $PP$ or momentum continuations toward $S1$, $S2$, and $S3$.

### 5.2. Mean Reversion vs. Momentum Breakout

* **Ranging Markets (Consolidation):** Support levels ($S1, S2$) act as demand pools; resistance levels ($R1, R2$) act as supply caps. Fades from $S1$ toward $PP$ and $R1$ toward $PP$ offer favorable risk-to-reward ratios.
* **Trending Markets (Breakout Expansion):** A decisive candle close beyond $R1$ or $S1$ confirms momentum, shifting the next targets to $R2/R3$ or $S2/S3$.

### 5.3. Role of Median Lines ($M_1 \dots M_6$)

* Medians serve as early take-profit targets or entry-confirmation zones before committing to full structural target levels.

---

## 6. Indicator Buffer Map (For Developers & EA Integration)

| Buffer Index | Name | Formula / Level | Description |
| :---: | :---: | :---: | :--- |
| **0** | `BufferPP` | $PP$ | Central Pivot Point |
| **1** | `BufferR1` | $R1$ | First Resistance Level |
| **2** | `BufferS1` | $S1$ | First Support Level |
| **3** | `BufferR2` | $R2$ | Second Resistance Level |
| **4** | `BufferS2` | $S2$ | Second Support Level |
| **5** | `BufferR3` | $R3$ | Third Resistance Level |
| **6** | `BufferS3` | $S3$ | Third Support Level |
| **7** | `BufferM1` | $(S1 + S2)/2$ | Median Between S1 and S2 |
| **8** | `BufferM2` | $(S1 + PP)/2$ | Median Between S1 and PP |
| **9** | `BufferM3` | $(PP + R1)/2$ | Median Between PP and R1 |
| **10** | `BufferM4` | $(R1 + R2)/2$ | Median Between R1 and R2 |
| **11** | `BufferM5` | $(R2 + R3)/2$ | Median Between R2 and R3 |
| **12** | `BufferM6` | $(S2 + S3)/2$ | Median Between S2 and S3 |

*All buffers return `EMPTY_VALUE` for historical periods outside the active session, maintaining a pristine and deterministic environment for backtesting and automated execution.*