AI Gold Liquidity Breakout Catcher

Title: Gold AI Liquidity Breakout Catcher
Description:
Indicator Philosophy and Originality:
This indicator is not merely a collection of separate tools, but an integrated trading framework designed to improve decision-making by ensuring signal confluence. The core philosophy is that high-probability trading signals occur when multiple, distinct analysis methodologies align.
The originality of this script lies in how it systematically combines a leading signal (the Liquidity Breakout) with multiple, independent lagging confirmation tools (the Classic Filters, the Hull MA, and the Range Filter). A user can see a primary breakout signal and immediately validate its strength against the broader trend defined by the Hull MA, the intermediate trend from the Range Filter, and the specific conditions of the classic filters.
This synergy, where different components work together to validate a single event, is the primary value and reason for this mashup. It provides a structured, multi-layered confirmation process within a single tool, which is not achievable by adding these indicators separately to the chart.
This indicator is a comprehensive technical analysis tool designed to identify potential trading opportunities and provide supplemental trend analysis. It features a primary signal engine based on pivot trendline breakouts, a sophisticated confirmation layer using classic technical indicators, and three separate modules for discretionary analysis: an ICT-based structure plotter, a highly customizable Hull Moving Average (HMA), and a volatility-adaptive Range Filter. This document provides a detailed, transparent explanation of all underlying logic.
1. Core Engine: Pivot-Based Liquidity Trendline Signals
The indicator's foundational signal is generated from a custom method we call "Liquidity Trendlines," which aims to identify potential shifts in momentum.
How It Works:
The script first identifies significant swing points in the price using ta.pivothigh() and ta.pivotlow().
It then draws a trendline connecting consecutive pivot points.
A "Liquidity Breakout" signal (liquidity_plup for buy, liquidity_pldn for sell) is generated when the price closes decisively across this trendline, forming the basis for a potential trade.
2. The Signal Confirmation Process: Multi-Layered Filtering System
A raw Liquidity Breakout signal is only a starting point. To enhance reliability, the signal must pass through a series of user-enabled filters. A final Buy or Sell signal is only plotted if all active filter conditions are met simultaneously.
General & Smart Trend Filters: Use a combination of EMAs, DMI (ADX), and market structure to define the trend.
RSI & MACD Filters: Used for momentum confirmation.
Directional Body Strength Filter: A custom filter that validates the signal based on the strength and direction of the signal candle's body (bodyUpOK / bodyDownOK).
Support & Resistance (S&R) Filter: Blocks signals forming too close to key S&R zones.
Higher Timeframe (HTF) Filter: Provides confluence by checking the trend on higher timeframes.
3. Visual Aid 1: ICT-Based Structure & Premium/Discount Zones
This module is for visual and discretionary analysis only and does not directly influence the automated Buy/Sell signals.
ICT Market Structure: Plots labels for CHoCH, SMS, and BMS based on a Donchian-channel-like logic.
ICT Premium & Discount Zones: When enabled, it draws colored zones corresponding to Premium, Discount, and Equilibrium levels.
4. Visual Aid 2: Hull Moving Average (HMA) Integration
This is another independent tool for trend analysis. It does not affect the primary signals but has its own alerts and serves as a powerful visual confirmation layer.
Functionality: Includes multiple Hull variations (HMA, THMA, EHMA), customizable colors based on trend, and the ability to pull data from a higher timeframe.
5. Visual Aid 3: Range Filter Integration
This module is a volatility-adaptive trend filter that provides its own set of signals and visuals. It is designed to be a standalone trend analysis tool integrated within the indicator for additional confluence.
How It Works: The Range Filter calculates a dynamic volatility threshold based on the average range of the price. A central filter line moves up or down only when the price exceeds this threshold, effectively filtering out market noise.
Visuals: It plots the central filter line and upper/lower bands that create a volatility channel. It can also color the price bars based on the trend.
Signals & Alerts: The Range Filter generates its own "Manual Buy" and "Manual Sell" signals when the price crosses the filter line after a change in trend direction. These signals have their own dedicated alerts.
6. Risk Management & Additional Features
TP/SL Calculations: Automatically calculates Take Profit and Stop Loss levels for the primary signals based on the ATR.
Multi-Timeframe (MTF) Scanner: A dashboard that monitors the final Buy/Sell signal status across multiple timeframes.
Session Filter & Alerts: Allows for restricting trades to specific market sessions and configuring alerts for any valid signal.
By combining breakout detection with a rigorous confirmation process and multiple supplemental analysis tools, this indicator provides a structured and transparent approach to trading.