High Timeframe Candle Overlay (Configurable)

HTF Candle Overlay — Read Higher Timeframe on Lower Timeframe Charts

What it does
This indicator draws each selected Higher-Timeframe (HTF) candle directly on your lower-timeframe (LTF) chart. It shows a translucent range box (HTF high–low) and an inner body box (HTF open–close), so you can track how the bigger candle is forming while you analyze lower-timeframe structure, liquidity sweeps, and intrabar reactions.

Why it’s helpful
• See where the current HTF candle opened, where price sits inside its body, and how far wicks extend—without leaving your LTF chart.
• Combine HTF context (e.g., 1H/4H) with LTF execution (e.g., 1m–15m) to spot confluence, S/R flips, and failed breaks faster.
• The overlay is locked to the price scale and anchored by bar index, so it pans/zooms exactly with your chart (no drifting while dragging).

⸻

How it works (under the hood)
• Fetches HTF OHLC via request.security.
• When a new HTF bar starts, the previous HTF boxes are frozen at the true close.
• The current HTF bar updates intrabar (so you see live formation) and is clamped to the correct span.
• Horizontal anchoring uses bar index, and a hidden price plot binds the script to the main price scale for stable zoom/pan behavior.

⸻

Inputs
• High Timeframe (HTF): Default 1H (set any TF you like).
• Show High–Low Box: On/off.
• Show Body Box (Open–Close): On/off.
• Opacity for range/body boxes.
• Bull/Bear Colors and Outline + Width.
• Max HTF Candles to Keep: Auto-deletes older boxes to maintain performance.

⸻

Usage tips
• Popular combos: view 1H or 4H candles while trading 1–15m charts.
• Turn off the range box if you only want a clean HTF body overlay.
• Pair with your session/structure tools; this indicator is visual context only (no signals or alerts).

⸻

Notes & limitations
• Non-repainting for closed HTF bars: once an HTF candle closes, its boxes are fixed. The current/in-progress HTF bar updates until it closes (expected live behavior).
• Data alignment depends on your symbol’s feed and session settings. Heikin Ashi/renko/etc. may not match classic OHLC.
• Heavy history + many boxes can affect performance; reduce “Max HTF Candles to Keep” if needed.

⸻

Disclaimer

This script is for education and charting visualization only. It does not provide financial advice, trade signals, or performance guarantees. Always do your own research and manage risk.