Key Liquidity Advanced Multi-Timeframe Suite

═══════════════════════════════════════
KEY LIQUIDITY ADVANCED MULTI-TIMEFRAME SUITE
═══════════════════════════════════════

A professional-grade indicator focused on identifying institutional liquidity levels across multiple timeframes, combined with order flow analysis and market structure tools.

───────────────────────────────────────
WHAT THIS INDICATOR DOES
───────────────────────────────────────

This tool specializes in multi-timeframe liquidity analysis with the following components:

- Multi-Timeframe Liquidity Levels - Track swing highs/lows on HTF (Higher Timeframe), LTF (Lower Timeframe), and CTF (Current Timeframe)
- Order Blocks - Identify institutional accumulation and distribution zones
- Premium/Discount Zones - Show price distribution relative to swing ranges
- Market Structure Breaks - Highlight significant trend changes
- Trading Sessions - Display major market session boundaries (Optional)

───────────────────────────────────────
HOW IT WORKS
───────────────────────────────────────

MULTI-TIMEFRAME LIQUIDITY SYSTEM:

The indicator uses a three-tier liquidity detection system:

1. HTF (Higher Timeframe) Liquidity:
- Default: 4H timeframe (configurable to Daily, Weekly)
- Identifies major institutional levels
- Uses pivot detection with adjustable left/right bar parameters
- Color-coded: Green for highs, Red for lows

2. LTF (Lower Timeframe) Liquidity:
- Default: 1H timeframe (configurable)
- Provides precision entry/exit levels
- Color-coded: Blue for highs, Orange for lows

3. CTF (Current Timeframe) Liquidity:
- Optional feature for chart timeframe levels
- Color-coded: Purple for highs, Pink for lows

Calculation Method:
- Uses standard pivot high/low detection algorithm
- Configurable sensitivity via left bars (lookback) and right bars (confirmation)
- Levels automatically removed when price sweeps through them (mitigation)
- Optional display of mitigated levels with reduced opacity

ORDER BLOCKS:

Detection Logic:
- Bullish OB: Last bearish candle before significant bullish move
- Bearish OB: Last bullish candle before significant bearish move
- Uses swing length parameter to identify structural breaks
- Strength visualization showing buying vs selling pressure

Visual Elements:
- Split-colored boxes showing institutional sentiment
- Upper half: Bullish strength (teal)
- Lower half: Bearish strength (red)
- Labels positioned at center with institutional markers

Violation Detection:
- Configurable: Wick-based or Close-based
- Automatically removes broken order blocks
- Optional overlap hiding to keep chart clean

PREMIUM/DISCOUNT ZONES:

Zone Structure:
- Premium Zone: Upper 5% of swing range (institutional selling area)
- Equilibrium: Middle 5% representing fair value
- Discount Zone: Lower 5% of swing range (institutional buying area)

The zones dynamically update based on trailing swing extremes and adapt to current market structure.

MARKET STRUCTURE BREAKS (MSB):

Identifies when price breaks through significant swing points:
- Bearish MSB: Price closes below swing low
- Bullish MSB: Price closes above swing high
- Labels appear only on trend direction changes
- Horizontal lines extend from break point

TRADING SESSIONS (Optional):

Displays time-based session boxes for:
- Asian Session (Tokyo + Sydney combined)
- London Session
- New York Session

Features:
- Customizable session times and time zones
- Session high/low tracking
- Overlap detection showing when multiple sessions are active
- Fully configurable colors and display options

───────────────────────────────────────
HOW TO USE
───────────────────────────────────────

MASTER TOGGLE CONTROLS:

Use these to enable/disable major features:
- Key Liquidity Levels (Main feature)
- Premium/Discount Zones
- Order Blocks
- Market Structure Breaks
- Trading Sessions

MULTI-TIMEFRAME LIQUIDITY STRATEGY:

Conservative Approach:
1. Wait for HTF liquidity sweep (4H or Daily level)
2. Look for LTF confirmation (1H level hold)
3. Enter when order block forms at discount (bullish) or premium (bearish)

Aggressive Approach:
1. Trade LTF liquidity sweeps in direction of HTF trend
2. Use order blocks for entry refinement
3. Target next LTF or HTF liquidity level

Range Trading:
1. Identify premium and discount zones
2. Buy at discount, sell at premium
3. Use equilibrium as profit target or re-entry

