Volume/Price Movement Indicator

## Volume/Price Movement Indicator (VPM)

The **Volume/Price Movement Indicator (VPM)** is a technical analysis tool designed to identify the strength and potential direction of a trend by combining price momentum with volume analysis. Unlike indicators that only look at price, VPM uses volume as a confirming factor to gauge the conviction behind a price move. This helps traders distinguish between strong, high-conviction trends and weak, low-conviction movements that may be prone to reversal.

***

### Key Concepts

* **Price Trend**: The indicator smooths out daily price changes to determine the underlying trend direction. A positive price trend suggests upward momentum, while a negative trend suggests downward momentum.
* **Volume Analysis**: The VPM calculates a **Volume Ratio**, which compares the current bar's volume to its moving average. A high volume ratio indicates that the current volume is significantly higher than recent average volume, suggesting strong market participation. The **Volume Threshold Multiplier** is used to define what constitutes "high volume."
* **Net Pressure**: This component measures the difference between buying pressure and selling pressure, providing an additional layer of confirmation. Positive net pressure indicates that buying activity is outpacing selling, and vice versa.

***

### How to Use the Indicator

The VPM plots its findings on a histogram below the main chart, using colors to clearly signal the market's state.

* **🟢 Strong Bull (Green)**: This is the most powerful bullish signal. It indicates a clear upward price trend that is confirmed by both high volume and positive net pressure. This is a strong signal of conviction and potential continuation of the uptrend.
* **🔵 Weak Bull (Lime)**: This signal indicates a clear upward price trend, but with low volume. The positive net pressure suggests buying is still dominant, but the lack of high volume means there may not be strong market conviction. This signal suggests caution and may precede a consolidation or reversal.
* **🔴 Strong Bear (Red)**: The strongest bearish signal. It indicates a clear downward price trend confirmed by high volume and negative net pressure. This suggests strong selling conviction and a high probability of the downtrend continuing.
* **🟠 Weak Bear (Orange)**: This indicates a clear downward price trend but with low volume. Negative net pressure confirms selling dominance, but the low volume suggests a lack of strong conviction. Like the "Weak Bull" signal, this suggests caution.
* **⚫ Neutral (Gray)**: This signal is displayed when there is no clear trend or when price and volume are diverging. It's a signal of market indecision and suggests waiting for a clearer signal.

***

### Indicator Settings

* **Trend Length**: This input controls the sensitivity of the price trend calculation. A smaller value will make the indicator more responsive to short-term price changes, while a larger value will filter out noise and focus on longer-term trends.
* **Volume MA Length**: This determines the length of the moving average used as a baseline for volume. A longer length will make the "high volume" condition harder to meet.
* **Volume Threshold Multiplier**: This is a key setting for tuning the indicator. It determines how much higher the current volume must be than its moving average to be considered "high volume." For example, a value of `1.2` means volume must be at least 20% higher than the moving average to trigger a high-volume signal.