Kinetic MACD Nexus Candle Overlay

What the indicator does
-Kinetic MACD Nexus Candle Overlay is the on-chart visual companion to Kinetic MACD Nexus (linked below). It colors candle wicks on your price chart according to the same five-state directional bias computed by the panel indicator: Strong Buy, Buy, Neutral, Sell, and Strong Sell. The candle bodies and borders are rendered fully transparent so the overlay does not interfere with your existing chart appearance — only the wicks carry the bias signal.

How it works
-This overlay runs the identical three-layer MACD bias engine as the panel indicator. It calculates three separate MACD histograms at three user-defined timeframes and evaluates their agreement through the same cascading decision logic:
-Slow layer (default 2W, MACD 12/26/9): Determines macro trend direction based on histogram polarity. Positive histogram = bullish macro environment, negative = bearish.
-Medium layer (default 1W, MACD 10/22/9): Confirms or denies the slow layer's direction. The slow and medium layers must agree for the indicator to produce any directional bias. When they disagree, the bias is Neutral.
-Fast layer (default 3D, MACD 8/17/9): Provides the momentum trigger. Unlike the other two layers, it requires three simultaneous conditions to confirm: histogram on the correct side of zero, MACD line on the correct side of its signal line, and histogram accelerating (current value exceeding previous value in the directional sense). Meeting all three conditions upgrades the bias from Buy to Strong Buy (or Sell to Strong Sell).

The resulting five-state bias is mapped to wick colors:
-Bias State
-Default Wick Color Meaning:
Strong Buy
-Bright green Full three-layer bullish alignment, fast momentum confirmed and accelerating
Buy
-Dark green Slow and medium layers bullish, fast layer not fully confirmed
Neutral
-Black Slow and medium layers disagree, no directional edge
Sell
-Dark red Slow and medium layers bearish, fast layer not fully confirmed
Strong Sell
-Bright red Full three-layer bearish alignment, fast momentum confirmed and accelerating
All colors are customizable. Non-repaint mode is enabled by default, ensuring higher-timeframe data only updates after candle close.

Why it exists as a separate script
-TradingView's Pine Script architecture requires an indicator to declare itself as either overlay (drawn on the price chart) or non-overlay (drawn in a separate pane). It cannot do both. The Kinetic MACD Nexus panel indicator needs a separate pane to display its three histogram layers, divergence lines, and zero line. This overlay needs to draw directly on the price chart to color wicks. Splitting the system into two linked scripts is the only way to deliver both the detailed histogram panel and the at-a-glance wick coloring simultaneously.

-Both scripts expose the same configurable inputs with the same default values. When both are loaded with matching settings, their bias calculations produce identical results on every bar.

How to use it
-Add the Kinetic MACD Nexus panel indicator to a pane below your chart for the full histogram visualization, dashboard, and divergence detection.
-Add this overlay to the same chart. The wicks will immediately reflect the multi-timeframe bias state.
-Verify that all settings match between both scripts: timeframes (2W/1W/3D by default), MACD lengths (12/26/9, 10/22/9, 8/17/9 by default), source (close by default), and non-repaint mode (on by default). If you use defaults on both, no adjustment is needed.
-When scanning through a watchlist or monitoring multiple charts, the wick color gives you an instant read on the multi-timeframe momentum state without needing to examine the histogram panel in detail. Bright green wicks = strong bullish alignment. Bright red = strong bearish. Black = conflicting signals, stay cautious.

-Companion script: Kinetic MACD Nexus — [link:tradingview.com/script/qVNJwcQR-Kinetic-MACD-Nexus/].
That script provides the three-layer MACD histogram panel, gradient-normalized intensity visualization, candle body coloring, optional dashboard, and fast-layer divergence detection.

Disclaimer
This indicator is a technical analysis tool and does not constitute financial advice. No indicator guarantees future price movement. Always use proper risk management. The overlay is suitable for any liquid market (stocks, forex, crypto, commodities, indices) and is designed primarily for swing trading and position trading on daily charts with higher-timeframe MACD layers. Timeframes and MACD lengths are fully adjustable for adaptation to different trading styles, including intraday swing trading on compressed timeframe settings.