ORDER BLOCK TRADING:

Entry Method:
1. Wait for order block formation (after structure break)
2. Enter on first return to order block zone
3. Place stop beyond the order block

Strength Analysis:
- Wider bullish section = stronger institutional buying
- Wider bearish section = more selling pressure
- Use this to gauge conviction

Violation:
- Order block broken = setup invalidated
- Look for next order block in continuation

MARKET STRUCTURE TRADING:

MSB signals potential trend change:
- Bearish MSB + Bearish OB = short opportunity
- Bullish MSB + Bullish OB = long opportunity
- Wait for retest of broken level for confirmation

───────────────────────────────────────
CONFIGURATION GUIDE
───────────────────────────────────────

KEY LIQUIDITY SETTINGS:

Pivot Detection:
- Left Bars (Default: 15): Lookback period for pivot identification
- Right Bars (Default: 5): Confirmation period
- Higher values = fewer, more significant levels
- Lower values = more frequent, sensitive levels

Timeframe Selection:
- HTF: Recommended 4H, 1D, or 1W for swing trading
- LTF: Recommended 1H or 4H for day trading
- CTF: Use for scalping on current chart timeframe

Display Options:
- Display Limit: Maximum number of levels shown per timeframe
- Extension: Short/Current/Max - how far lines extend
- Line Width: Visual prominence (1-5)
- Text Size: Label size adjustment

Mitigation:
- Remove: Delete levels when swept (cleaner chart)
- Show: Keep swept levels visible with reduced opacity

ORDER BLOCKS SETTINGS:

Core Parameters:
- Swing Length (Default: 8): Sensitivity for structure detection
- Show Last X (Default: 4): Number of active blocks displayed
- Violation Check: Choose Wick or Close-based invalidation
- Hide Overlap: Remove overlapping blocks for clarity

PREMIUM/DISCOUNT ZONES:

- Swing Detection Length (Default: 50): Range calculation period
- Longer period = broader zones, more stable
- Shorter period = tighter zones, more reactive

TRADING SESSIONS:

Time Configuration:
- Adjust session times for your timezone
- Use IANA timezone database format recommended
- Days to Show: Historical session display (0-10)

Visualization:
- Session boxes with colored backgrounds
- Optional high/low lines within each session
- Optional open/close lines
- Overlap highlighting when sessions coincide

───────────────────────────────────────
ALERT SYSTEM
───────────────────────────────────────

Available Alerts:
- HTF High Liquidity Hit
- HTF Low Liquidity Hit

Alert Configuration:
1. Enable HTF Liquidity Alerts in settings
2. Select specific alert types (High/Low)
3. Create TradingView alert with "Any alert() function call"
4. Alerts fire once per bar when liquidity is swept

Alert Message Format:
- Event type and description
- Timeframe information
- Current price
- Timestamp

───────────────────────────────────────
RECOMMENDED TIMEFRAME COMBINATIONS
───────────────────────────────────────

Swing Trading:
- Chart: 4H or 1D
- HTF Liquidity: 1D or 1W
- LTF Liquidity: 4H or 1D

Day Trading:
- Chart: 15m or 1H
- HTF Liquidity: 4H or 1D
- LTF Liquidity: 1H or 4H

Scalping:
- Chart: 5m or 15m
- HTF Liquidity: 1H or 4H
- LTF Liquidity: 15m or 1H
- Enable CTF Liquidity

───────────────────────────────────────
PERFORMANCE NOTES
───────────────────────────────────────

This indicator is optimized for performance:
- Uses max_bars_back declarations to limit lookback
- Conditional execution based on toggle settings
- Efficient array management for drawing objects
- Recommended for intraday timeframes only
- Sessions feature requires intraday timeframes

───────────────────────────────────────
EDUCATIONAL DISCLAIMER
───────────────────────────────────────

This indicator identifies areas where institutional orders may be positioned based on historical price action. It uses standard technical analysis techniques:
- Pivot point detection for liquidity levels
- Swing analysis for market structure
- Volume-weighted order block strength
- Time-based session filtering

The indicator does not predict future price movements. Always combine with your own analysis, risk management, and trading plan.

───────────────────────────────────────
USAGE DISCLAIMER
───────────────────────────────────────

This tool is for educational and analytical purposes. Past performance does not guarantee future results. Trading involves substantial risk of loss. Always conduct your own due diligence and never risk more than you can afford to lose.