Institutional Candle Detector [AGPro Series]🕯️ Institutional Candle Detector
Every trader has stared at a massive candle and asked the same question: "Was that the start of a move, the end of one, or just noise?" Most indicators stop at detection — they paint the candle, drop a label, and walk away. This one keeps watching.
Institutional Candle Detector uses a dual-track engine. The body-driven track flags high-conviction candles where ATR-normalized body size and relative volume both expand together, then classifies each event by body/wick geometry. The independent absorption track captures a different signature entirely — low-body candles on extreme volume, the classic aggression-absorbed footprint that body-only detectors miss. Every detected event is then re-evaluated over the following bars to produce a measurable outcome scorecard.
🔹 OVERVIEW
The script scans each bar for two separate, mutually-exclusive institutional signatures:
• Body-driven events. Body must exceed a multiple of ATR AND volume must exceed a multiple of its rolling average. Classified by geometry into Continuation, Reversal or Exhaustion.
• Absorption events. Volume extremely elevated BUT body contained — the market paid for a big move and did not get one. Price was absorbed.
Every detected candle is then given a reaction zone projected forward, and its outcome is automatically tagged after the configured look-forward window — Follow-Through (FT), Reverse (RV) or Consolidation (CN). The panel accumulates aggregate statistics across the loaded chart so the trader can see which candle type actually works on their instrument and timeframe.
🔸 UNIQUE EDGE
What separates this tool from generic "big candle" or "volume spike" indicators:
• Dual-track detection. A single filter cannot capture both explosive moves and absorption. This script runs two engines in parallel with independent thresholds.
• Four-class geometric taxonomy, each backed by a distinct detection path. Continuation and Reversal fire from the body-driven track with different geometry. Exhaustion catches the mid-profile edge cases. Absorption runs entirely off its own volume-first track.
• Automatic after-behavior tracking. Each event is re-examined after N bars and tagged with an outcome code. This is the part most scripts omit — and it's where edge lives.
• Aggregate statistics panel. Follow-through rate, reverse rate, consolidation rate, and per-class counts are computed continuously. The panel tells you whether institutional candles on this asset actually extend, reverse, or fade.
• Forward-projected zones, colored by class. Body-driven bull/bear events use state colors. Absorption uses an indigo accent so the rarer signature is instantly recognizable. Reversal zones use the contrarian color to emphasize the expected directional flip.
🔹 METHODOLOGY
Body-Driven Track (produces CONT, REV, EXH)
– Body is measured as absolute (close − open) and required to exceed Body × ATR multiple.
– Volume is required to exceed a configurable multiple of its SMA average.
– An optional wick filter rejects candles where total wick exceeds the body beyond a given ratio, removing wide-range noise that looks institutional but is not.
– Continuation: body% ≥ configured threshold (clean directional close).
– Reversal: opposing wick% ≥ configured threshold (sharp rejection after initial push).
– Exhaustion: passes the dual-gate but falls into neither clean category — mid profile, often late in a move.
Absorption Track (produces ABS)
– Volume must exceed an independently configurable multiple (higher than body-driven default).
– Body must be small — below a max Body × ATR and below a max Body / Range.
– When absorption fires, it takes precedence over body-driven classification.
After-Behavior Layer
– After lookFwd bars, the script compares the extreme price move in each direction against the original body size.
– If same-direction extension ≥ ftPct × body → Follow-Through (FT).
– If opposite-direction retrace ≥ revPct × body → Reverse (RV).
– Otherwise → Consolidation (CN).
Aggregate counters accumulate across the loaded chart, producing a running scorecard visible in the panel.
🔸 SIGNALS, STATES & MARKERS
On-chart signals
• Institutional body recolored by class — bull/bear direction for CONT and EXH; contrarian color for REV; accent color for ABS.
• Directional triangle marker above/below the bar.
• Classification label: INST-Bull 3.2x CONT or INST-Bear 5.4xV ABS format, ASCII only. Labels offset from the candle to stay readable on dense charts.
• Reaction zone box projected forward from the candle's high-low range, color-coded by class.
• Outcome marker (FT / RV / CN) plotted lookFwd bars after the event.
Alerts available
• Institutional Continuation
• Institutional Reversal
• Institutional Absorption
• Institutional Exhaustion
All four alerts fire on confirmed bars only.
🔹 KEY INPUTS
Detection Core (body-driven track)
– ATR Length (default 14)
– Volume Average Length (default 20)
– Min Body × ATR (default 2.0)
– Min Volume Multiple (default 2.5)
– Wick filter toggle and max Wick/Body ratio (default 2.5)
Absorption Track
– Enable Absorption Detection
– Absorption Min Volume Multiple (default 4.0)
– Absorption Max Body × ATR (default 1.5)
– Absorption Max Body / Range (default 0.40)
Classification
– Continuation body% threshold (default 0.60)
– Reversal opposing-wick% threshold (default 0.40)
After-Behavior
– Look-forward bars (default 5)
– Follow-through threshold as fraction of body (default 0.50)
– Reverse threshold as fraction of body (default 0.60)
Visuals
– Show/hide zones, zone projection length, opacity, max active zones
– Label size (default Small; increase if labels feel too compact)
– Institutional border width
– Outcome marker toggle
Panel
– 8-position panel placement
– Dark / Light theme
– Font size (default Normal)
– Recent events mini-list toggle
🔸 HOW TO USE
1. Start with defaults on a liquid asset. 4H is a strong baseline; 1H for active traders; Daily for swing context. On Daily, consider lowering Min Body × ATR to 1.5 if events are too rare.
2. Watch the panel accumulate events over two to four weeks on your instrument. The follow-through rate tells you whether institutional candles on this chart tend to extend or fade.
3. Trade-context usage:
– Continuation with a high historical follow-through rate on this asset → trend trades in candle direction after pullback into the zone.
– Reversal with a high historical reverse rate → fade setups at key levels.
– Absorption → aggressive flow was met by an equal or greater defender; often precedes a reversal or compression phase.
– Exhaustion → proceed with caution; frequently a late-move signature where the trend is losing clean structure.
4. Reaction zones act as provisional supply/demand. A retest of a zone with another institutional event near it is a confluence worth noting.
5. Tune thresholds per asset. High-liquidity instruments may need Body × ATR of 2.5+ to keep events selective; low-liquidity pairs can go down to 1.5. Absorption volume multiple can also be adjusted upward on already-volatile instruments.
🔹 LIMITATIONS & TRANSPARENCY
• This is an analytical indicator, not a strategy. No entry, exit, or stop logic is defined and no performance claims are made.
• Aggregate statistics are computed over the loaded chart window and will shift as more bars load or as timeframes change.
• Volume quality depends on the data feed; exchange-reported volume differs across sources for the same asset.
• Follow-through evaluation uses a fixed look-forward window; real trade management will differ.
• All results are historical and descriptive. Past behavior of any candle class does not guarantee future behavior.
🔸 RISK DISCLOSURE
Trading carries substantial risk. This tool is provided for analytical and educational purposes. Do your own research. Use position sizing and risk management appropriate to your account. Nothing in this script constitutes financial advice.
Indikator Pine Script®






















