Liquidity and S&R Zones

╔══════════════════════════════════════════════════════════════════════╗
║ Description ║
╚══════════════════════════════════════════════════════════════════════╝
This indicator identifies liquidity zones and support/resistance (S&R) levels
using pivot points and volume analysis. Liquidity zones highlight areas of high
trading activity, while S&R levels mark key price levels where price may reverse
or break. Breakouts are confirmed with a volume oscillator and visualized with
shapes. Alerts are provided for significant S&R breakouts.
╔══════════════════════════════════════════════════════════════════════╗
║ User Guide ║
╚══════════════════════════════════════════════════════════════════════╝

#### Overview
This indicator detects liquidity zones and support/resistance (S&R) levels
using pivot points and volume analysis. Liquidity zones highlight areas of
high trading activity, often targeted by institutional traders. S&R levels
indicate key price levels where price may reverse or break, with breakouts
confirmed by a volume oscillator. The indicator is designed for traders
seeking to trade breakouts or reversals at critical levels.

#### Features
- **Liquidity Zones**: Identifies pivot highs/lows with high-volume confirmation.
- **Support/Resistance Levels**: Plots dynamic S&R lines based on pivot points.
- **Breakout Signals**: Displays shapes for price crossing S&R levels with volume confirmation.
- **Volume Oscillator**: Uses short/long EMA difference to confirm breakouts.
- **Alerts**: Notifies users of support/resistance breakouts.

#### Input Parameters
- **Liquidity Settings**:
- *Liquidity Lookback Period*: Bars for average volume (default: 50).
- *Liquidity Volume Threshold Multiplier*: Volume multiplier for liquidity zones (default: 1.5).
- *Liquidity Pivot Lookback*: Bars for pivot detection (default: 5).
- **S&R Settings**:
- *Show Breaks*: Toggle breakout shapes (default: true).
- *Left/Right Bars*: Bars for S&R pivot detection (default: 15).
- *S&R Volume Threshold*: Minimum oscillator value for breakouts (default: 20).
- **Style Settings**: Predefined colors for liquidity and S&R visualization.

#### Usage
1. Apply the indicator to a chart (e.g., 1H, 4H, or D timeframes recommended).
2. Adjust input parameters to suit the instrument and timeframe:
- Increase `liqLookback` for smoother volume averages on lower timeframes.
- Adjust `leftBars` and `rightBars` for more/less sensitive S&R levels.
- Set `srVolumeThresh` based on typical oscillator values (plot `osc` to calibrate).
3. Monitor liquidity zones (red/green/yellow crosses) and S&R lines (red/green).
4. Watch for breakout signals (shapes) when price crosses S&R levels with volume confirmation.
5. Set up alerts for "Support Broken" or "Resistance Broken" to receive notifications.

#### Recommended Settings
- **Timeframes**: 1H, 4H, or D for reliable signals.
- **Instruments**: Assets with good volume (e.g., crypto, forex, indices).
- **Liquidity**: Increase `liqVolumeThreshold` (e.g., 2.0) for stricter zones.
- **S&R**: Use `leftBars = rightBars = 10` for faster markets.

#### Cautions
- Ensure sufficient chart history for pivot and volume calculations.
- High `liqLookback` or `leftBars` may delay signals on lower timeframes.
- Volume oscillator requires accurate volume data; test on reliable instruments.
- Backtest breakout signals, as false breakouts can occur in choppy markets.

#### Customization Ideas
- Add Fibonacci levels to complement S&R zones.
- Integrate with trend indicators (e.g., EMA) to filter breakouts.
- Visualize volume oscillator as a histogram for calibration.
- Extend liquidity zones with boxes to highlight price ranges.

#### Notes
- Combine with other analysis for a complete trading system.
- Test thoroughly in a demo account before live trading.
- Contact the author for support or feature requests.

Happy trading, and may your trades align with the market’s key levels! 🚀