Anchored VWAP Percentage

INDICATOR: ANCHORED VWAP PERCENTAGE (AVWAP)

1. Overview
The Anchored VWAP Percentage (AVWAP) is a quantitative momentum and mean-reversion tool. It measures the percentage distance between the current price and a Volume Weighted Average Price (VWAP) that resets automatically based on specific time cycles. It allows traders to identify overextended market conditions relative to institutional value.

---

2. Core Logic & Calculation
The script tracks the relationship between price and volume starting from a specific Anchor Point.

* Volume-Weighted Foundation: Unlike simple moving averages, this indicator uses the VWAP formula: sum(Volume * Price) / sum(Volume).
* Automatic Anchoring: The starting point (Anchor) resets automatically depending on the chart timeframe (e.g., resets weekly on a 15m chart, or yearly on a Daily chart).
* Percentage Deviation: It calculates the precise gap between the price and the VWAP, plotted as an oscillator: ((Price - VWAP) / VWAP) * 100.

---

3. Adaptive Intelligence (Multi-Asset & Multi-TF)
The AVWAP is built with an internal database of 85th Percentile (P85) volatility thresholds. It recognizes that different assets have different "stretching" limits:

1. Asset-Specific Calibration: It includes optimized data for Bitcoin, Ethereum, Altcoins, Forex, and Indices.
2. Dynamic Timeframe Mapping: The anchor period and the exhaustion thresholds adjust automatically. For example:
* Intraday (1m-5m): Anchors to an 8-hour (480 min) cycle.
* Mid-Term (15m-60m): Anchors to a Weekly (W) cycle.
* Swing (Daily): Anchors to a Yearly (12M) cycle.

---

4. Visual Anatomy
The indicator is designed for high-speed decision-making:

* The Histogram:
* Green: Price is trading above the VWAP (Bullish premium).
* Red: Price is trading below the VWAP (Bearish discount).
* P85 Threshold Lines:
* These lines represent the 85th percentile of historical deviations. Historically, the price stays within these boundaries 85% of the time.
* Background Highlighting: When the histogram crosses the P85 line, the background glows, signaling a Statistical Exhaustion Zone where a retracement to the mean is highly probable.

---

5. How to Trade with AVWAP
* Mean Reversion: When the histogram reaches the P85 Zone, the price is "statistically overextended." This is a prime area to look for reversals or to take profits on existing trends.
* Trend Strength: If the histogram stays near the Zero Line while the price moves, the trend is supported by healthy volume.
* Value Area: The Zero Line represents the Fair Value. Buying near the Zero Line during a bullish histogram (Green) offers a high-probability entry with low risk.

---

6. Technical Parameters
* Asset Selection: A dropdown to switch between Crypto, Forex, and Indices.
* Color Customization: User-defined colors for bullish and bearish sentiment.
* Precision Control: 4-decimal precision for accurate tracking of thin-margin assets like Forex.