こちらはMarkitTickさんの有料スペースです。TradingViewから直接有料コンテンツにアクセスできるようになりました。有料スペースの詳細についてはこちら をご覧ください。 Pattern & Volume Profile [MarkitTick] 💡 Price rarely moves in straight lines. It coils, consolidates, and compresses before it commits — and the shapes it draws during those pauses have been studied by chart readers for the better part of a century. Pattern & Volume Profile is a single-chart analysis environment that watches for those shapes as they form, measures the quality of each one against a battery of structural checks, and pairs the resulting map of price geometry with a volume-based view of where the market has actually done its business. The result is a tool that answers two questions at once: what shape is price forming right now, and does the volume behind that shape justify paying attention to it. It is built for traders who work from structure — breakout traders, swing traders, and anyone who wants their pattern reads backed by an objective read on participation rather than by eyeballing alone.
Rather than flooding the chart with every squiggle it can find, the tool is deliberately selective. It surfaces the most relevant active formation, frames it with an entry, a protective level, and a measured objective, and then continuously grades it — telling you not just that a flag exists, but how clean it is, how quickly it built, whether a competing pattern disagrees with it, and how much longer it can reasonably be considered valid. Layered underneath is a horizontal volume profile that reveals the price levels where trading has concentrated, so structural signals can be read in the context of genuine acceptance and rejection zones.
✨ Originality and Utility
● A unified structure-and-participation workspace
Most pattern tools stop at drawing a triangle and firing an arrow. Most volume-profile tools ignore chart structure entirely. This indicator fuses both disciplines into one overlay so that a breakout is never evaluated in isolation — it is evaluated against the volume shelf it is breaking away from and the acceptance zone it is leaving behind. That pairing is the core of the tool's value: geometry tells you where the market might go, and the profile tells you whether the market agrees.
● Quality-first, not quantity-first
The engine is designed around the idea that one well-formed pattern is worth more than ten sloppy ones. Every candidate formation passes through a series of structural gates — proportion, symmetry, size relative to volatility, breakout conviction, and participation — before it earns a place on the chart. The tool then keeps the display uncluttered by focusing on the most relevant active setup, so the trader's attention is directed rather than scattered.
● A grading layer that thinks the way an experienced chartist does
Beyond simple detection, the tool exposes a suite of interpretive scores that mirror the judgments a seasoned pattern trader makes instinctively: is this pattern tidy or messy, did it form too fast to trust, is another pattern arguing the opposite direction, is the neckline being respected, and has this setup gone stale. These readings translate hard-won discretionary intuition into consistent, repeatable outputs.
● Execution-ready framing
Each qualifying pattern is presented with a complete trade skeleton: a reference entry, a protective level with a volatility-aware buffer, a measured target derived from the pattern's own dimensions, and optional staged objectives. Risk-to-reward is surfaced with realistic friction — slippage and commission — folded in, so the quality of a setup reflects what a trader would actually experience rather than an idealized paper result.
🔬 Methodology and Concepts
● Pattern Recognition
The tool watches for the classic family of continuation and transition formations that traders have relied on for generations.
Bullish and Bearish Flags — Brief, counter-trend consolidations that lean against the prevailing move, typically resolving in the direction of the impulse that preceded them. A strong reading here reflects a tight, well-proportioned channel with a decisive breakout.
Bullish and Bearish Pennants — Small symmetrical compressions that follow a sharp move, representing a pause before continuation. Their value lies in the tightness of the coil and the sharpness of the release.
Rising and Falling Wedges — Converging structures that lean with a slope, often signalling exhaustion of the prevailing move and a reversal of pressure. The interpretive weight depends on how cleanly the boundaries converge and where price breaks.
Triangles — Converging ranges that reflect a balance between buyers and sellers tightening toward a resolution point. A quality triangle shows repeated, respected touches of both boundaries before the break.
● Structural Validation
Every candidate is measured before it is trusted.
Proportion and Symmetry — Quantifies how balanced a formation is against a user-defined tolerance. Well-balanced structures are historically more reliable than lopsided ones.
Size Qualification — Screens out formations too small to be meaningful, judged both against price and against prevailing volatility, so noise is not mistaken for structure.
Breakout Conviction — Assesses whether price has genuinely committed beyond a boundary, with optional requirements for closing beyond the line, breaking with a full candle body, and sustaining the move across consecutive bars.
Participation Filter — Optionally requires a surge in activity to accompany a breakout, reflecting the long-standing principle that moves backed by volume are more trustworthy than moves that are not.
● Pattern Intelligence
This layer grades each qualifying setup across several independent dimensions.
Pattern Quality Score — A composite grade that blends the structural checks into a single readable figure. Higher readings reflect setups that satisfy more of the tool's reliability criteria; lower readings flag formations that pass detection but carry caveats.
Multi-Pattern Confluence — Reflects how many independent signals point the same direction at once. Agreement across signals strengthens conviction; isolation weakens it.
Pattern Heatmap Score — A consolidated temperature reading of the current opportunity, letting the trader gauge at a glance whether conditions are hot or cold.
Higher Timeframe Bias — Surfaces the directional lean of a larger timeframe so that setups can be filtered for alignment with the broader trend rather than fought against it.
Neckline Strength Decay — Reflects how often and how faithfully a key boundary has been respected. A frequently and cleanly touched level carries more significance than one grazed once.
Pattern Cleanliness Score — Captures how tightly price has hugged the formation's boundaries. Tidy structures with little wandering read as clean; erratic, choppy formations read as messy.
Cross-Pattern Conflict Warning — Flags situations where a competing formation argues the opposite direction, warning the trader that the picture is contested rather than clear.
Formation Speed Score — Reflects how quickly a pattern built relative to its historical norm. Formations that assemble unusually fast can behave differently from those that develop at a measured pace.
Pattern Decay Timer — Communicates how much longer a setup can reasonably be considered valid before age erodes its relevance, discouraging trades on stale structure.
● Trade Framing
Measured Targets — Objectives derived from the formation's own dimensions, following the traditional practice of projecting a pattern's height from its breakout point.
Protective Levels — A stop reference set with a volatility-aware buffer, or optionally sized as a fraction of the target distance, so protection scales with conditions.
Staged Objectives — Optional first, second, and third targets that support scaling out of a position in tranches.
Risk-to-Reward Quality — A realistic read on the payoff of a setup that accounts for slippage and commission, filtering out trades whose reward does not justify their risk.
● Volume Profile
Volume-at-Price Distribution — Reveals how trading activity has been distributed across price levels, exposing where the market has spent the most effort.
Point of Control — Highlights the single price level of greatest accepted activity, often a magnet and a decision point for future moves.
Value Area — Marks the band of prices that contains the bulk of activity, defining where the market considers itself in balance. Edges of this band frequently act as support and resistance.
🎨 Visual Guide
● The Active Pattern
The most relevant qualifying formation is drawn directly on price with its converging or channelling boundaries, filled with a semi-transparent tint keyed to direction — one hue for bullish structures, another for bearish. A compact label names the pattern so it is identified at a glance.
● Trade Skeleton
When a setup qualifies, the chart renders a reference entry line, a protective level, and a measured target, each colour-coded and labelled. Optional staged target lines mark the first, second, and third objectives. Shaded fills between entry and the protective level, and between entry and target, give an immediate visual sense of the risk-to-reward geometry.
● Volume Profile
A horizontal histogram along the price axis shows where activity has concentrated, with row shading scaling from lighter to denser as participation rises. The Point of Control row is highlighted, and the Value Area is shaded as a band with optional boundary lines marking its high, its low, and the control level.
● The Dashboard
A fixed, monospaced panel — positionable to any corner — presents the live state of the analysis in a clean, scannable layout. It reports the directional bias, the active pattern name, current volatility, the participation reading, risk-to-reward quality, structural depth, bars elapsed since the last breakout, and the count of tracked structural points. When their respective modules are enabled, it also surfaces the quality grade, higher-timeframe bias, confluence, heatmap temperature, neckline strength, cleanliness, conflict status, formation speed, decay countdown, and the staged target levels. Readings are colour-graded so that strong, moderate, and weak states are distinguishable at a glance.
● Colour Language
Direction is communicated through a consistent two-hue scheme — a cool tone for bullish conditions and a warm tone for bearish. Score readings shift through a graded palette from strong to neutral so the trader can read conviction by colour alone. Every colour in the tool is user-configurable.
📖 How to Use
● Getting started
Apply the tool to any symbol and timeframe. Out of the box it will begin tracking structure, surface the most relevant active formation with its trade skeleton, and render the volume profile and dashboard. The default settings are a sensible starting point; refinement comes from tailoring the filters to your market and style.
● Reading a setup
Begin with the dashboard. Confirm the directional bias, then check the active pattern name and its quality grade. A high-quality reading, agreement from confluence, a clean structure, and a healthy risk-to-reward figure together describe a setup worth attention. A low grade, a conflict warning, a messy structure, or an expired decay timer are all reasons to stand aside.
● Layering the volume profile
Use the profile to contextualise the geometry. A breakout that clears the Value Area and moves away from a well-defined Point of Control carries more weight than one that stalls inside a dense acceptance zone. The Value Area edges and the control level make natural reference points for targets and protective placement.
● Aligning with the bigger picture
Enable higher-timeframe bias to filter for setups that agree with the broader trend. Taking continuation patterns in the direction of the larger trend, and treating counter-trend signals with added caution, is a durable way to tilt the odds.
● Managing the trade
Use the reference entry, protective level, and measured target as a framework rather than a mandate. Staged objectives support scaling out. The decay timer helps you retire a setup that has aged past its useful window, and the conflict warning helps you avoid committing when the structure is contested.
● Automation
Alerts can be dispatched as structured messages carrying the entry, protective level, and target, with configurable action labels — supporting hands-off routing to compatible automation endpoints while keeping the trader in control of the logic.
● Workflows the tool supports
Breakout trading — Identify qualifying formations and act on confirmed, participation-backed breaks.
Structure screening — Scan across symbols for clean, high-grade setups using the quality and cleanliness reads.
Context confirmation — Overlay the volume profile on any existing method to confirm whether price is entering or leaving acceptance.
Trend-aligned continuation — Filter continuation patterns through higher-timeframe bias.
⚙️ Inputs and Settings
● Core Settings
Pattern Cooldown (Bars) — Minimum spacing between fresh pattern displays, preventing rapid-fire repetition.
Symmetry Tolerance (%) — How balanced a formation must be to qualify; tighter values demand more symmetric structures.
Min Pattern Size (% of Price) — Rejects formations too small relative to price.
Min Pattern Size (ATR Multiplier) — Rejects formations too small relative to prevailing volatility.
Max Patterns Displayed — Caps how many formations appear at once, keeping the chart focused.
● Patterns
Bullish Flag / Bearish Flag — Toggle detection of flag continuations.
Bullish Pennant / Bearish Pennant — Toggle detection of pennant continuations.
Rising Wedge / Falling Wedge — Toggle detection of wedge formations.
Triangle — Toggle detection of converging triangle ranges.
● Pivot
Pivot Lookback Left / Right — Define how prominent a swing must be to count as a structural point; larger values yield fewer, more significant pivots.
Max Pivots to Remember — How many structural points the tool retains for its analysis.
● Filters
Require Candle Close Outside? — Demand a close beyond a boundary to confirm a break.
Require Full Body Breakout? — Demand a full candle body beyond the boundary.
Use ATR for Threshold? — Base breakout distance on volatility rather than a fixed percentage.
Breakout Threshold (ATR) / (%) — How far beyond a boundary price must travel to confirm.
Confirmation Bars (Consecutive) — Require the break to hold across a number of bars.
Show Patterns Without Confirmation — Optionally display unconfirmed formations.
Scan Lookback Bars — How far back the breakout scan reaches.
Require Volume Spike? — Demand elevated participation on the break.
Volume Multiplier / Volume SMA Length — Define what counts as a participation surge and the baseline it is measured against.
Min Risk:Reward Ratio — Suppress setups whose payoff does not justify their risk.
Slippage (Ticks) / Commission (%) — Fold realistic friction into the risk-to-reward read.
● Visuals
Fill Transparency — Opacity of pattern fills.
Show Measured Targets — Toggle the projected objective.
Stop Loss ATR Buffer — Volatility cushion added to the protective level.
SL as % of Target Dist / SL % of Target Dist — Alternatively size protection as a fraction of the target distance.
Extend Breakout Lines — Project boundary lines forward.
Custom Label Scaling / Label Size — Control label sizing.
Freeze Current Pattern — Lock the active formation in place for study.
● Volume Profile
Show Volume Profile — Toggle the histogram.
Row Size — Granularity of the profile; more rows yield finer resolution.
Profile Width (%) — Horizontal extent of the histogram.
Highlight POC Row — Emphasise the control level.
Show Value Area / Value Area (%) — Toggle and define the balance band.
Show VAH/VAL/POC Lines — Draw boundary and control reference lines.
● Dashboard
Dashboard Position — Anchor the panel to any corner.
Normalized ATR Display — Present volatility in normalised terms.
● Pattern Intelligence
Pattern Quality Score — Enable the composite grade.
Multi-Pattern Confluence — Enable agreement tracking.
Pattern Heatmap Score — Enable the consolidated temperature read.
Higher Timeframe Bias / HTF Timeframe — Enable trend alignment and choose the reference timeframe.
Neckline Strength Decay / Neckline Touch Tolerance (ATR) — Enable boundary-respect tracking and set its sensitivity.
Pattern Cleanliness Score — Enable the tidiness read.
Cross-Pattern Conflict Warning — Enable contested-structure warnings.
Formation Speed Score — Enable the pace read.
Pattern Decay Timer / Decay Timer Multiplier — Enable the validity countdown and set its horizon.
Multiple TP Levels / TP1–TP3 % of Target Dist — Enable staged objectives and place each level.
● Alerts
Enable Alerts — Toggle alert dispatch.
Dynamic R:R Multiplier / R:R Multiplier — Optionally scale the target relationship.
Long / Short / Close Long / Close Short Action — Configurable labels injected into outgoing alert messages for automation routing.
● Colors
Full colour customisation — Directional hues, entry, protective, and target lines, staged target colours, dashboard styling, volume-profile shading, and score palettes are all user-configurable.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Classical chart pattern theory
The formation vocabulary at the heart of this tool descends directly from the foundational literature of technical analysis. The systematic treatment of flags, pennants, wedges, and triangles as continuation and reversal structures traces to Edwards and Magee's Technical Analysis of Stock Trends, the canonical reference that formalised pattern classification, and to the statistical cataloguing of pattern behaviour in the work of Thomas Bulkowski. The practice of projecting a measured objective from a pattern's own dimensions is a direct inheritance from this tradition.
● Auction market theory and volume at price
The volume-profile component rests on the auction-market framework developed by J. Peter Steidlmayer and elaborated in the Market Profile literature by Jim Dalton. Central to this view is the idea that markets seek areas of value through a continuous two-sided auction, that the point of greatest accepted activity acts as a reference around which price rotates, and that the value area delineates the zone of perceived fair pricing. Reading structure against these acceptance and rejection zones grounds pattern signals in participation rather than price alone.
● Volatility normalisation
The tool's reliance on a volatility measure to scale size thresholds, protective buffers, and boundary tolerances reflects the enduring influence of J. Welles Wilder's introduction of Average True Range in New Concepts in Technical Trading Systems. Normalising structural judgments to prevailing volatility allows the same logic to behave consistently across instruments and regimes.
● Trend context and multi-timeframe alignment
The higher-timeframe bias filter operationalises the long-standing principle — articulated across the works of Charles Dow and later trend theorists — that signals aligned with the dominant trend of a larger degree carry a structural advantage. Reading a lower-timeframe setup through the lens of a higher-timeframe lean is a formalisation of top-down analysis.
● Participation confirmation
The optional requirement that breakouts be accompanied by elevated activity reflects the classical volume-confirmation doctrine, a thread running from the earliest Dow-theory writings through Joseph Granville's work on volume as a leading indicator of price. The premise is simple and durable: conviction leaves a footprint in participation.
● Risk-adjusted evaluation
The insistence on a realistic risk-to-reward read that folds in transaction friction echoes the broader discipline of risk-adjusted performance evaluation. Just as the study of returns is meaningless without the study of the risk taken to earn them, a pattern signal is incomplete without an honest accounting of its payoff geometry and the frictional costs of acting on it.
⚠️ Disclaimer
This tool is provided for educational and informational purposes only. It does not constitute financial, investment, or trading advice, nor a recommendation to buy, sell, or hold any instrument. Chart patterns, volume analysis, and the derived scores are analytical aids, not forecasts; markets are inherently uncertain and no method can predict future price movement. Past behaviour of any pattern or signal is not a reliable indicator of future results. All trading involves substantial risk of loss, and you are solely responsible for your own decisions and their outcomes. Test any approach thoroughly and consider consulting a licensed professional before committing capital. We accept no liability for any loss or damage arising from the use of this tool. Auto Pattern Detector Targets Pro [MarkitTick] 💡 Markets communicate through structure. Before any breakout, before any reversal, before any continuation, price carves recognizable shapes into the chart — formations built from the tension between buying and selling pressure, repeated across instruments and timeframes with statistical consistency. Auto Pattern Detector Targets Pro is a comprehensive charting tool designed to surface these formations automatically, with breakout confirmation, measured price targets, precise stop placement, and a full suite of risk and intelligence filters that transform raw pattern recognition into structured, actionable trade setups. Rather than placing the burden of manual scanning on the analyst, this indicator monitors pivot structure continuously across the full history of the chart, identifies validated classical patterns at the moment they break out, and immediately renders entry levels, stop levels, and profit targets directly on the price pane — giving traders a complete trade plan the instant a pattern resolves. The result is a tool that serves as a vigilant, tireless pattern analyst: one that enforces objective criteria, ignores noise, and presents only the setups that meet the conditions the user specifies.
✨ Originality and Utility
● A Unified Pattern Engine, Not a Collection of Scripts
Most pattern-recognition tools available in public libraries address individual formation types in isolation — a dedicated Head and Shoulders script here, a flag detector there. This indicator unifies the detection of eighteen distinct classical patterns within a single, coherent analytical framework. Each pattern is held to the same configurable standards: minimum size thresholds, symmetry tolerances, breakout confirmation logic, volume validation, and risk-reward gating. The architecture ensures consistency across all formation types: a triangle is not evaluated more loosely than a wedge, and a Cup and Handle is not confirmed by weaker evidence than a Double Top. This uniformity is what separates a pattern engine from a collection of pattern detectors.
● Breakout Confirmation as a First-Class Citizen
Pattern identification without breakout confirmation is noise generation. This indicator treats breakout confirmation as the critical gate that separates a pending formation from an actionable event. Users can specify whether a breakout requires a candle close beyond the boundary, a full-body violation, or a wick penetration of configurable depth. Consecutive confirmation bars can be required before a pattern is accepted. The result is that every pattern displayed on the chart represents a formation that has resolved — not merely one that is forming.
● Complete Trade Plan on Every Confirmed Pattern
Every pattern that clears validation produces an immediately usable trade plan: a precisely located entry price, a stop loss that accounts for ATR-based buffer or a proportional distance from the target, and a measured price target grounded in classical measured-move methodology. No interpretation is required. The indicator does not suggest that "a breakout might occur" — it shows where to enter, where to stop out, and where the measured objective sits, with the risk-reward ratio rendered alongside each setup.
● Pro Intelligence Layer for Advanced Analysis
The indicator's advanced intelligence features represent a distinct tier of analytical depth unavailable in any comparable publicly available pattern tool. Pattern Quality Scoring, Multi-Pattern Confluence detection, Higher Timeframe Bias alignment, Neckline Strength Decay, Volume Point of Control breakout validation, Pattern Cleanliness Scoring, Cross-Pattern Conflict Warnings, Time Symmetry enforcement, Formation Speed benchmarking, Adaptive Tolerance scaling, Liquidity Sweep confirmation, and Pattern Decay timers collectively form an intelligence layer that filters out the marginal setups and highlights the high-conviction formations.
🔬 Methodology and Concepts
● Pivot-Based Pattern Recognition
All pattern detection is grounded in confirmed swing highs and swing lows — structural turning points in price that mark the anchor nodes from which pattern geometry is constructed. The indicator maintains a rolling history of confirmed pivot highs and lows, which serve as the raw material from which all eighteen pattern types are assembled. A user-configurable history depth determines how far back the pivot memory extends, allowing the engine to detect patterns that formed over extended periods without losing sight of recent structure. Pivot confirmation is enforced at the bar level: only confirmed closes contribute to pivot identification, ensuring that live-bar fluctuations do not generate premature or phantom pivots.
● Symmetry and Level Tolerance
Two foundational tolerance parameters govern how strictly pattern geometry is enforced. The symmetry tolerance controls how closely the left and right sides of symmetric patterns — such as the shoulders of a Head and Shoulders or the two peaks of a Double Top — must mirror each other in price terms. The level tolerance governs how precisely the key horizontal levels that define a pattern (the resistance peaks of a Triple Top, the support troughs of a Triple Bottom) must align. Tighter tolerances surface only geometrically precise formations; wider tolerances allow for real-world imperfection in market-produced patterns. Both tolerances can be scaled automatically with current volatility conditions when the Adaptive Tolerance feature is engaged.
● Minimum Size Validation
A pattern that forms across a two-tick range carries no analytical weight. The indicator enforces a minimum formation size expressed both as a percentage of the current price and as a multiple of the Average True Range. Both thresholds must be satisfied simultaneously, ensuring that only formations of meaningful price displacement are recognized — a critical filter for preventing the detection of micro-fluctuations that bear the shape but not the significance of classical patterns.
● Pattern Detection Scope — Eighteen Formation Types
The indicator covers the full spectrum of classical technical analysis formations. Reversal patterns in the library include: Double Top , Double Bottom , Triple Top , Triple Bottom , Head and Shoulders , and Inverted Head and Shoulders — the canonical distribution and accumulation archetypes of classical chart reading. Rounding Top and Rounding Bottom capture the gradual, curved exhaustion structures that precede momentum reversals without the sharp pivot geometry of their siblings.
Continuation patterns include: Bullish Flag and Bearish Flag , which reflect brief counter-trend consolidations within a strong directional pole; Bullish Pennant and Bearish Pennant , the converging-line variant of the flag; Ascending Triangle , Descending Triangle , and Symmetrical Triangle — the three classical triangle sub-types detected under a unified framework; Rising Wedge and Falling Wedge ; Rectangle consolidations; and finally Cup and Handle and Inverted Cup and Handle , the curved rounding formations with a handle consolidation that precede breakouts.
● Breakout Identification and Confirmation Logic
Once a pattern's geometric structure is validated, the indicator monitors price in relation to the relevant breakout level — which is the neckline for reversal patterns, the trendline boundary for continuation patterns, or the horizontal resistance/support level for rectangular formations. A breakout is identified when price penetrates this level by a threshold that can be expressed either as a multiple of the ATR or as a fixed percentage of price. The confirmation layer then verifies that the penetration meets the user's specified conditions — whether that is a wick break, a close break, a full-body break, or sustained breach across multiple consecutive bars. The first bar that satisfies all confirmation conditions simultaneously is recorded as the breakout bar, and the entry price is set to the open of that bar.
● Measured Move Target Methodology
Target placement follows the measured-move principle — one of the oldest and most empirically observed regularities in technical analysis. For each pattern family, the relevant measured distance is identified: the height of the formation from its most extreme internal point to its breakout level. This distance is then projected forward from the breakout level in the direction of the resolution. For reversal patterns, the target projects the full pattern height beyond the neckline. For flag and pennant patterns, the target extends the pole move beyond the pattern's resolution point. For wedges and triangles, the base height projects from the breakout. Measured-move targets represent probabilistic price objectives grounded in the principle that the energy stored in a formation tends to be released in a magnitude proportional to the compression that preceded it.
● Stop Loss Placement
Two stop loss methodologies are available. The ATR Buffer approach places the stop at the most extreme structural point of the pattern — the opposite shoulder extreme for Head and Shoulders variants, the lowest low for bullish patterns, the highest high for bearish patterns — with an additional ATR-based cushion to absorb normal volatility and reduce stop-outs from noise. The Proportional Stop approach places the stop at a user-defined percentage of the measured target distance below the entry, allowing the risk to scale with the reward in a fixed relationship. Both approaches ensure that the stop loss is structurally grounded rather than arbitrarily set.
● Risk-Reward Ratio Validation
Before any pattern is displayed, the indicator evaluates the adjusted risk-reward ratio of the implied trade. Slippage costs in tick terms and a round-trip commission percentage are both applied to the reward before the ratio is evaluated. If the adjusted ratio falls below the user's minimum threshold, the pattern is suppressed — regardless of how clean the formation appears geometrically. This filter ensures that only patterns where the expected reward genuinely exceeds the expected risk by the required margin are surfaced.
● Volume Spike Validation
When enabled, the volume filter requires that volume at the breakout bar exceed a user-specified multiple of the rolling volume average. Breakouts accompanied by elevated volume represent higher-conviction structural moves — the market is participating decisively in the resolution of the formation. This optional filter eliminates low-participation breakouts, which have historically exhibited higher false-breakout rates across most asset classes.
● Pattern Cooldown Control
To prevent the dashboard and chart from being flooded with successive re-detections of the same structural formation, the indicator enforces a cooldown expressed as a minimum number of bars that must separate successive pattern detections. If a new pattern originates from a start index that is too close in bar-time to the previously displayed pattern, it is suppressed until the cooldown window has elapsed. This prevents repetitive labeling of minor variations on the same underlying price structure.
● Pattern Quality Score (Pro)
The Pattern Quality Score is a composite numerical rating that synthesizes multiple formation attributes into a single score reflecting the overall conviction level of the detected pattern. It draws on volume behavior, risk-reward quality, and pivot density — three distinct dimensions of pattern health — and presents the result as both a numerical value and a graphical block-bar visualization in the dashboard. A high quality score indicates that all measured dimensions of the formation align favorably; a low score signals marginal confluence even when the geometric structure is technically valid.
● Multi-Pattern Confluence Detection (Pro)
The confluence engine runs all detection functions simultaneously and counts how many distinct pattern families are simultaneously detecting valid formations on the same chart at the same moment. A confluence count of two or more indicates that multiple independent analytical frameworks are simultaneously identifying the same directional bias, which historically reflects a more structurally significant market event than a single isolated detection.
● Higher Timeframe Bias Filter (Pro)
The HTF Bias Filter retrieves the confirmed close and a smoothed average price level from a user-specified higher timeframe. A bullish bias exists on the higher timeframe when the confirmed close is above the average; a bearish bias exists when it is below. The filter can be engaged to suppress patterns whose directional implication conflicts with the dominant trend of the higher timeframe — trading with the larger trend rather than against it.
● Neckline Strength Decay (Pro)
The neckline strength feature tracks how many times price approached the key breakout level within the pattern's formation window. Each touch of the level before a confirmed breakout incrementally weakens the structural support or resistance that level represents — a widely observed phenomenon in classical charting theory. The dashboard displays a score that reflects the remaining strength of the neckline at the time of breakout, offering context on whether the breach occurred through a still-strong level or through an already-exhausted one.
● Volume Point of Control Breakout Check (Pro)
The Volume Point of Control (Volume POC) feature identifies the approximate price level within the pattern formation window that attracted the greatest aggregate volume. This level represents the most contested price in the formation — the gravitational center of traded activity during the pattern's lifespan. The indicator then evaluates whether the breakout close occurred above or below this level, providing an additional structural confirming factor: a breakout that also clears the volume-weighted center of the formation is exhibiting a more decisive directional commitment than one that has not yet cleared this level.
● Pattern Cleanliness Score (Pro)
The cleanliness score measures how tightly price tracked the pattern's structural trendlines throughout the formation window. A clean pattern is one where price repeatedly tested and respected the bounding lines with minimal deviation; a messy pattern is one where price wandered broadly within the formation without clear adherence to the structural boundaries. The score is expressed on a zero-to-one-hundred scale and displayed in the dashboard, allowing analysts to distinguish geometrically crisp formations — which tend to produce sharper, more decisive breakouts — from loosely structured ones.
● Cross-Pattern Conflict Warning (Pro)
When both a bullish and a bearish pattern are simultaneously detected within a recent window, the conflict detector flags this condition in the dashboard. Simultaneous opposing signals from independent pattern families indicate structural indecision — a market that is simultaneously presenting buyers and sellers with evidence supporting their respective biases. Analysts can use this flag as a caution signal, deferring entry until directional resolution becomes clear.
● Time Symmetry Filter (Pro)
Price symmetry is the most visible characteristic of classical patterns, but temporal symmetry — the balance of bar-count between the left and right sides of a formation — is a less commonly enforced constraint that adds structural rigor to pattern validation. When enabled, the time symmetry filter requires that the bar-count distance between the anchor points of symmetric patterns falls within a configurable tolerance. This eliminates formations where the price symmetry is visually acceptable but the time distribution between the two sides is grossly unequal, a characteristic that often indicates a structurally weaker formation.
● Formation Speed Score (Pro)
The formation speed feature tracks the average bar-count duration of each pattern type that has been detected historically during the session, and compares the current formation's length against this running average. A pattern that forms unusually quickly may indicate a high-energy, compressed structure with greater potential energy at breakout; one that forms unusually slowly may signal a formation losing momentum. The speed score is presented relative to the historical average for that specific pattern type, providing a normalized benchmark rather than an absolute bar count.
● Adaptive Tolerance Scaling (Pro)
Market volatility is not constant, and fixed symmetry and level tolerances that work well in low-volatility conditions may be too tight during high-volatility regimes, causing valid patterns to be rejected. The adaptive tolerance feature automatically scales both symmetry and level tolerance in proportion to the current ATR percentile rank relative to recent history. In high-volatility conditions, tolerances widen to accommodate the greater natural variation in price swings; in low-volatility conditions, they tighten to maintain standard rigor. This allows the indicator to function consistently across varying market conditions without manual recalibration.
● Liquidity Sweep Confirmation (Pro)
The liquidity sweep filter — applicable specifically to Double Top and Double Bottom formations — requires that a wick-based stop-hunt occurred beyond the second swing point before the pattern is confirmed. A liquidity sweep is identified when price briefly violates the first swing's level via a wick and then closes back inside, exhibiting the stop-hunting behavior that precedes many genuine reversals in liquid markets. This filter is designed to exclude the subset of Double Top and Bottom formations where the second swing merely touches the first without the characteristic stop-hunt dynamics that characterize the most reliable instances of these patterns.
● Pattern Decay Timer (Pro)
Patterns do not remain valid indefinitely after their formation completes. An un-triggered pattern whose breakout zone has not yet been challenged by price after a significant number of bars may represent a stale setup where the structural energy that created the formation has dissipated. The decay timer counts down from a baseline duration — expressed as a multiple of the pattern's own average formation length — and displays the remaining valid bars in the dashboard. When the countdown expires, the pattern is flagged as stale.
🎨 Visual Guide
● Pattern Boundary Lines
Each confirmed pattern is rendered directly on the price pane with lines delineating its structural boundaries. For patterns defined by two converging or diverging trendlines — flags, pennants, wedges, and triangles — an upper and a lower boundary line are drawn from the formation's start to its breakout bar. For patterns defined by horizontal levels — rectangles — two flat horizontal lines mark the resistance and support zones. For reversal patterns defined by a neckline — Head and Shoulders, Double and Triple formations, Cups — the neckline is rendered as a line extending from its anchor points to the breakout. Lines are colored according to the pattern's directional implication: the bullish color for patterns that broke upward, the bearish color for patterns that broke downward. Line colors are fully user-configurable.
● Pattern Fill
The interior of each pattern's bounded region is filled with a semi-transparent color that mirrors the line color, creating a visually distinct zone on the chart. The fill transparency is user-configurable and defaults to a high transparency level to avoid obscuring the underlying price action. When the Gradient Fill option is enabled, the fill is rendered with an additional transparency layer, producing a softer visual that many analysts prefer for a less cluttered chart.
● Center Pattern Label
A text label identifying the pattern by name is placed at the geometric center of the formation — midway between the start and breakout bars, and midway between the upper and lower boundary levels. The label uses white text on a transparent background to remain readable without obstructing the price action. When the Pattern Status Icons feature is enabled, a formation status icon precedes the pattern name. Label size is user-configurable between small, normal, and large.
● Entry, Stop, and Target Lines
When measured targets are enabled, three horizontal dashed lines are drawn to the right of the breakout bar: an entry line at the price level where the trade would be initiated (the open of the breakout confirmation bar), a stop line at the calculated stop loss level, and a target line at the measured move objective. Each line extends rightward by fifty bars and is followed by a label reading the price level numerically alongside the pattern name and — in the case of the target label — the adjusted risk-reward ratio of the setup. Entry, stop, and target line colors are individually configurable, allowing users to create visually distinct representations that suit their workflow.
● Multiple Take-Profit Levels (Pro)
When Multiple TP Levels are enabled, the single target line is replaced by three dotted take-profit lines labeled TP1, TP2, and TP3. Each is positioned at a user-defined percentage of the measured target distance from the entry: TP1 typically represents the conservative partial-exit level, TP2 the full measured move, and TP3 the extended projection beyond the standard objective. Each take-profit level is rendered in a distinct color — cyan for TP1, green for TP2, and yellow-green for TP3 — to provide immediate visual differentiation.
● Breakeven Line (Pro)
The breakeven automation feature monitors for TP1 being reached while a pattern is active. When TP1 is hit, a dashed yellow line appears at the entry price level and extends forward in time, accompanied by a label reading "Move SL to BE." This serves as a visual prompt for traders who employ a breakeven stop-loss management strategy — the line persists and updates its right endpoint on every subsequent bar, remaining visible as long as the pattern is active.
● Risk Zone Visual (Pro)
The risk zone visualization renders a semi-transparent filled rectangle spanning the space between the entry price and the stop loss price, extending from the breakout bar to the target projection area. This box immediately conveys the exact magnitude of capital at risk in the setup and provides a visual reference for the relationship between the risk zone and subsequent price action. The fill color of the risk zone mirrors the stop line color at a high transparency level.
● Pattern History Dashboard
A compact two-column table in the upper-right corner of the chart provides a real-time summary of the most recently detected pattern. The dashboard reports the pattern name and its directional bias, the bars elapsed since detection, entry and stop prices, the adjusted risk-reward ratio, a volume strength score visualized as a block-bar progress indicator, and pivot count. When Pro features are enabled, the dashboard expands to include the Pattern Quality Score, HTF bias status, current ATR percentage, session filter status, and confluence count. When Extended Multi-Pattern Dashboard is enabled, a Recent Patterns section appears at the bottom of the table, logging the five most recently detected patterns with their formation status. The Advanced Intelligence section surfaces Neckline Strength, Volume POC status, Cleanliness Score, Cross-Pattern Conflict status, Formation Speed, and Decay Timer readings when their respective features are active.
● Pattern Heatmap Table (Pro)
The heatmap table provides a visual measure of pattern density and Quality Score context in a graphical block-bar format. The heatmap score reflects the concentration of recent price action in the formation window, offering an at-a-glance reading of how structurally active the market has been in recent bars.
● Pattern Replay Mode (Pro)
The Pattern Replay Mode feature allows analysts to simulate viewing the chart from a historical vantage point by applying a user-specified bar offset to all detection logic. By stepping backward through bars, users can observe how the indicator would have behaved at specific points in the past — a valuable tool for studying pattern behavior, validating setup quality in hindsight, and developing familiarity with the indicator's detection characteristics on a specific instrument.
● Candle-Level Coloring for Extended Indicators
The bullish and neutral/bearish colors defined in the Colors group also influence the text coloring of dashboard labels and pattern labels rendered on the chart, creating a coherent, unified color scheme that allows bullish and bearish patterns to be instantly differentiated at a glance.
📖 How to Use
● Step 1 — Configuring the Core Parameters
Begin by setting the General parameters. The Pattern Cooldown determines how many bars must pass before the indicator can display a new pattern, preventing chart clutter from near-simultaneous detections. Symmetry and Level Tolerances control how precisely pattern geometry must conform to ideal proportions — start with the defaults and tighten them if you find the indicator surfacing formations you consider too loose geometrically. The Minimum Pattern Size settings ensure you are only seeing formations of meaningful magnitude relative to current price and volatility.
● Step 2 — Selecting the Patterns to Scan
The Patterns group contains individual toggles for each of the eighteen formation types. Enable all patterns to begin with a full-spectrum scan, then disable specific families if your strategy does not trade them. For example, traders who focus exclusively on continuation setups may wish to disable the reversal pattern families and vice versa.
● Step 3 — Configuring Pivot Sensitivity
The Pivot Lookback Left and Right settings control how many bars on each side of a candidate swing point must confirm it as a local extreme. Longer lookbacks produce fewer, more significant pivots that form the anchor nodes of larger, more mature patterns. Shorter lookbacks are more sensitive and will detect smaller formations. The Max Pivots to Remember setting governs how deep the historical pivot buffer extends — a larger buffer allows the detection of formations that developed over longer periods.
● Step 4 — Setting Breakout Confirmation Criteria
The Filters group provides the breakout confirmation framework. Decide whether your strategy requires a wick break, a candle close, or a full-body break for confirmation. Set the ATR or percentage threshold for the breakout margin. If you require multiple consecutive bars of confirmation before accepting a breakout, set the Confirmation Bars value accordingly. Enable the Volume Spike filter if your strategy demands volume participation at the breakout. Set the Minimum Risk:Reward Ratio to suppress setups that do not meet your expected value criteria before they ever appear on the chart.
● Step 5 — Interpreting Active Patterns
When a pattern is displayed on the chart, the dashed lines to the right of the breakout bar define the full trade plan. The entry line represents the price at which the bar following the confirmation opened — the entry point if trading the breakout. The stop line shows where the indicator places the structural stop, with your configured buffer applied. The target line shows the measured-move objective. The R:R label adjacent to the target line reflects the ratio after slippage and commission deductions, giving you the net expected risk-reward rather than the gross.
● Step 6 — Using the Dashboard for Context
The upper-right dashboard should be reviewed alongside any active pattern. Volume score and pivot density provide complementary context on the structural richness of the current chart state. Bar elapsed since detection tells you how long the setup has been active without resolution. The Risk-Reward score in the dashboard mirrors the chart label but provides a reference without needing to scroll.
● Step 7 — Enabling Pro Intelligence Features
For analysts seeking additional confirmation layers, the Pro feature groups provide the Pattern Quality Score, HTF Bias alignment, and Confluence Count as primary gatekeeping tools. Enable HTF Bias to ensure that the directional implication of a detected pattern aligns with the trend on a higher timeframe. Use Confluence Count as an additional conviction filter — setups where multiple pattern families simultaneously point in the same direction are inherently more structurally supported than single-pattern detections. Use Pattern Quality Score to compare the relative quality of multiple active setups on different instruments or timeframes.
● Step 8 — Configuring Alerts
Enable alerts in the Alerts group to receive notifications when patterns confirm. With Smart Detailed Alerts enabled, each alert message contains the full trade plan: pattern name, bias, entry, stop, target, risk-reward, position size if that feature is active, and confluence count. The Pre-Breakout Alert provides advance warning when price is approaching the entry zone but has not yet confirmed, allowing preparation without requiring constant chart monitoring.
● Step 9 — Managing Multiple Patterns
The Max Patterns Displayed setting governs how many historical confirmed patterns remain visible on the chart simultaneously. A setting of one shows only the most recently confirmed formation, keeping the chart uncluttered. Higher values allow a history of recent setups to remain visible — useful for studying how the indicator performed across recent market structure without switching timeframes.
⚙️ Inputs and Settings
● General
Pattern Cooldown (Bars) — The minimum number of bars that must separate consecutive pattern detections. Prevents multiple near-simultaneous labels from being applied to closely adjacent formations that originate from the same underlying structure. Default: 5.
Symmetry Tolerance (%) — The maximum percentage deviation allowed between the price levels of the symmetric anchor points of a pattern — for example, the two peaks of a Double Top or the two shoulders of a Head and Shoulders. Expressed as a percentage of the average price of the compared points. Default: 10.0%.
Level Tolerance (%) — The maximum percentage deviation between key horizontal levels within a pattern — primarily used for the triple formation families where three highs or three lows must align. Default: 3.0%.
Min Pattern Size (% of Price) — The minimum height of the pattern expressed as a percentage of the current price. Patterns shorter than this threshold are rejected regardless of geometric validity. Default: 0.5%.
Min Pattern Size (ATR Multiplier) — The minimum height of the pattern expressed as a multiple of the current Average True Range. Both this and the percentage threshold must be satisfied simultaneously. Default: 1.0×.
Max Patterns Displayed — The maximum number of concurrently visible historical patterns on the chart. Older confirmed patterns are removed as new ones are added when this limit is reached. Default: 1.
● Patterns
Double Top / Double Bottom — Toggles detection of the two-peak and two-trough reversal formations.
Triple Top / Triple Bottom — Toggles detection of the three-peak and three-trough reversal formations.
Head and Shoulders / Inverted Head and Shoulders — Toggles detection of the classic and inverted head-and-shoulders reversal patterns.
Bullish Flag / Bearish Flag — Toggles detection of parallel-channel continuation patterns following a directional pole.
Bullish Pennant / Bearish Pennant — Toggles detection of converging-trendline continuation patterns following a directional pole.
Rising Wedge / Falling Wedge — Toggles detection of converging wedge formations where both trendlines slope in the same direction.
Triangle — Toggles detection of ascending, descending, and symmetrical triangle formations.
Rectangle — Toggles detection of horizontal consolidation channel formations.
Cup and Handle / Inverted Cup and Handle — Toggles detection of the curved rounding formation with a handle consolidation.
Rounding Bottom / Rounding Top — Toggles detection of gradual curved reversal formations lacking sharp pivot geometry.
● Pivot
Pivot Lookback Left — The number of bars to the left of a candidate swing point that must be lower (for a high) or higher (for a low) to confirm the pivot. Larger values produce fewer, more significant pivots. Default: 10.
Pivot Lookback Right — The number of bars to the right of a candidate swing point that must confirm it. Applies a confirmed-bar delay equal to this value before a pivot is registered. Default: 10.
Max Pivots to Remember — The maximum number of historical pivot highs and lows retained in the rolling buffer. A larger buffer allows detection of patterns formed over extended periods. Default: 500.
● Filters
Require Candle Close Outside? — When enabled, a breakout is only recognized when a candle closes beyond the boundary level, rather than merely penetrating it intrabar. Default: false.
Require Full Body Breakout? — When enabled, both the open and close of the breakout candle must be beyond the boundary — the entire real body must clear the level. Default: false.
Use ATR for Threshold? — Determines whether the breakout margin is expressed as an ATR multiple or a percentage. Default: true (ATR-based).
Breakout Threshold (ATR) — The ATR multiple that price must exceed beyond the boundary to register a breakout. Active when ATR threshold mode is selected. Default: 1.0×.
Breakout Threshold (%) — The percentage of the boundary price level that price must exceed for a breakout. Active when percentage threshold mode is selected. Default: 0.3%.
Confirmation Bars (Consecutive) — The number of consecutive bars that must each independently satisfy the breakout condition before the breakout is accepted. Default: 1.
Show Patterns Without Confirmation — When enabled, the confirmation requirements are suspended and patterns are displayed as pending formations regardless of breakout status. Useful for studying pattern formations before they resolve. Default: false.
Scan Lookback Bars — The minimum number of bars back from the current bar that the breakout scan searches. Default: 1.
Require Volume Spike? — When enabled, the breakout bar's volume must exceed the rolling volume average multiplied by the configured Volume Multiplier. Default: false.
Volume Multiplier — The factor by which current volume must exceed the rolling average to satisfy the volume spike condition. Default: 1.0×.
Volume SMA Length — The lookback length for the rolling volume average used in the volume spike comparison. Default: 20.
Min Risk:Reward Ratio — The minimum adjusted risk-reward ratio that a setup must achieve after slippage and commission deductions. Setups below this threshold are suppressed. Default: 1.0.
Slippage (Ticks) — The estimated slippage in minimum price increments applied to the reward calculation for risk-reward evaluation. Default: 1.0 tick.
Commission (%) — The round-trip commission percentage applied to the reward calculation. Default: 0.0001%.
● Visuals
Fill Transparency — Controls the transparency of the interior fill within pattern boundaries. Higher values produce a more transparent, less visually dominant fill. Default: 80.
Show Measured Targets — Toggles the display of entry, stop, and target dashed lines with labels to the right of the breakout bar. Default: true.
Stop Loss ATR Buffer — An ATR multiple added beyond the structural stop anchor point when ATR-based stop mode is active, providing additional clearance from the invalidation level. Default: 0.5×.
SL as % of Target Dist — When enabled, the stop loss is placed at a percentage of the measured target distance below (bullish) or above (bearish) the entry, rather than at the structural anchor. Default: true.
SL % of Target Dist — The percentage of the measured target distance used to set the proportional stop loss. Default: 25%.
Extend Breakout Lines — When enabled, pattern boundary trendlines are extended infinitely to the right of the breakout bar, rather than terminating at the breakout. Default: false.
● Colors
Bullish Color — The color applied to bullish patterns, their fills, and their associated labels and lines. Default: bright mint green.
Bearish Color — The color applied to bearish patterns and their associated elements. Default: vivid rose-red.
Neutral/Text Color — The color used for neutral labels and secondary text elements. Default: medium violet.
Pending Pattern Color — The color used for patterns displayed in pending (unconfirmed) mode. Default: cyan.
Entry Line Color — The color of the dashed entry price line and its label. Default: amber-yellow.
Stop Line Color — The color of the dashed stop loss line and its label. Default: rose-pink.
Target Line Color — The color of the dashed target line and its label. Default: bright green.
Dashboard Background Color — The background color of the dashboard table cells. Default: near-black.
Dashboard Text Color — The primary text color used throughout the dashboard. Default: light silver-white.
● 💎 Pro — Pattern Intelligence
Pattern Quality Score — Activates the composite Pattern Quality Score metric, which synthesizes volume, risk-reward, and pivot density into a single score displayed in the dashboard. Default: false.
Multi-Pattern Confluence — Enables the simultaneous counting of all active detected patterns across all families, with the total confluence count reported in the dashboard. Default: false.
HTF Bias Filter — Enables the Higher Timeframe Bias filter, suppressing patterns that conflict with the directional bias observed on the configured higher timeframe. Default: false.
HTF Timeframe — The timeframe used for the higher timeframe bias data retrieval. Default: 240-minute.
● 💎 Pro — Dashboard+
Extended Multi-Pattern Dashboard — Expands the dashboard with a Recent Patterns section that logs the five most recently detected patterns and their formation status. Default: false.
Multiple TP Levels (TP1/TP2/TP3) — Replaces the single target line with three individually positioned take-profit lines at user-defined percentages of the measured target distance. Default: false.
TP1 / TP2 / TP3 % of Target Dist — The percentage of the measured target distance at which each of the three take-profit lines is placed. Defaults: 50% / 100% / 150%.
● 💎 Pro — Alerts
Smart Detailed Alerts — When enabled, alert messages include the full trade plan: pattern name, bias, entry, stop, target, adjusted R:R, position size (if active), and confluence count. Default: false.
Pre-Breakout Alert — Triggers an alert when price approaches the entry zone within a configurable ATR distance, providing advance warning before breakout confirmation. Default: false.
Pre-Brk Distance (ATR) — The ATR multiple defining the proximity to the entry zone that triggers the pre-breakout alert. Default: 0.5×.
● 💎 Pro — Trade Tools
Position Sizing Calculator — Enables automatic position size calculation based on account size and risk percentage per trade, with the result displayed in the dashboard. Default: false.
Account Size ($) — The total account equity used as the basis for position size calculations. Default: $10,000.
Risk Per Trade (%) — The percentage of account equity to risk on any single trade, used to size positions relative to the stop distance. Default: 1.0%.
Auto Breakeven Line — Activates the automated breakeven line feature, which renders a visual prompt to move the stop to breakeven when TP1 is reached. Default: false.
Risk Zone Visual — Renders a semi-transparent filled rectangle spanning the entry-to-stop risk zone from the breakout bar forward. Default: false.
Risk Zone Transparency — Controls the transparency of the risk zone fill. Default: 85.
● 💎 Pro — Filters+
Market Structure Filter — When enabled, only patterns consistent with the short-term market structure trend — defined by the relative position of price within the recent high-low range — are displayed. Default: false.
Market Structure Length — The lookback length used to define the current market structure high and low. Default: 20.
Trading Session Filter — Restricts pattern confirmation to occur only during user-specified trading sessions. Default: false.
London / New York / Asia Sessions — Individual toggles selecting which sessions are active when the session filter is engaged.
ATR Percentile Volatility Filter — Restricts pattern confirmation to bars where the ATR percentile rank falls within a specified band, avoiding detection during extreme high or low volatility regimes. Default: false.
Min / Max ATR Percentile — The lower and upper bounds of the ATR percentile band within which detections are permitted. Default: 10th–90th percentile.
ATR Percentile Lookback — The historical bar count used to rank current ATR within its percentile distribution. Default: 100.
● 💎 Pro — Visuals+
Gradient Fill — Applies an additional transparency layer to pattern fills, producing a softer gradient appearance. Default: false.
Pattern Status Icons — Prepends a formation status icon to the pattern name label on the chart. Default: false.
Pattern Heatmap Table — Displays a heatmap quality score within the dashboard, reflecting the density and quality of recent pattern activity. Default: false.
Heatmap Lookback Bars — The bar count window used for the heatmap density analysis. Default: 50.
Pattern Replay Mode — Shifts all detection logic backward by a user-specified number of bars, simulating the indicator's state at a historical point in time. Default: false.
Replay Offset (Bars Back) — The number of bars to offset for replay simulation. Default: 0.
● 💎 Pro — Advanced Intelligence
Neckline Strength Decay — Tracks pre-breakout price touches of the key neckline level and displays a weakening strength score in the dashboard.
Neckline Touch Tolerance (ATR) — The ATR multiple defining the proximity band within which a bar is counted as a neckline touch. Default: 0.15×.
Volume POC Breakout Check — Identifies the approximate volume-weighted center price within the pattern window and flags whether the breakout close occurred above or below it.
Pattern Cleanliness Score — Measures the tightness with which price tracked the pattern's structural trendlines, expressed as a zero-to-one-hundred score.
Cross-Pattern Conflict Warning — Flags when simultaneously detected bullish and bearish patterns indicate market directional indecision.
Time Symmetry Filter — Requires approximate temporal symmetry between the left and right anchor points of symmetric patterns.
Time Symmetry Tolerance (%) — The maximum allowed deviation in bar-count distance between the two sides of a time-symmetric pattern. Default: 35%.
Formation Speed Score — Benchmarks the current pattern's formation length against the historical average for that pattern type, revealing whether formation was faster or slower than typical.
Adaptive Tolerance (Auto-Scale w/ Volatility) — Automatically scales symmetry and level tolerances proportionally with the current ATR percentile rank, maintaining consistent detection sensitivity across volatility regimes.
Liquidity Sweep Confirmation — Requires a wick-based stop-hunt beyond the second swing point, followed by a close back inside the range, before confirming Double Top and Double Bottom patterns.
Pattern Decay Timer — Displays a countdown of bars before an un-triggered pattern is considered stale, based on a multiple of the pattern's average historical formation length.
Decay Timer Multiplier — The multiplier applied to the average formation length to set the decay threshold. Default: 2.0×.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Classical Chart Pattern Theory
The foundational theoretical basis of this indicator is the classical technical analysis literature codified in the early twentieth century, most comprehensively articulated in Robert D. Edwards and John Magee's foundational work on stock price behavior and chart patterns. The formations detected by this indicator — Head and Shoulders, Double and Triple Tops and Bottoms, Flags, Pennants, Wedges, Triangles, and Rectangles — represent the core pattern vocabulary of this tradition, each interpreted as a graphical representation of a specific competitive dynamic between supply and demand. The measured-move principle for price target determination, which projects the pattern height forward from the breakout level, is among the oldest documented price-projection heuristics in the technical literature and remains one of the most empirically cited.
● Pivot Structure and Market Microstructure
The use of confirmed swing highs and lows as anchor nodes is consistent with the structural market analysis frameworks introduced by Charles Dow and later formalized in terms of swing analysis by W. D. Gann. In contemporary market microstructure research, the significance of price pivots as informational nodes — points where the balance of order flow reversed — is reflected in bid-ask bounce literature and in the empirical documentation of support and resistance behavior at historical swing points. Ralph Nelson Elliott's wave principle, while not explicitly replicated in this indicator's detection logic, informs the broader theoretical context for why repeating structural sequences appear in price series with statistical frequency.
● Breakout Dynamics and Confirmation Theory
The breakout confirmation framework reflects a body of academic and practitioner research on the reliability differential between confirmed and unconfirmed breakouts. Work by economists including Brock, Lakonishok, and LeBaron examining the statistical properties of technical trading rules documented that breakout signals, particularly those from pattern completions, exhibit statistically significant predictive content when evaluated with appropriate confirmation criteria. The volume confirmation requirement references Granville's foundational work on volume as a leading indicator of price commitment — a principle subsequently examined in academic settings by Blume, Easley, and O'Hara's work on the informational content of trading volume.
● Risk-Reward Framework and Post-Modern Portfolio Theory
The indicator's emphasis on pre-trade risk-reward evaluation reflects the Post-Modern Portfolio Theory (PMPT) framework developed by Fishburn, Sortino, and Price, which characterizes risk as downside deviation from a threshold return rather than symmetric variance. The risk-reward ratio with explicit slippage and commission adjustment reflects the trade-level expected value analysis that forms the basis of Kelly Criterion position sizing theory — the work of John L. Kelly Jr. at Bell Labs subsequently extended to trading applications by Ed Thorp and others. The position sizing calculator within the Pro feature set implements a fixed-fractional risk model consistent with the risk-of-ruin optimization principles described in Ralph Vince's work on optimal f and portfolio management for traders.
● Volume-Weighted Price Level Analysis and the Point of Control
The Volume POC Breakout Check is conceptually grounded in Market Profile theory, originally developed by J. Peter Steidlmayer in collaboration with the Chicago Board of Trade in the 1980s and subsequently extended by James Dalton and others. Market Profile theory posits that the price level attracting the greatest cumulative volume within a defined time window represents the fair value area where the greatest consensus between buyers and sellers existed — the Point of Control. The indicator's approximate POC estimation within the pattern formation window applies this principle at the level of individual formations, providing a volume-informed view of whether the breakout is clearing the contested center of the formation's price distribution.
● Volatility Normalization and Adaptive Signal Filters
The ATR Percentile Volatility Filter and the Adaptive Tolerance feature both reflect the academic recognition that technical signal parameters calibrated to a fixed volatility regime produce non-stationary results when market volatility shifts. Merton's option pricing extensions and subsequent work on realized volatility by Andersen, Bollerslev, Diebold, and Labys demonstrated that volatility is itself a stochastic and persistent process. Regime-adaptive signal filtering — adjusting sensitivity to current volatility rather than applying fixed thresholds — reflects the practitioner response to this theoretical insight, documented across a range of quantitative trading research.
● Higher Timeframe Confirmation and Multi-Timeframe Confluence
The HTF Bias Filter reflects the principle of multi-timeframe confirmation, a concept with deep roots in Dow Theory's distinction between primary, secondary, and minor trends. Contemporary empirical work in technical analysis research — including studies published in the Journal of Technical Analysis — has documented that short-timeframe trading signals aligned with the directional bias of higher timeframes exhibit improved win rates relative to counter-trend signals. The Multi-Pattern Confluence feature similarly reflects the principle of confirmation through independent evidence: the simultaneous convergence of multiple independent analytical signals reduces the probability that any single detection is a false positive.
● Time Symmetry and Pattern Morphology
The Time Symmetry Filter draws on pattern morphology research suggesting that geometrically balanced formations — those exhibiting approximate equivalence in the time dimension as well as the price dimension — exhibit more stable post-breakout characteristics than asymmetric formations. This principle is related to the broader concept of fractality in price series first mathematically explored by Benoit Mandelbrot in the context of financial markets, and subsequently applied to trading by practitioners including Bryce Gilmore and Larry Pesavento, who documented harmonic proportionality in time as a complement to harmonic proportionality in price.
● Liquidity Dynamics and Stop-Hunting Behavior
The Liquidity Sweep Confirmation feature reflects the contemporary understanding of liquidity dynamics in electronic order-driven markets. Research by economists including Albert Kyle and subsequent market microstructure work on order flow imbalances has documented that price frequently overshoots key levels before reversing — a behavior that reflects the harvesting of stop-loss orders clustered beyond visible swing points. The liquidity sweep pre-condition for Double Top and Bottom confirmation operationalizes this insight: requiring evidence that the market has already hunted the stops beyond the second swing before confirming the reversal increases the probability that the subsequent move is driven by genuine directional order flow rather than residual speculative interest.
⚠️ Disclaimer
This indicator is provided for educational and informational purposes only. Nothing contained in this tool or its associated materials constitutes financial, investment, legal, or tax advice, and no information presented should be construed as a recommendation to buy, sell, or hold any financial instrument or to engage in any specific trading or investment strategy. Past performance of any pattern, signal, or methodology illustrated by this indicator is not indicative of future results. All trading involves risk. Markets can and do move against technical patterns, and no indicator or analytical system can guarantee profitable outcomes. Users are solely responsible for all trading decisions and outcomes. We expressly disclaim all liability for any direct, indirect, incidental, special, or consequential losses or damages arising from the use of, or reliance upon, this indicator or any information derived from it. Before trading any financial instrument, users should seek independent financial advice appropriate to their individual circumstances.
Fibonacci Extension & Volume Profile [MarkitTick] 💡 Most traders draw Fibonacci extensions by hand. They pick a swing low, drag to a swing high, anchor the retracement, and hope the three points they selected are the three points the market actually respects. The result is inconsistent by construction: two traders looking at the same chart produce two different projections, and the same trader looking at the same chart on two different days produces two more. Fibonacci Extension & Volume Profile removes the hand from the process entirely. It identifies the swing structure objectively, projects the extension ladder from that structure automatically, and then — critically — overlays a volume profile anchored to the exact origin of that same structure, so every projected target can be read against the real distribution of traded activity that produced it.
The premise is simple and it is the reason this tool exists. A Fibonacci level is a geometric abstraction. It tells you where price would sit if the current leg mirrors the proportion of the prior leg. It says nothing about whether anyone traded there, whether that region is thick with prior participation or hollow, or whether the path between here and there is smooth or obstructed. A volume profile answers exactly those questions and answers nothing about proportion or projection. Each tool is blind precisely where the other sees. Fused and anchored to a common origin, they produce something neither delivers alone: a projected target ladder with a participation map layered directly behind it, so a trader can distinguish a 1.618 extension that lands inside a dense high-participation shelf from one that lands in a hollow void where price has historically travelled fast and unopposed.
Everything in the tool follows from that fusion. Swing structure is detected on a filtered basis so that noise does not generate phantom projections. The extension ladder is drawn from the confirmed structure with wave-context annotations for traders who work within an Elliott framework. The volume profile re-anchors itself to the origin of each new structure, so the participation map always describes the leg currently being traded rather than an arbitrary lookback window. Consolidation shelves, low-participation voids, the point of control, and the value area boundaries are surfaced and labelled. A trade-planning layer marks the structural entry and invalidation reference. A compact dashboard consolidates bias, levels, risk-to-reward, and profile statistics into a single readable panel. An alert layer packages the whole picture into structured messages suitable for automation. The tool is built for traders who want the discipline of a mechanical framework without surrendering the contextual judgement that separates a target from a tradeable target.
✨ Originality and Utility
● The Shared-Anchor Principle
The defining architectural decision in this tool is that the Fibonacci structure and the volume profile share a single anchor point. When a new swing structure is confirmed, the origin of that structure becomes the left edge of the volume profile. The profile window is not a fixed bar count, not a session, not a visible-range approximation. It is exactly the span of the move being projected.
This matters more than it may first appear. A conventional volume profile with a fixed lookback aggregates activity from regimes that have nothing to do with the current leg — a prior trend, a prior consolidation, a prior distribution that has already been resolved and left behind. The resulting point of control describes a composite market that no longer exists. By re-anchoring to the structural origin, the profile describes only the participation that built the current move. Its point of control is the fair-value reference of this leg. Its value area boundaries are the acceptance boundaries of this leg. Its voids are the regions this leg travelled through without resistance.
The consequence is that every extension target can be read against a participation map of matching scope. A projected level sitting inside the current leg's value area is a level surrounded by accepted price. A projected level sitting beyond a low-participation void is a level with an unobstructed runway in front of it. That distinction is not available from either component in isolation, and it is not available from a volume profile whose window was chosen arbitrarily.
● Objective Structure Instead of Discretionary Anchoring
The three-point structure that drives every projection is identified by the tool, not by the user's cursor. Swing extremes are confirmed only after sufficient bars have formed on both sides, and candidate swings are filtered so that minor oscillation inside a larger move does not register as structure.
The filter is adaptive by default: swing significance is judged relative to prevailing volatility rather than a fixed percentage, so the same configuration behaves sensibly on a low-volatility index and on a high-volatility digital asset. Traders who prefer a fixed proportional threshold can switch to one. Traders working on assets whose price has changed by an order of magnitude over the chart's history can switch the projection geometry to a logarithmic basis, so proportional relationships remain consistent across the full range rather than being distorted by absolute scale.
The result is reproducibility. Two traders with the same settings see the same structure. The same trader tomorrow sees the same structure. Backtest observations and live observations refer to the same object. This is the single largest practical difference between a mechanical Fibonacci framework and a hand-drawn one, and it is a precondition for any systematic use of extension levels.
● A Structural Filter, Not a Pattern Catalogue
The tool does not attempt to enumerate every possible swing configuration. It recognises one: an impulse leg followed by a partial retracement that holds inside the impulse. A bullish structure requires a low, a subsequent high, and a retracement low that sits above the original low. A bearish structure is the mirror. Anything else is discarded.
That restriction is deliberate. The retracement-holds condition is what distinguishes a continuation setup from a reversal. If the retracement violates the origin, the impulse is no longer intact and projecting an extension from it is meaningless. By enforcing the condition structurally rather than leaving it to the user's discretion, the tool refuses to draw projections from broken structure — which is where the majority of hand-drawn Fibonacci disappointment originates.
● Consolidation and Void Classification
Beyond the standard profile rendering, the tool partitions the profile into contiguous participation bands and classifies each one by its relationship to the point of control and the value area. Bands containing the point of control are marked as such. Bands inside the value area but away from the point of control are marked as high-participation shelves. Bands that carry meaningful activity yet sit outside the value area entirely are marked as imbalance regions — areas where trade occurred but acceptance never formed.
Separately, the tool identifies the low-participation extremities of the profile: the thin regions above the last substantial band and below the first substantial band. These are labelled as directional excess. They represent the edges of the auction where price probed and was rejected, and they are the regions most likely to be traversed quickly if revisited.
This classification converts a profile from a shape into a set of named, actionable zones. A trader does not have to interpret the histogram silhouette; the tool states which bands are acceptance, which are imbalance, and which are excess.
● Integration Rather Than Coexistence
Many tools place two studies on one chart. This one makes them dependent. The profile's anchor is derived from the structure. The dashboard reads from both. The trade-planning layer takes its entry and invalidation references from the structure while the profile statistics that appear beside them describe the same span. The alert payloads carry the structural levels. Nothing is bolted on; each component consumes output from another.
The practical value of that integration is workflow compression. A trader evaluating a setup normally opens a Fibonacci tool, anchors it, opens a volume profile, sets its range to approximately match, reads the point of control, compares it to the projected levels, notes the risk distance, and computes the reward ratio. This tool performs that sequence on every confirmed structure and presents the result as a single readable state.
🔬 Methodology and Concepts
● Swing Structure Detection
Pivot Confirmation — A swing extreme is recognised only once a defined number of bars has formed on either side of the candidate without exceeding it. This is what makes the structure stable rather than provisional: a level that qualifies as a swing high does so because the market has already demonstrated, over a specified window, that it could not push above it. The depth of that window is user-controlled and represents a direct trade-off between responsiveness and reliability.
Adaptive Significance Filtering — Not every confirmed pivot deserves to become structure. A swing is admitted only if it is separated from the preceding swing by a distance the tool judges significant. In adaptive mode, significance is scaled to prevailing volatility, which means the same setting produces comparable structural granularity across instruments with radically different typical ranges. In fixed mode, significance is a proportional distance the trader specifies directly.
Pivot Tolerance — Real markets produce double tops, equal highs, and near-equal extremes. A strict definition of a pivot rejects these, because a neighbouring bar matching the candidate technically invalidates it. The tolerance setting allows neighbouring bars to sit at or fractionally beyond the candidate without disqualifying it, so structurally meaningful equal-extreme formations are captured rather than discarded.
Structural Validation — Once three alternating swings are available, the tool tests whether they form a valid impulse-and-retracement sequence in a single direction, with the retracement holding inside the impulse. Only sequences passing that test become active structure. Sequences that fail are silently ignored — no projection is drawn, no signal is generated.
Structural Housekeeping — When a developing swing extends and its extreme relocates, the tool recognises that the previously drawn structure is stale and removes it rather than accumulating overlapping projections from the same three-point sequence at different price levels. Only structures the trader has asked to retain remain on the chart.
● The Extension Ladder
Each level is a proportional projection of the impulse leg, measured forward from the retracement point. What each ratio represents interpretively:
0.618 — A shallow projection. Reached easily in most continuations, and for that reason more useful as a first sign of follow-through than as a target. In wave-counting terms this magnitude is often associated with terminal legs that lack the force of an earlier impulse. A move that stalls here suggests the continuation lacks conviction.
1.000 — Equality. The current leg travels the same distance as the impulse that preceded it. This is the most common resolution for corrective structures and the most common first pause for developing impulses. Reaching equality confirms the leg has matched its predecessor; failing to reach it indicates the structure is weakening relative to what came before.
1.272 — A harmonic proportion widely watched as a reversal zone in pattern-based frameworks. Its practical significance is that it sits beyond equality but short of the golden proportion, making it a natural region for partial profit-taking and for the first meaningful test of whether a move will extend or retrace.
1.500 — The midpoint proportion. Less rooted in the Fibonacci series than in round-number psychology, and valuable precisely because of that: it frequently attracts resting orders from participants who work in halves rather than in ratios. Together with the golden proportion it forms the upper target band.
1.618 — The golden proportion, and the primary extension target in both classical Fibonacci practice and wave-based frameworks. A move that reaches it has demonstrated a full-magnitude impulse. Reaching it and continuing suggests an extended structure; reaching it and reversing is the textbook outcome.
Custom Ratio — Any user-specified proportion. Traders who work with deeper projections for extended structures, or with proportions specific to a particular instrument's observed behaviour, can add one and have it rendered with distinct emphasis alongside the standard ladder.
Logarithmic Projection — On assets whose price has multiplied over the chart's history, a projection based on absolute distance understates targets at low prices and overstates them at high ones. The logarithmic option expresses the proportional relationship in ratio space instead, so a projected level represents the same proportional move regardless of where on the price scale the structure sits. Recommended for long-horizon charts and for instruments with wide historical range.
The Target Band — The region between the midpoint proportion and the golden proportion is shaded and labelled as a distinct zone rather than being left as two separate lines. Traders working with staged exits treat this band, not a single line, as the region in which a completed impulse most often resolves.
Wave Context Annotations — Each level can carry an interpretive label placing it within an Elliott-style reading. These annotations are conventions from wave literature associating particular extension magnitudes with particular wave positions. They are contextual reading aids, not forecasts, and the tool makes no claim that a labelled level will be reached or that the associated wave count is correct.
● Volume Profile Construction
Granular Data Sourcing — The profile is built from activity observed at a finer resolution than the chart's own, so that a single chart bar contributes a distribution of activity across the price range it spanned rather than a single lump at one price. The tool can select an appropriate finer resolution automatically based on the span being profiled, or use a resolution the trader specifies. Automatic selection scales the resolution to the profile's duration, keeping detail high on short structures and manageable on long ones.
Row Resolution — The number of horizontal bands into which the profile's price range is divided. More bands reveal finer structure — individual shelves, narrow gaps, precise acceptance boundaries — at the cost of visual density and greater sensitivity to noise. Fewer bands produce a smoother, more interpretable silhouette that emphasises major structure over detail.
Optional Profile Smoothing — At high row counts, a profile can fragment into a comb of alternating full and empty bands that reflects sampling artefacts rather than market structure. Smoothing blends each band with its neighbours across a user-defined radius, suppressing single-band noise while preserving the overall shape. It is disabled by default so that existing configurations are unaffected until a trader chooses to enable it.
● Profile Reference Levels
Point of Control — The price band that attracted the greatest participation across the structure's span. This is the leg's fair-value reference: the price at which the largest volume of trade found mutual agreement. Price tends to gravitate toward it during balance and away from it during imbalance. Its position relative to current price is a first-order read on whether the market is trading above or below the value it established while building this leg.
Value Area — The contiguous price region containing a user-specified majority of the structure's participation, expanded outward from the point of control. Its boundaries define where the market has accepted price. Trade inside the value area is balance; trade outside it is imbalance seeking either acceptance or rejection.
Value Area High and Low — The upper and lower boundaries of that region. These are the two most actionable profile levels in practice, because they mark the transition between accepted and unaccepted price. A break beyond a boundary that holds signals acceptance at a new level; a break that fails signals rejection and a likely return toward the point of control.
Total Participation — The aggregate activity across the structure's span, used as the denominator for the percentage figures shown throughout the profile. It also serves as a rough measure of how heavily contested the structural leg was.
● Zone Classification
Point-of-Control Band — The contiguous participation band containing the fair-value reference. Marked distinctly because it carries the strongest gravitational pull in the profile and is the most likely region for price to return to during rotation.
High-Participation Shelf — A substantial band lying inside the value area but away from the point of control. These are secondary acceptance zones: regions where meaningful trade occurred and agreement formed. They frequently act as support on decline and resistance on advance, and they are natural staging areas for continuation.
Imbalance Region — A band carrying real participation that nonetheless sits outside the value area. Trade happened here, but acceptance did not form. These regions are unresolved: the market transacted without agreeing, which leaves the area vulnerable to being revisited and either accepted or rejected decisively. Imbalance zones outside the value area are among the more informative features the profile surfaces, and the tool can be configured to display them exclusively when a trader wants only unresolved structure on the chart.
Upper Excess — The thin region above the profile's last substantial band. Represents an upward probe that failed to attract participation — a rejected high. Marks the auction's upper boundary and typically functions as resistance.
Lower Excess — The thin region below the profile's first substantial band. Represents a downward probe that failed to attract participation — a rejected low. Marks the auction's lower boundary and typically functions as support.
The interpretive value of excess regions is that they identify where the market went and immediately left. Because so little trade occurred there, there is little resting inventory to slow a return visit. Price tends to move through excess quickly in either direction.
● Trade Planning References
Structural Entry Reference — The impulse extreme. A continuation thesis is predicated on price advancing beyond the level that terminated the impulse, which makes that level the natural structural trigger reference.
Structural Invalidation Reference — The retracement extreme. If price violates the point from which the continuation was expected to develop, the structure that generated the projection no longer holds. This is the level whose violation falsifies the setup.
Risk-to-Reward Ratio — The relationship between the distance from entry reference to invalidation reference and the distance from entry reference to the furthest projected target. Presented as a visual gauge so the geometric quality of a setup is legible at a glance. A structure with a tight retracement and a distant projection reads high; a structure with a deep retracement and a near projection reads low. This is a geometric measure only and carries no probability content — it describes the shape of the opportunity, not its likelihood.
● Structure Locking
An active structure can be frozen. When locked, the current three-point structure and all of its associated projections, labels, and trade references remain fixed regardless of subsequent price action, and no new structure is detected. The volume profile continues updating normally, so the participation map develops in real time against a static projection frame.
This exists for a specific workflow: once a trader has committed to a setup, they do not want the projection frame relocating underneath them because a new swing qualified. Locking preserves the analytical frame of the decision while allowing the participation evidence to keep accumulating.
🎨 Visual Guide
● Structure Rendering
The impulse leg is drawn as a solid line; the retracement leg as a dashed line. The visual distinction is functional: solid indicates the move being projected, dashed indicates the correction being projected from. Both take the directional colour of the structure — green for bullish, red for bearish by default.
The three structural points carry labels. Their placement flips with direction so labels sit outside the structure rather than over it: on a bullish structure the extremes are labelled below the lows and above the high, and the reverse on a bearish structure.
● Extension Levels
Each enabled ratio renders as a horizontal line beginning at the retracement point and projecting rightward. Line treatment encodes hierarchy: the golden proportion and any custom ratio are drawn solid, while intermediate ratios are drawn dotted. Opacity reinforces the same hierarchy — the golden proportion is fully opaque, equality and the harmonic proportion slightly softened, the midpoint proportion softer still, and shallow projections faintest. The visual weight of a level corresponds to its analytical weight, so the eye is drawn to the primary target without the trader having to read anything.
Each line terminates in a label showing its target sequence number, its wave context annotation where enabled, and the projected price. Labels are colour-matched to their lines. With right-extension enabled, lines and labels track forward as bars form, keeping the ladder anchored to the chart's right edge.
● The Target Band
The region between the midpoint and golden proportions is filled with a translucent wash in the structure's directional colour and annotated with a centred zone label. This is the tool's primary visual emphasis: it directs attention to a band rather than a line, which is the more realistic way to treat a projected reversal region.
● Volume Profile Histogram
The profile renders as horizontal bars extending rightward from the structural origin, each bar's length proportional to the participation in its price band and scaled so the heaviest band reaches the configured profile width. Bar colour follows a gradient from near-transparent for the lightest bands to substantially more opaque for the heaviest, so participation density is legible from colour alone. The point-of-control band is rendered in a distinct emphasis colour and carries its own centred label.
A translucent backdrop spans the full profile range, delineating the structure's price envelope from surrounding chart space. With value display enabled, each band carries a text annotation showing either its percentage share of total participation or its absolute figure.
● Zone Boxes and Labels
Each classified band renders as a bordered box spanning the profile's time range. Colour and border treatment differ by classification: acceptance bands take the profile's purple-toned scheme, imbalance bands take a distinct pink-toned scheme that makes unresolved regions immediately separable from accepted ones.
Every zone carries two annotations. A centred label shows the zone's participation share. A left-edge tag names its classification — the point-of-control marker, the high-participation shelf marker, or the imbalance marker. The tags are deliberately terse so a chart with many zones remains readable.
Excess regions render as filled boxes without borders, in red at the profile's upper extremity and green at the lower, each tagged with a directional excess marker and its participation figure. The colour convention aligns with function: red above where supply rejected the probe, green below where demand did.
● Value Area Rendering
With value area lines enabled, the accepted region is outlined as a bordered box in a light lavender tone spanning the profile's range, with boundary and midpoint tags placed to the left of the profile. Boundary line style is user-selectable. The visual intent is a clearly bounded envelope rather than two isolated lines, so the trader reads acceptance as a region.
● Right Extension
Zone boxes can be projected beyond the profile's right edge, continuing each band's price range forward toward the current bar. This converts the profile from a historical description into a forward-looking level map: each extended band becomes a visible price corridor that current price is either inside, above, or below.
● Display Modes
Two reduction modes exist for traders who find the full rendering dense. Groups-and-gaps mode suppresses the histogram bars entirely and renders only the classified zones with dashed midlines, producing a clean level map. Imbalance-only mode retains the histogram but restricts zone boxes to unresolved imbalance regions, hiding acceptance zones. The two can be combined.
● Trade Level Lines
The structural entry reference renders as a dashed blue line; the invalidation reference as a solid red line of greater width. Each terminates in a labelled tag showing its role and price. The weight difference is intentional — the invalidation level is the one that matters most and reads heaviest.
● Dashboard
A compact panel, positionable in any of five chart locations, consolidates the current state:
Header — Tool identifier alongside the active symbol and timeframe.
Bias — Current structural direction, colour-coded green for bullish and red for bearish, or a neutral dash before any structure has formed.
Entry Reference — The impulse extreme price.
Stop Reference — The retracement extreme price, rendered in the bearish colour to reinforce its role as the risk boundary.
Target Pair — The nearest and furthest projected targets, rendered in the bullish colour.
Risk-to-Reward Gauge — A ten-segment filled bar with an accompanying percentage, colour-graded from red through amber to teal as the ratio improves. Reads at a glance without requiring the trader to compare two prices.
Point of Control — The current fair-value reference from the anchored profile.
Value Area Boundaries — The upper and lower acceptance limits as a paired reading.
Total Participation — Aggregate activity across the profiled span.
Alternating row shading separates lines without borders. Every colour in the panel is user-configurable.
📖 How to Use
● Initial Configuration
Begin with pivot depth. This is the single most consequential setting, because it determines what counts as structure. Lower values produce more frequent, smaller structures suited to intraday work; higher values produce fewer, larger structures suited to swing and position horizons. Set it so the detected structures correspond to the swings you would have drawn yourself.
Leave adaptive threshold filtering enabled unless you have a specific reason to prefer a fixed proportional distance. Adaptive filtering scales structural granularity to the instrument's own volatility, which is what allows a single configuration to travel across markets. If detected structures are too numerous, raise the multiplier; if meaningful swings are being missed, lower it.
Enable logarithmic projection if the chart spans a wide price range — long-horizon charts, or instruments whose price has multiplied. On a chart covering a modest range the difference is negligible; on one covering an order of magnitude it is substantial.
Set pivot tolerance above zero if the instrument commonly forms equal or near-equal extremes and you want those captured as structure. Leave it at zero for strict pivot definition.
● Configuring the Ladder
Enable only the ratios you actually use. A ladder with every level enabled is visually crowded and dilutes the emphasis hierarchy that makes the golden proportion stand out. A common configuration retains equality, the harmonic proportion, the midpoint, and the golden proportion — sufficient for staged exits without clutter. Add the shallow projection only if you use it as an early follow-through check. Add a custom ratio if you work with deeper projections for extended structures.
● Configuring the Profile
Start with the default row resolution and adjust based on what you need to see. If you are working with precise acceptance boundaries and narrow shelves, raise it and consider enabling smoothing to suppress the resulting noise. If you want major structure only, lower it.
Set the value area percentage to match your framework. The conventional figure emphasises the core of accepted trade; higher figures include more of the distribution's tails and produce wider acceptance boundaries.
Leave automatic resolution selection enabled unless you have a specific finer resolution in mind. Automatic selection scales detail to the profiled span, which is generally what you want as structures vary in duration.
● Reading a Setup
Work through the following sequence when a new structure appears.
First, confirm the direction. Read bias from the dashboard and confirm it matches your higher-timeframe view. A bullish structure in a broader downtrend is a counter-trend setup and should be treated as such regardless of how clean its geometry looks.
Second, assess the geometry. Read the risk-to-reward gauge. A high reading indicates a shallow retracement with distant targets — geometrically attractive, though shallow retracements sometimes indicate the correction is incomplete. A low reading indicates a deep retracement, which offers a tighter invalidation reference but leaves less distance to the projected targets.
Third, locate current price within the profile. This is the step that separates this tool from a Fibonacci overlay. Compare current price to the value area boundaries and the point of control. Price inside the value area indicates balance and a lower probability of immediate directional resolution. Price outside it indicates imbalance and an active auction seeking either acceptance or rejection at the new level.
Fourth, assess the path. Look at what sits between current price and each projected target. A target with an excess region or a low-participation void in front of it has an unobstructed runway — little resting inventory to slow the move. A target with one or more high-participation shelves in front of it faces resistance at each shelf. This directly informs which target is realistic on the current leg and which requires an extended move.
Fifth, look for confluence. The highest-quality reads occur where a projected extension level coincides with a profile feature: a target landing on a value area boundary, on an imbalance region, or at the edge of an excess zone. Geometric projection and participation evidence pointing at the same price is materially stronger than either alone. This confluence check is the tool's primary intended use.
Sixth, define your risk before entry. The invalidation reference is the structural risk boundary. Position sizing should follow from the distance between entry and invalidation, not from the appeal of the target.
● Workflow Patterns
Continuation Trading — Wait for a structure whose bias matches your higher-timeframe direction, whose retracement holds inside the impulse, and whose target ladder has clear space in front of it. Trigger on advance beyond the entry reference, invalidate on violation of the invalidation reference, and scale out across the target band.
Target Selection — Rather than choosing a target by ratio preference, choose it by profile context. Take partial profit at the first target with a substantial shelf in front of it, and hold the remainder for targets beyond. This converts an arbitrary exit rule into a structurally justified one.
Balance and Imbalance Reading — Use the value area boundaries as your regime read. While price is inside, treat the environment as rotational and favour mean-reversion toward the point of control. When price breaks outside and holds, treat the environment as directional and favour continuation toward the extension ladder. When price breaks outside and immediately returns, treat the break as rejection.
Level Mapping — Enable groups-and-gaps mode with right extension. This produces a clean forward-projected map of every classified band with the histogram suppressed. Useful as a standing reference on a chart where other analysis is being conducted.
Unresolved Structure Focus — Enable imbalance-only mode to strip acceptance zones and display only regions where trade occurred without agreement. These are the areas most likely to produce decisive reaction on a revisit.
Committed Setup Monitoring — Once you have entered on a structure, lock it. The projection frame and trade references freeze while the volume profile continues developing, so you monitor whether participation is accumulating in support of your thesis without the analytical frame shifting underneath you.
● Alert Configuration
The tool emits structured messages on confirmed bar closes for new structural signals in either direction, corresponding position-closure messages for the opposing direction, and separate notifications as each of the three primary targets is reached. Directional signals fire only on confirmed closes, which prevents intrabar fluctuation from generating messages that later prove invalid.
Message payloads are formatted for programmatic consumption and carry the action identifier, symbol, timeframe, direction, and the relevant price references. The action identifiers are user-editable, so the messages can be matched to whatever vocabulary a receiving system expects. Simplified plain-text alert conditions are also available for traders who want notification without automation.
● Practical Cautions
Structure is confirmed retrospectively. A swing is recognised only after the required bars have formed beyond it, which means the structural point is always established a number of bars after the extreme itself occurred. This is inherent to any confirmed-pivot approach and is the cost of stability. Reducing pivot depth reduces the lag and reduces reliability in equal measure.
Projected levels are proportional projections, not forecasts. They identify where price would sit under a specific geometric relationship. Whether price reaches them is determined by the market, not the geometry.
The profile describes the past. It maps where participation occurred during the structural leg. It does not indicate where participation will occur next. Its value is in identifying which price regions carry unresolved inventory and which do not.
Wave annotations are interpretive conventions from wave-counting literature. They are reading aids for traders who work within that framework and carry no predictive claim.
⚙️ Inputs and Settings
● ⚙️ Core
Pivot Depth — Number of bars examined on each side of a candidate swing extreme before it is confirmed. The primary control over structural granularity. Lower values detect smaller, more frequent swings with faster confirmation; higher values detect larger, less frequent swings with greater stability.
Use ATR Threshold — When enabled, swing significance is judged against prevailing volatility rather than a fixed proportional distance, allowing a single configuration to behave consistently across instruments with different typical ranges. Disable to use a fixed proportional threshold instead.
Fixed Dev % — The minimum proportional move required to confirm a new swing when adaptive thresholding is disabled. Higher values admit only larger structural swings.
ATR Period — The lookback used to establish the prevailing volatility reference for adaptive thresholding. Shorter periods respond faster to volatility changes; longer periods produce more stable structural filtering.
ATR Mult — Scales the volatility reference into a significance threshold. Raise to admit only larger swings; lower to admit smaller ones.
Log Scale — Projects extension levels in proportional rather than absolute terms. Recommended for long-horizon charts and instruments spanning a wide price range.
Pivot Tolerance (ticks) — Permits neighbouring bars to sit at or fractionally beyond a pivot candidate without invalidating it, so equal-high and equal-low formations register as structure. Zero enforces strict pivot definition.
🔒 Lock Current ABC — Freezes the active structure with all of its projections, labels, and trade references. No new structure is detected while enabled. The volume profile continues updating normally.
● 📐 Fib Levels
Show 0.618 — Renders the shallow projection. Useful as an early follow-through check; associated with terminal legs in wave frameworks.
Show 1.000 — Renders the equality projection, where the current leg matches the magnitude of the impulse. The most common resolution for corrective structures.
Show 1.272 — Renders the harmonic projection, widely watched as a reversal zone in pattern-based frameworks and a natural partial-exit region.
Show 1.500 — Renders the midpoint projection. Forms the lower boundary of the emphasised target band.
Show 1.618 — Renders the golden proportion, the primary extension target. Drawn with the greatest visual weight.
Custom Ratio — Adds a user-specified proportion to the ladder, rendered with distinct emphasis. Set to zero to disable.
Extend Right — Projects extension lines and their labels toward the chart's right edge, tracking forward as bars form.
● 📈 Volume Profile Settings
👁️ Show Volume Profile — Master toggle for the entire profile layer. Disable to use the tool as a pure structural Fibonacci framework.
⚙️ Use Custom Timeframe — When enabled, the profile draws its granular activity from a resolution you specify. When disabled, the tool selects an appropriate resolution based on the span being profiled.
⏱️ Custom Timeframe — The finer resolution used for profile construction when custom selection is enabled. Finer resolutions produce more precise distributions across each bar's range.
🔢 Row Size — Number of horizontal bands into which the profile's price range is divided. Higher values reveal finer structure at the cost of density and noise sensitivity.
📏 Profile Width (%) — Horizontal extent of the histogram as a proportion of the profiled span. Controls how much chart width the profile occupies.
🔤 Show Text & Labels — Toggles all numeric annotations and classification tags across the profile. Disable for a purely graphical profile.
💯 Show % Values — Displays participation figures as percentages of total rather than absolute values. Percentages are generally easier to compare across bands.
📦 Show Slot Groups (Consolidation Zones) — Enables the contiguous band grouping and classification layer that produces the point-of-control, shelf, and imbalance zones.
🟧 Show Only IMB/EXL/EXH — Restricts zone boxes to unresolved imbalance regions, hiding point-of-control and shelf zones. Excess boxes are unaffected. Requires slot groups enabled.
👁️ Show Only Groups & Gaps — Suppresses the histogram bars and renders only classified zones with dashed midlines, producing a clean level map.
📏 Extend Group Zones to Right — Projects each classified zone forward to the chart's right edge as a price corridor. Requires slot groups enabled.
Value Area (%) — The proportion of total participation the value area encloses, expanded outward from the point of control. Higher values produce wider acceptance boundaries.
📐 Show Value Area Lines (VAH/VAL) — Renders the acceptance envelope as a bordered region with boundary and midpoint tags.
Value Area Line Style — Boundary line treatment: solid, dashed, or dotted.
🌊 Smooth Profile (Gaussian) — Blends each band with its neighbours to suppress single-band noise at high row counts. Disabled by default.
Radius — The neighbourhood width used when smoothing. Larger radii produce smoother profiles with less preserved detail.
● 📐 Trade Tools
Show Entry & SL Lines — Draws the structural entry and invalidation reference lines with labelled tags on each new structure. Projected targets remain available in the ladder and in alert payloads.
● 🎨 Visuals
Keep Last N Structures — Maximum number of structures retained on the chart simultaneously. One keeps the display clean and focused on the active setup; higher values allow review of how prior structures resolved.
Show A-B-C Labels — Toggles the labels marking the three structural points.
Show Structure Lines — Toggles the connecting lines for the impulse and retracement legs.
Show Elliott Labels — Adds wave-context annotations to extension level labels. Interpretive reading aids from wave literature, not forecasts.
● 📊 Dashboard
Show Dashboard — Toggles the consolidated state panel.
Position — Panel placement: top right, top left, bottom right, bottom left, or middle right.
● 🔔 Alerts
↑ Long Action — Action identifier carried in bullish structural signal payloads. Editable to match a receiving system's expected vocabulary.
↓ Short Action — Action identifier carried in bearish structural signal payloads.
✕ Close Long Action — Action identifier carried in the long-closure payload emitted alongside a bearish signal.
✕ Close Short Action — Action identifier carried in the short-closure payload emitted alongside a bullish signal.
● 🌈 Colors
Bull — Colour applied to bullish structures, their lines, labels, and extension levels.
Bear — Colour applied to bearish structures and their associated elements.
Custom Ratio — Colour applied to the user-defined extension level, distinguishing it from the standard ladder.
Label BG — Background colour for structural point labels.
Zone Label BG — Background colour for the target band annotation.
Box Color — Base colour for the profile histogram and acceptance zone rendering. Opacity variations are generated from this base to encode participation density.
POC Line Color — Colour applied to the point-of-control band emphasis.
Text Color — Colour for profile numeric annotations.
Imbalance Zone Color — Colour scheme for unresolved imbalance regions, deliberately distinct from the acceptance scheme.
Value Area Line Color (VAH/VAL) — Colour for the acceptance envelope boundaries and tags.
Supply Gap Color — Fill colour for upper excess regions.
Demand Gap Color — Fill colour for lower excess regions.
Box Background Color — Background colour for centred participation labels throughout the profile.
Gaps: Resistance Text Color — Text colour for upper excess annotations.
Gaps: Support Text Color — Text colour for lower excess annotations.
Trade: SL Line — Colour for the invalidation reference line and its tag.
Trade: Entry Line — Colour for the entry reference line and its tag.
Dash Header BG — Dashboard header background.
Dash Cell BG — Dashboard row background. Alternating rows are generated at reduced opacity from this base.
Dash Text — Dashboard text colour.
Dash Bull Value — Colour for bullish dashboard readings.
Dash Bear Value — Colour for bearish dashboard readings.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Fibonacci Proportion in Market Analysis
The use of Fibonacci proportions in price analysis descends from Ralph Nelson Elliott's wave principle, formalised in The Wave Principle (1938) and developed extensively by A.J. Frost and Robert Prechter in Elliott Wave Principle (1978). Elliott observed that impulse and corrective sequences appeared to relate to one another in proportions approximating the Fibonacci series, with the golden proportion recurring most frequently in extension relationships. The proportions used in this tool — equality, the harmonic proportion, the midpoint, and the golden proportion — are the magnitudes most consistently documented in that literature.
The theoretical status of these proportions remains contested. The academic case for their significance rests less on any intrinsic property of the number sequence than on self-fulfilling coordination: when a sufficiently large body of participants watches the same proportional level, order flow concentrates there, and the level acquires practical significance regardless of its theoretical foundation. This coordination mechanism is a recognised feature of markets with widely shared reference points, related to the focal-point reasoning described in Thomas Schelling's The Strategy of Conflict (1960). The tool takes no position on the deeper question; it renders the levels because participants act on them.
The logarithmic projection option connects to a well-established statistical point. Financial returns are more nearly stationary in logarithmic space than in absolute terms — a foundational observation in the work of Louis Bachelier (1900) and formalised in the geometric Brownian motion framework underpinning Black and Scholes (1973). Applying proportional relationships in log space rather than absolute space is therefore the more defensible treatment on instruments spanning a wide price range.
● Market Profile and Auction Market Theory
The volume profile layer derives from Market Profile, developed by J. Peter Steidlmayer at the Chicago Board of Trade during the 1980s and set out in Markets and Market Logic (1986) with Kevin Koy. Steidlmayer's central insight was that price alone is an impoverished description of market activity, and that organising activity by price level rather than by time reveals the auction's structure: where value was established, where it was rejected, and where the market remains undecided.
The concepts the tool surfaces map directly to that framework. The point of control corresponds to Steidlmayer's fairest price — the level of greatest agreement. The value area corresponds to the region of accepted trade, conventionally taken as the central portion of the distribution and connected to the one-standard-deviation interval of a roughly normal distribution. Excess corresponds to Steidlmayer's treatment of auction extremes: thin regions where price probed and was rejected, marking the boundaries of the auction. James Dalton, Eric Jones, and Robert Dalton extended this vocabulary in Mind Over Markets (1990), formalising the balance-and-imbalance framework the tool's regime reading follows.
The distinction between accepted and unaccepted trade — which underpins the imbalance classification — has a direct analogue in the market microstructure literature on price discovery. Albert Kyle's model in "Continuous Auctions and Insider Trading" (1985) establishes how informed order flow moves price and how the depth of the book determines the magnitude of that movement. Regions of thin participation are, in Kyle's terms, regions of low depth, where a given quantity of order flow produces a disproportionate price move. This is the theoretical basis for the empirical observation that price traverses low-participation regions rapidly.
● Volume as an Independent Information Channel
The premise that volume carries information distinct from price has substantial empirical support. Andrew Lo and Jiang Wang's "Trading Volume: Definitions, Data Analysis, and Implications of Portfolio Theory" (2000) documents systematic volume-return relationships. Lawrence Harris and Eitan Gurel (1986) and Joel Hasbrouck's work on information content in the trade process establish that the distribution of trading activity reveals aspects of participant behaviour that price alone does not.
The tool's structural principle — that a projected price level should be evaluated against the participation context surrounding it — follows from this literature. If volume carries independent information, then a geometric projection evaluated without reference to volume discards half the available evidence.
The finer-resolution sourcing used to build the profile connects to the microstructure work on data aggregation. Maureen O'Hara's Market Microstructure Theory (1995) and the broader literature on the effects of temporal aggregation establish that coarse sampling systematically obscures structure present at finer resolutions. Constructing the profile from finer-resolution activity rather than from chart-bar aggregates is the methodologically stronger treatment.
● Volatility-Adaptive Structural Filtering
The adaptive significance threshold rests on the well-documented phenomenon of volatility clustering, first described in Benoit Mandelbrot's work on the variation of speculative prices (1963) and formalised in Robert Engle's ARCH framework (1982) and Tim Bollerslev's GARCH extension (1986). Because volatility is persistent and varies systematically across instruments and regimes, a fixed structural threshold is necessarily miscalibrated most of the time — too permissive in high-volatility conditions and too restrictive in low.
The volatility measure used for scaling follows the true-range concept introduced by J. Welles Wilder in New Concepts in Technical Trading Systems (1978), which accounts for gaps between sessions that a simple high-minus-low measure omits.
● Swing Identification and Structural Analysis
The confirmed-pivot approach to swing identification descends from the Dow Theory framework articulated in Charles Dow's writings and systematised by Robert Rhea in The Dow Theory (1932), which established the sequence of higher highs and higher lows as the definitional structure of trend. Robert Edwards and John Magee's Technical Analysis of Stock Trends (1948) developed the practical identification methodology that confirmed-pivot detection formalises.
The tool's requirement that a retracement hold inside the preceding impulse for a structure to qualify reflects the Dow Theory criterion for trend continuity: a correction that violates the origin of the move it corrects has terminated the trend rather than interrupted it. Enforcing this condition structurally rather than discretionarily is the mechanical expression of that principle.
The confirmation lag inherent to the approach is a specific instance of a general trade-off examined in the technical analysis literature and in the signal processing literature on causal filtering: any estimator that requires forward information to confirm a feature necessarily reports that feature late. Reducing the confirmation window reduces the lag and increases the false-positive rate. There is no configuration that eliminates both.
● Statistical Smoothing of Distributions
The optional profile smoothing applies kernel-based density estimation, a technique established in the statistics literature through Murray Rosenblatt (1956) and Emanuel Parzen (1962). The relevant insight is that an empirical histogram constructed from finite samples exhibits bin-level variance that reflects sampling noise rather than the underlying distribution, and that neighbourhood-weighted smoothing produces a more faithful estimate of the true density. Bernard Silverman's Density Estimation for Statistics and Data Analysis (1986) treats the bandwidth selection problem the smoothing radius setting exposes to the user.
● Risk Geometry
The risk-to-reward reading is a geometric ratio, and its limitations are worth stating in theoretical terms. Expected value depends jointly on the payoff ratio and the probability of realising it; a favourable ratio with a sufficiently low hit rate is negative-expectancy. This relationship is formalised in the Kelly criterion, derived in John Kelly's "A New Interpretation of Information Rate" (1956) and applied to trading by Edward Thorp. The tool reports the geometry because geometry is observable; it makes no probability estimate, because probability is not.
The broader question of appropriate position sizing given a defined risk boundary connects to the utility-theoretic framework of Harry Markowitz's portfolio selection work (1952) and the risk-adjusted performance measurement literature that followed from William Sharpe (1966). Those frameworks are outside the tool's scope but govern how its risk readings should be applied.
● Structural Anchoring Versus Fixed Windows
The decision to anchor the profile to structure rather than to a fixed window addresses a specific statistical problem: regime heterogeneity. A distribution estimated across a window spanning multiple regimes is a mixture, and its summary statistics describe no single regime. This problem is treated formally in the literature on structural breaks and regime-switching models, notably James Hamilton's Markov-switching framework (1989) and the change-point detection literature descending from E.S. Page (1954).
Structural anchoring is a practical approach to the same problem: rather than estimating a regime boundary statistically, the tool uses the confirmed swing structure as the boundary. The resulting profile describes a single structural leg, which makes its point of control and value area interpretable as properties of that leg rather than as artefacts of an arbitrary window.
⚠️ Disclaimer
This tool is provided for educational and informational purposes only. It does not constitute financial, investment, or trading advice, nor a recommendation to buy, sell, or hold any instrument.
All levels, zones, projections, classifications, signals, and readings produced by this tool are analytical outputs derived from historical price and activity data. They are descriptive and interpretive in nature and carry no assurance of future price behaviour. Projected extension levels indicate where price would sit under a specific proportional relationship; they are not forecasts. Wave-context annotations are interpretive conventions drawn from wave-counting literature and carry no predictive claim. Volume profile features describe activity that has already occurred and do not indicate where activity will occur.
Past performance is not indicative of future results. Trading and investing involve substantial risk of loss, and losses can exceed initial capital in leveraged instruments. No analytical tool eliminates that risk, and no configuration of this tool should be understood as reducing it.
Structural detection depends on retrospective confirmation, which means structural points are established a number of bars after the price extreme they mark. Profile construction depends on the availability and integrity of finer-resolution data, which varies by instrument, venue, and history depth. Readings may differ across brokers, data feeds, and chart configurations. Users should verify outputs independently rather than relying on them exclusively.
Alert messages and automated signal payloads are provided as a convenience. Users who connect them to any execution system do so entirely at their own risk and are solely responsible for validating message handling, order routing, position sizing, and all resulting activity.
We accept no liability whatsoever for any trading losses, missed opportunities, data errors, technical failures, or other damages arising directly or indirectly from the use of this tool or reliance on its outputs. All trading decisions and their consequences rest solely with the user. Users are responsible for conducting their own due diligence, applying appropriate risk management, and where relevant consulting a licensed advisor before acting on any information derived from this tool. Hybrid Smart Money Concepts Pro [MarkitTick] 💡 This advanced technical indicator merges the precision of Smart Money Concepts (SMC) with quantitative statistical models to provide a comprehensive view of market dynamics. Designed as an all-in-one institutional tracking tool, it empowers traders by automating the detection of critical liquidity zones, order blocks, structural shifts, and anomalous price gaps. By moving beyond simple price action and integrating volume-adjusted metrics, trend maturity filters, and standard deviation bands, it filters out market noise to present high-probability areas of interest directly on the chart.
This is the professional version of the free indicator Hybrid Smart Money Concepts
✨ Originality and Utility
● A Unique Synthesis of Methodologies
Traditional indicators often isolate single variables—either momentum, volatility, or price structure. This tool is highly original because it seamlessly bridges classic SMC (like Change of Character and Order Blocks) with quantitative gap theory and linear regression.
• Dynamic Order Block Mitigation
Unlike standard scripts that draw static rectangles, this indicator dynamically tracks the internal volume of Order Blocks. As price action intersects these zones, the script proportionally deducts volume to reflect the concept of "mitigation," alerting traders when an Order Block is heavily tested or depleted.
• Context-Aware Gap Categorization
Gaps are not just highlighted; they are algorithmically categorized into Breakaway, Runaway, or Exhaustion gaps. This is achieved by measuring the gap against recent market structure, prevailing volume averages, and the boundaries of a self-adjusting regression channel.
🔬 Methodology and Concepts
● Advanced Market Structure (CHoCH)
The script continuously scans for Pivot Highs and Pivot Lows over a user-defined swing length. When price decisively closes beyond these established pivot levels, a Change of Character (CHoCH) is confirmed. This signals a potential shift in institutional order flow.
● Order Block Detection and Volume Profiling
Following a structural break, the algorithm scans backward to locate the origin of the move—the last opposing candle before the break. It records the high and low of this candle as the Order Block. Furthermore, it calculates the initial volume associated with this zone. As subsequent price bars re-enter the Order Block, the script uses a fractional overlap formula to reduce the "active volume" of the block, representing the absorption of resting liquidity.
● Smart Regression Channel
To determine when a trend is overextended, the script mathematically fits a linear regression line to recent pivot points. It then calculates the standard deviation of price residuals to plot upper and lower bands. This provides a statistical container for price action, crucial for identifying Exhaustion gaps.
🎨 Visual Guide
● Market Structure Elements
Bullish CHoCH: Represented by a dashed green line and an upward-pointing label marking the breakout level.
Bearish CHoCH: Represented by a dashed red line and a downward-pointing label marking the breakdown level.
● Order Block Visuals
Bullish Order Blocks: Displayed as green semi-transparent boxes extending to the right.
Bearish Order Blocks: Displayed as red semi-transparent boxes extending to the right.
Volume Labels: Text inside the box displays the remaining unmitigated volume. If mitigated beyond 50%, a "High Prob Break" warning appears.
● Gap Visuals
Breakaway Gaps: Highlighted with a deep purple box.
Runaway Gaps: Highlighted with an orange box.
Exhaustion Gaps: Highlighted with a red box.
Rising/Falling Windows: Green and red shaded areas denoting traditional candlestick window gaps.
To learn more about gaps and their types : An Exhaustive Analysis of Financial Market Gaps
● Trade Targets and Risk
Stop Loss Lines: Solid fuchsia lines denoting the invalidation point of a setup.
Take Profit Lines: Dashed blue lines mapping out TP1, TP2, and TP3 based on 1:1, 1:2, and 1:3 risk-to-reward ratios.
Fibonacci Targets: Purple dashed lines denoting 1.618, 2.618, and 3.618 extensions.
● Regression Channel
Base Line: A solid yellow line mapping the linear regression.
Outer Channel: Semi-transparent yellow fill defining the standard deviation extremes.
📖 How to Use
● Step 1: Establish Directional Bias
Observe the chart for a confirmed CHoCH signal. A green CHoCH indicates a potential bullish reversal, while a red CHoCH suggests a bearish shift. Confirm this bias by observing the slope of the Smart Regression Channel.
● Step 2: Identify Entry Zones
Once a CHoCH is plotted, look for the corresponding Order Block box drawn at the origin of the impulse. Wait for price to retrace into this green or red box. Monitor the internal text; if it displays "High Prob Break," the zone may have lost its institutional backing.
● Step 3: Gap Confirmation
Analyze any gaps formed during the impulse. Breakaway gaps (purple) add high conviction to the CHoCH breakout. Conversely, if an Exhaustion gap (red) appears near the outer bands of the regression channel, prepare for a potential reversal or pullback.
● Step 4: Manage Risk
Utilize the automated risk management lines. Place your protective stop order slightly beyond the fuchsia SL line. Scale out of your position as price interacts with the dashed TP1, TP2, and TP3 lines.
⚙️ Inputs and Settings
● Gap Analysis Parameters
Min Gap Size: Defines the minimum point threshold required to validate a gap.
Enable Volume Filter: Mandates that Exhaustion gaps are accompanied by a volume spike exceeding the chosen multiplier.
Enable Maturity Filter: Ensures Exhaustion gaps only print after a trend has persisted for a defined number of bars.
● Smart Regression Channel Settings
Reg Channel Dev Multiplier: Adjusts the width of the channel by altering the standard deviation multiplier.
● Market Structure Settings
Swing Detection Length: Determines the lookback period for defining critical pivot highs and lows.
Volatility Filter (ATR Mult): Filters out minor order blocks by requiring the originating candle to exceed a multiple of the Average True Range.
Max Order Blocks in Memory: Controls how many historical zones are preserved on the chart.
● Target Settings
Target Visibility: Toggles the display of Master Targets, Stop Losses, and Fibonacci extensions globally or specifically for Order Blocks.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Linear Regression and the Method of Least Squares
The Smart Regression component heavily relies on the statistical method of Ordinary Least Squares (OLS). To find the line of best fit through the closing prices of a specific trend period, the script computes the slope and y-intercept. The slope is derived from the covariance of the time variable and price, divided by the variance of time. This mathematical foundation effectively neutralizes extreme short-term variance to expose the true vector of the market.
● Variance and Standard Deviation Dispersion
To identify overextended conditions (crucial for categorizing Exhaustion Gaps), the script calculates the root mean square error (standard deviation) of the price points relative to the regression line. By mapping these deviations, the script utilizes the Empirical Rule of normal distributions. When price action strays beyond the defined multiplier (e.g., 2 standard deviations), the probability of mean reversion increases significantly, providing mathematical weight to the gap exhaustion logic.
● Proportional Volume Mitigation
The script introduces a sophisticated geometric approach to volume analysis. Instead of assuming all volume in an Order Block is consumed upon contact, it calculates a fractional overlap ratio. By dividing the intersection of the current candle's range with the Order Block's dimensions, it creates a mitigation coefficient. This reflects order-flow principles found in market microstructure theories, postulating that resting liquidity is absorbed dynamically based on the depth of penetration.
🔓 vs 🔒 Hybrid Smart Money Concepts (Pro vs. Free)
technical breakdown of the architectural and logical differences between the free and Pro versions of the Hybrid Smart Money Concepts indicator.
● 1. Advanced Risk Management & Automated Targets
The free version identifies structural shifts, but the Pro version acts as a complete quantitative trading engine.
• Dynamic Take Profit & Stop Loss
The Pro script calculates and visually plots specific, risk-based TP1, TP2, and TP3 levels, alongside Stop Loss invalidation lines for both CHoCH events and Order Blocks.
• Fibonacci Extensions
Includes optional automated Fibonacci targets (1.618, 2.618, 3.618) to project extended trend runs.
• Trade State Tracking
The Pro script uses a custom ActiveTrade method to continuously track target hits in real-time, validating the setup's success rate dynamically.
● 2. Smart Regression Channels
The free version relies on a standard Z-score statistical lookback (Stress Model) to estimate market exhaustion. The Pro version replaces this with a highly sophisticated algorithmic tool.
• Algorithmic Boundaries
Calculates dynamic linear regression channels directly tied to recent market structure pivots (Higher Highs/Lower Lows).
• Precision Exhaustion Detection
Gap Exhaustion in the Pro version is explicitly validated by price interacting with these regression standard deviation bands, offering significantly higher institutional accuracy than simple moving average divergences.
● 3. Institutional Order Block Filtering
The Pro script advances Order Block (OB) mechanics from simple structural boxes to volume-weighted liquidity zones.
• Volatility Filtering (ATR)
Order Blocks are only validated if the structural break candle meets an Average True Range (ATR) expansion threshold, efficiently filtering out low-momentum, low-probability setups.
• Volume Mitigation Tracking
Calculates initial volume within the OB and tracks ongoing "mitigation" (how much volume is absorbed by subsequent price action). The indicator's UI updates dynamically to warn of a "Possible Break" or "High Prob Break" based on volume decay.
● 4. Window Gaps and FVG Convergence
• Rising/Falling Windows
The Pro version detects specific continuation gap windows, integrating dedicated volume spike and trend-alignment filters to confirm valid continuation patterns.
• Confluence Merging
If a window gap intersects with a standard Fair Value Gap (FVG), the algorithm automatically merges the logic, aggregating the text and zone to highlight a high-confluence liquidity void.
● Summary
A user would upgrade to the Pro version to transition from manual analysis to systematic execution. The free version offers excellent visual context by identifying structure and basic gaps. However, the Pro version delivers a complete trading framework: filtering bad setups via ATR and Regression Channels, calculating precise entry/exit mathematics for risk management, and providing the deep algorithmic optimization required for seamless, zero-lag alert automation.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Layered Zone Matrix [MarkitTick] 💡Layered Zone Matrix turns the crowded, contradictory picture a chart presents into a single decision surface: one price band that matters right now, a graded verdict on whether that band is worth trading, a complete trade plan attached to it, and the same treatment repeated across up to seven other timeframes so you always know whether the move in front of you is the whole story or a detail inside a larger one. Most traders lose money not because they cannot find levels, but because they find too many and have no consistent way to rank them, no objective test for whether a break through one is real, and no discipline about where the trade dies. This tool answers all three questions on every bar. It marks the band, grades it on four independent readings that either agree or visibly do not, projects an entry, an invalidation and a three-step target ladder measured in risk multiples from that band, and then keeps score in real time: whether the break has established itself, whether the road to the targets is open or obstructed, whether the move is decaying, and how far the position currently stands in R. Every one of those readings is displayed as a plain word or number you can act on, not a curve you have to interpret. It is built for discretionary traders who want a structured second opinion before they commit, for systematic traders who want the entry, stop and targets delivered as structured alerts their bot can consume directly, and for anyone who trades one timeframe but needs to know what the timeframes above and below are doing to the same price. Run it alone and it is a complete framework — bias, level, entry, risk, targets and exit. Run it beside your existing method and it becomes a filter that tells you when your setup has the rest of the market behind it and when it is standing on its own.
🎨 Visual Guide
● The Current-Timeframe Zone
The central object on the chart is a shaded box in indigo drawn across a band of price and spanning a stretch of time. This is the zone your chart timeframe is currently working around. Its upper and lower edges are the two prices that matter most for the next decision: price inside the box is undecided, price beyond an edge is committed until proven otherwise.
The box carries a label at its centre showing the timeframe it belongs to. When overlap hiding is active and this box has taken over other boxes, their names are appended to the same label, separated by a middle dot, so nothing is ever hidden without a visible record of it.
With the summary strip turned off, three further labels stack inside the box: an Energy line, a Breakout line and an Intent line. With the strip on, those readings move into the strip instead and the box stays clean. Both surfaces show the same values — it is purely a question of where you prefer to read them.
● Multi-Timeframe Zone Boxes
Each higher timeframe you enable draws its own box in its own colour, so you can tell at a glance which horizon owns a given band of price. The palette runs from heavy to light as the timeframe drops: deep red for Position, burnt orange for Swing, amber for Intraday, olive green for Short-Term, teal for Scalp, sky blue for Micro, lavender for Tick. Each box carries the timeframe name at its centre and, with the strip off, the same Energy, Breakout and Intent labels the current box shows.
When two boxes cover the same price band, overlap hiding leaves one on the chart and lists the names of the ones it replaced inside its label. A box that almost entirely encloses another survives regardless of its timeframe; where neither encloses the other, the higher timeframe stays. The result is a chart that never stacks four translucent rectangles on the same band.
● The Confluence Zone
Where several timeframe boxes cover a common band, that shared range is drawn as a separate gold box with a heavier border and a label listing the timeframes that meet there. Treat it as the strongest band on the chart: it is the price region multiple horizons are all working around at the same time, which makes both its edges unusually significant and its own target ladder the one worth the most attention.
● Target Ladders
Any box with targets enabled projects a horizontal ladder to the right of the chart, each line carrying a label at its right end:
An Entry line at the edge the trade would trigger through, marked with a ▶ and the exact price.
An invalidation line, drawn solid and thicker than the rest — the level at which the idea is finished.
Three target lines , stepping away from the entry.
The ladder for the current-timeframe box is drawn in the box's own colour with a dashed style. When conviction is thin or the whole setup is small relative to normal chart movement, the same ladder switches to a dotted style — a deliberate visual downgrade telling you to treat the plan as provisional. Ladders belonging to higher-timeframe boxes and to the confluence box are drawn dashed in each box's colour and tagged with that timeframe's name so several ladders can coexist without confusion.
Target labels update as price reaches each level, so a glance at the right edge tells you how far through the ladder the move has already travelled.
● The TP Cluster Zone
When targets projected by different timeframes land in the same narrow band, that band is drawn as its own box with a label to its left. Its fill colour grades the agreement: teal for strong, amber for moderate, red for weak, and a distinct green when the cluster carries independent confirmation. The label reports direction, how many timeframes agree, the centre price and a strength percentage.
This is where profit-taking gets crowded. Trade toward it, not through it, and expect reaction rather than clean continuation on first touch.
● The Dashboard
A compact two-column panel, positioned wherever you place it, organised into labelled sections. The header row shows the symbol, the chart timeframe, and a coverage percentage that turns red when the analysis is running on a thinner sample than it would like.
Lock — whether the display is holding a past entry picture or tracking live.
LIQUIDITY ZONE — Energy, Breakout Bias, Intent, Conviction, Zone High, Zone Low, Price Location, Zone Width and Risk (R).
CORE / STRUCTURE — the Magnet price, your distance to it, and the prevailing Trend.
MTF CONFLUENCE — how many timeframe boxes currently overlap, and which ones.
BREAKOUT ACCEPTANCE — whether the current break has established itself, is still on probation, or is locked out.
BREAKOUT QUALITY — HTF Rotation, Road Ahead and Excess Tail.
TRADE EXIT — the Asymmetric Exit reading on an open position.
QUALITY SCORE — Setup Score before entry, Deterioration after it.
TP CLUSTER — cluster strength, its price band, and whether it is confirmed.
Several rows show a pair of values joined by an arrow while a position is open or held. The value on the left is the reading as it stood when the trade triggered; the value on the right is the reading now. A pair that has degraded from left to right is telling you the conditions you entered on no longer hold.
Where a section applies to a box other than the one on your chart timeframe, its heading carries that box's name after a middle dot, so you always know which object the rows beneath it describe.
● The Summary Strip
A horizontal table anchored top-centre or bottom-centre, listing every box currently on the chart on its own row: the current-timeframe box first, then the confluence zone, then each higher timeframe. Columns run Box, Zone, Energy, Activity, Breakout, Intent, Conviction.
This is the fastest way to answer the question that matters most before any trade: do the timeframes agree, or am I the only one seeing this? A column that reads the same way down every row is alignment. A column that alternates is a warning.
Turning the strip off moves those readings back onto the boxes themselves as stacked labels.
● Chart Notices
An orange notice appears above price when conditions would compromise the readings — a synthetic chart type, a symbol without the data the analysis needs, a stretch of history too large or too thin to analyse fully. Each notice names the problem and suggests the fix. Take them seriously: every reading on screen inherits the limitation the notice describes.
● Symbol Legend
Direction and location
▲ — bullish reading, or price sitting above the zone. Beside the Magnet row it means price is above that level, followed by the distance.
▼ — bearish reading, or price sitting below the zone. Beside the Magnet row it means price is below that level, followed by the distance.
● — price is inside the zone: undecided, and the wrong place to commit.
↔ — no prevailing direction; trade the range, not the trend.
▶ — the entry line and its price. This is the level a trade triggers through.
Verdict marks
✓ — a clean reading on that row: the break has established itself, the road is open, the extreme is well supported, or the position is holding. Nothing to act on.
✅ — independent confirmation, used on the TP Cluster rows and inside the cluster label. Where a timeframe name follows it, that is the box supplying the confirmation.
○ — the cluster exists but is unconfirmed. Usable, but weaker.
⚠ — a caution flag. On a chart notice it opens the line describing the problem. On the Risk row it means the whole setup is unusually small relative to normal chart movement. Beside an extreme it means the furthest point of the move is poorly supported. On an entry label it marks a plan built on thin conviction.
⏳ — the break has not yet proven itself. On the Acceptance row it appears with an elapsed-bar count; on an entry label it means the plan is live but unconfirmed.
⏸ — that break attempt is locked out and will not be traded again until conditions reset.
Trade state marks
⟲ — this box is trading against its own structural direction. Expect the levels to behave as they normally would, but treat the setup as the more demanding of the two cases and size accordingly. It appears on the Conviction row, on entry labels, in the summary strip and inside the TP Cluster label.
⧉ — this box has taken over one or more overlapping boxes; their names are listed in its own label.
→ — separates an entry-time reading from the current one on the dashboard. Left is then, right is now.
Counts and separators
× — precedes a count of agreeing timeframes, on the Overlap row and in the TP Cluster label and row.
· — a separator between fields on one line, and between timeframe names in a box label.
– — separates the low and high of a price band on the Cluster Level row.
— — that reading is unavailable or does not apply in the current configuration.
R — a risk multiple: distance expressed as a multiple of the entry-to-invalidation distance.
📖 How to Use
● Setting Up for Your Style
Start with defaults. The current-timeframe box, its targets, the dashboard, the summary strip and the acceptance filter are all on out of the box, and that combination alone is a complete workflow. Add the rest only as you find you need it — every extra box and ladder costs chart clarity and load.
Scalpers and intraday traders. Work on your execution timeframe with the current box and its targets. Enable two higher timeframes above you — typically Intraday and Swing — with their boxes on but their target lines off. You want to see where the larger bands sit without four extra ladders in the way. Keep the acceptance filter in Entry Gate so you are never entering on a wick, and set Detail Level a little above default so the zone resolves the finer structure your timeframe trades inside.
Swing traders. Work on 1H or 4H. Enable Position and Swing boxes with their targets on, plus the confluence zone. Your best trades are the ones where the confluence box and your chart box are the same band. Detail Level at or near default is right here — you are trading the shape of the zone, not its interior.
Position traders. Work daily. Enable Position and Swing only, turn on the confluence zone and the TP Cluster, and raise the Extension Factor so the target ladder reaches distances a daily trade is actually held for. Leave the lower-timeframe boxes off entirely; they will only add noise on this horizon.
Automated traders. Configure the action strings in the Alerts group to match whatever your receiver expects, decide which boxes should transmit by enabling their target switches, then set one alert on the indicator. Every payload arrives as structured JSON carrying the action, the box that produced it, direction, entry, invalidation and first target.
● Reading the Zone Before Anything Else
The first question is always where price stands relative to the box, and the Price Location row answers it in three words.
Inside. The market is undecided. Fade the edges if you must trade, but expect chop, and do not treat the first touch of an edge as a signal. Most losing trades taken with this tool are taken inside the box.
Above. Price has committed upward. The upper edge is now the level that must hold; a close back below it is the failure signal.
Below. The mirror case. The lower edge must hold and a close back above it ends the idea.
Alongside those words the same row reports your position in the trade: how many R you are ahead or behind while a trade is open, how many R remain to the entry when it is not, or simply that the entry has been triggered.
Zone Width tells you what kind of trade is on offer, as a percentage of price. A wide zone means a large stop and a slow, positional trade; a narrow one means tight risk and a fast decision. Match it to what you are actually willing to hold. If the width looks wrong for your style, change timeframe rather than fighting it.
● The Four Readings, and What to Do About Each
Four graded readings sit on top of every box. They are independent of one another, and their value comes precisely from the fact that they can disagree.
Energy is reported as a grade — Dominant, Strong, Moderate or Weak — with a meter beside it. Dominant and Strong say this zone deserves your attention and its edges are likely to produce clean reactions. Moderate is tradeable with reduced size. Weak says the band is soft: its edges will be crossed casually and stops placed just beyond them will be taken for no reason. On a Weak zone, either stand aside or widen your stop beyond the opposite edge and accept the smaller size that forces.
Breakout Bias states which direction the zone is leaning and how firmly. When bias agrees with the direction you were already planning to trade, take the trade at full size. When it disagrees, you are trading against the zone's own lean and should either wait or halve your risk. When it reads neutral, there is no edge in direction — trade the range between the edges instead of trying to break out of it.
Intent is the slower of the two directional readings and it changes less often. Its job is to warn you when the surface direction and the underlying one point different ways. Bias up with Intent down is the classic trap: the break happens, it looks clean, and it fails within a few bars. When bias and intent agree, that is your highest-quality condition on the chart and the one worth sizing up into.
Conviction is the summary of the other three, shown as a graded word with a direction arrow. Three-way agreement is the top grade and is where your best trades live. Two-way is normal and tradeable. One-way agreement means the setup is being carried by a single reading — take it only with reduced size and a tight leash. When conviction reads at its lowest, the tool will not trade the box at all, and neither should you.
While a trade is open, the dashboard shows both the entry-time and current values of these readings side by side. Conviction that has fallen from three-way to one-way since you entered is a reason to take profit early even if no stop or target has been touched.
● The Magnet and the Trend
Two rows sit under CORE / STRUCTURE.
Magnet is a single price inside the zone that price tends to return to. Use it three ways. As a target when you are trading from an edge back into the zone. As a partial-profit level when your trade is running and the magnet lies between you and the next target. And as a warning: a trade entered when price is already very close to the magnet has little room to work before it stalls.
Dist to Magnet gives you that room as a number, with an arrow showing which side of it you are on. A large distance argues for continuation trades; a very small one argues for patience.
Trend reports the prevailing direction as bullish, bearish or neutral. Its main use is as a veto: taking a long while trend reads bearish is possible and sometimes correct, but it is a lower-probability trade and should be sized as one. When trend flips, the tool issues its own structure alerts, and the whole picture on the chart can reorganise around the new direction — expect the box to move, and expect its ladder to move with it.
● Trading the Break
The mechanics are the same for every box.
Wait for price to close beyond an edge in the direction conviction supports.
The entry line marks the level. The solid line marks where the idea is dead. The three dashed lines are your ladder.
The Risk (R) row shows the distance between entry and invalidation in price terms, followed by the three targets expressed as multiples of it. Size your position from that number, not from the chart's appearance.
If the Risk row carries a caution flag for being unusually small, skip the trade. A stop that sits inside normal chart movement will be taken by noise alone.
The first target is close enough to be reached often and is the natural place to reduce. The second is the workhorse. The third is a runner and should be treated as a bonus rather than a plan.
● Acceptance: Separating Real Breaks From Touches
The single most valuable filter here answers the question every breakout trader asks too late: was that real?
The Acceptance row grades every break on the same four-step scale — Dominant, Strong, Moderate, Weak. The higher the grade, the better established the move beyond the edge, and the less likely price is to come straight back. A Weak reading is the tool telling you the market poked its head out and lost interest.
The role you assign to that reading is the most consequential setting in the tool.
Show Only — entries fire on the plain edge cross and the grade is displayed but never acts. Choose this while you are learning what the grades look like on your instrument.
Exit Alarm — entries still fire on the cross, but a trade that never establishes acceptance is closed out. This is the setting for traders who would rather be in early and get out fast.
Entry Gate — nothing triggers until acceptance is proven. Fewer trades, later entries, materially better ones. This is the default and the right choice for most people.
While a break is being assessed the row shows a probation state with an elapsed count. A break that never establishes itself is locked out, and the row says so — that band will not be re-traded in that direction until conditions reset. Respect the lock rather than overriding it manually.
● The Quality Filters
Three optional readings answer separate questions about whether a break is worth taking. Each runs in three modes: off, display-only, or as an active filter that refuses or closes trades. Start every one of them in display-only, watch how they read on your instrument for a few dozen setups, then promote the ones that earn it.
HTF Rotation answers: is this break actually going anywhere, or is it just movement inside a bigger band? A clear reading means the path is unobstructed. A blocked percentage with a timeframe name beside it means you are breaking out into the middle of a larger box — the move has somewhere to go, but not far, and the far targets on your ladder are unlikely to be paid. Take the first target and leave.
Road Ahead answers: how far is it to the first obstacle, in R? Open road means nothing stands between the entry and the ladder. A barrier reported at a low R means your first target sits behind an obstruction and the ladder is optimistic. The rough guideline: a barrier below 1R argues for skipping the trade, between 1R and 2R argues for taking the first target only, and above 2R leaves the full ladder in play.
Excess Tail answers: was the furthest point the move reached genuinely supported, or did the market visit that level and reject it? A backed extreme is healthy. A thin one, flagged with a caution mark, is a rejection you should act on — the move has already shown you its limit. In filter mode this reading closes an open trade on its own.
Quality Score replaces the individual yes/no tests with two graded percentages. Setup Score summarises everything measurable before you commit, and works well as a single go/no-go number once you have calibrated a threshold on your own instrument. Deterioration is its opposite for an open position, rising as the trade decays. A Deterioration reading climbing steadily while price has not yet reached the first target is the earliest reliable warning the tool gives you.
● Managing an Open Position
Choose where your stop sits before you take the trade, not after.
Entry Candle Extreme — the tightest option and the most easily taken out. Best on clean, fast instruments.
Box Midpoint — a middle ground with meaningfully smaller risk than the far edge.
Box Edge — the widest and most forgiving. The right default when you are unsure.
Last Swing — the structural choice and the shipped default, placing the stop behind the last relevant turning point.
A stop too close to the entry to be meaningful is automatically replaced with the opposite edge, so your R figure always describes real risk.
Trailing has three modes. Off leaves the stop where it started. Breakeven after the first target removes your risk once the first level is paid. Step Ladder walks the stop up behind each target as it is reached. The stop only ever moves toward profit, and every move transmits its own alert — a stop that moves on the chart but not in your broker protects nothing.
The Asymmetric Exit setting decides how a return back inside the zone is treated. Off exits on the first close back inside, which is fast but produces frequent shakeouts. Display-only shows how established the return is but still exits on the single close. Filter mode requires that return to establish itself over a short window before it invalidates the trade — fewer premature exits, at the cost of giving back a little more when the failure is real. The Asym Exit row shows the reading live while the trade is open: holding, or a grade describing how well established the return back inside is.
● Working Across Timeframes
The multi-timeframe layer answers a question a single chart cannot: is the band you are trading also a band someone above you is trading?
Read the summary strip top to bottom before committing. A setup where your row and the rows above it show the same Breakout and Intent direction is a trade with the weight of the chart behind it. A setup where your row points one way and every row above points the other is a counter-trend scalp at best, and should be sized as one.
Boxes from higher timeframes are also useful purely as terrain. A target that sits inside a higher-timeframe box will struggle to be reached cleanly; a target sitting in clear space between boxes is far more likely to be paid. You can read this directly off the chart, and the Road Ahead row quantifies it for you.
Turn overlap hiding on as soon as you enable more than two timeframes. Without it, boxes stack and the chart becomes unreadable; with it, one box survives per band and the label tells you which timeframes it stands in for. The mark ⧉ on an entry label is the same information in the ladder.
● Trading the Confluence Zone
The gold box is the highest-conviction object the tool draws, and it deserves a workflow of its own.
Its edges are the levels most worth defending, because several horizons are working around the same band. A break through a confluence edge in the direction its own conviction supports, with acceptance confirmed, is the tool's strongest configuration. Enable its target ladder and trade it directly.
Set the minimum overlap requirement according to how selective you want to be. Two timeframes is permissive and produces zones regularly. Three or more produces a zone rarely, but when it does you should be paying full attention.
● Trading the TP Cluster
The cluster box marks where the targets of different timeframes bunch together. Its practical uses are specific:
As a profit target. When a cluster sits between you and your third target, take profit at the cluster instead. That is where other participants' orders are waiting.
As a reversal zone. Price arriving into a strong cluster against a trend frequently turns there. A confirmed cluster — the ✅ mark, with the confirming box named — is the version worth trading against.
As a filter. A trade whose ladder points directly into a strong cluster is a trade with a natural ceiling. Shorten your expectations rather than abandoning the setup.
The strength percentage is your ranking tool: high strength means many timeframes agree in a narrow band, low strength means a loose coincidence of two. Tighten the tolerance to demand closer agreement and produce fewer, better clusters; widen it to see more.
The Confirmation row completes the picture. A confirmed cluster has independent support behind it and can be traded as a level in its own right. An unconfirmed one is a useful target but a poor entry.
● Reviewing Trades With the Lock
Freeze on entry holds the whole picture from the most recent confirmed entry: the boxes, the entry, invalidation and target lines, and the zone readings as they stood at that moment. Live states keep running against those frozen levels, so target hits, stop hits, running R and every alert continue to work normally.
This is a review tool, and it changes how you learn from your trades. With it on, a trade that has already closed remains on the chart exactly as it was entered, so you can compare the conditions you took it on with what actually happened. The Lock row tells you at a glance which mode you are in, and the paired readings on the dashboard show entry-time against current for every relevant row.
Leave it off for live trading — you want the picture to track the market, not a past decision. Turn it on when you sit down to review.
● Alerts and Automation
The tool transmits a complete trade lifecycle. Entry alerts carry direction, the box that produced them, the entry price, the invalidation and the first target. Target alerts fire as each of the three levels is reached. Stop-move alerts fire whenever trailing advances the stop. Close alerts fire on invalidation and on every other condition that ends a trade. Structure alerts fire independently when the prevailing direction flips. Cluster alerts fire when price reaches a cluster band, with a separate condition for confirmed clusters only.
Every payload is JSON with a consistent shape, and the action names are yours to define in the settings so they match whatever your receiver expects. Two practical rules: define the stop-move action, since a stop that moves only on the chart protects nothing, and give the structure actions distinct names so your receiver can tell structure orders from box-breakout orders.
Named alert conditions are also available for manual use, covering the directional signals, box entries in both directions, each of the three targets, stop hits, stop moves and cluster arrivals.
● Load, Data Quality and Instrument Choice
Watch the coverage percentage in the dashboard header. When it turns red, one of the chart notices will explain why, and the fix is nearly always the same: choose a coarser custom timeframe so the same span is covered with less to process, or move to an instrument with a denser data feed.
Higher Detail Level, more enabled timeframes and more target ladders all cost execution time. If the tool becomes slow, reduce in that order: turn off ladders you are not trading, then disable timeframes you are not watching, then lower Detail Level. Turning the current box off does not reduce load — the analysis continues to run and the dashboard, alerts and other boxes are unaffected.
On synthetic chart types the notice will appear because the prices themselves are synthetic. The tool will still run, but every reading and every level describes the synthetic series rather than the market, and should not be traded on.
⚙️ Inputs and Settings
● 📈 Layered Zone Settings
📦 Show Current-TF Box — draws the current-timeframe box, its labels and its targets. Turning it off only hides them; the dashboard, the alerts and the other boxes are unaffected.
↳ 🎯 Current-Box Targets — projects the entry, invalidation and three-step ladder for the current box.
⚙️ Use Custom Timeframe — overrides the automatic choice of analysis resolution with your own.
⏱️ Custom Timeframe — the resolution used when the override is on. Coarser settings cost less and cover more history; finer settings resolve more detail at higher load.
🔢 Detail Level — how finely the zone is resolved, from 5 to 153, default 24. Higher values expose finer structure at the cost of execution time; the ceiling is set where added detail starts competing with the platform's limits.
🌊 Smooth Cluster — evens out isolated noise in the readings when running at high detail. Off by default.
Radius — how strongly that smoothing is applied, from 1 to 10.
● 🗂️ Multi-Timeframe Boxes
👁️ Show Multi-TF Boxes — master switch for the higher-timeframe boxes. Colours run lighter as the timeframe drops.
🚫 Hide Overlapping (keep dominant box) — where boxes cover the same band, shows one and lists the rest inside its label. Enable this as soon as you use more than two timeframes.
🎯 MTF-Box Targets — master switch for the higher-timeframe trade ladders. Each timeframe is then gated by its own targets toggle. Off by default; this adds many lines and load.
🏔️ Position and its timeframe field — the highest slot, weekly by default.
↳ Position Targets — draws this slot's ladder independently of its box, so you can keep the box without the lines or the lines without the box.
🌊 Swing and its timeframe field — daily by default, with its own ↳ Swing Targets toggle.
☀️ Intraday and its timeframe field — four-hour by default, with its own ↳ Intraday Targets toggle.
⏱️ Short-Term and its timeframe field — one-hour by default, with its own ↳ Short-Term Targets toggle.
⚡ Scalp and its timeframe field — thirty-minute by default, with its own ↳ Scalp Targets toggle.
🔬 Micro and its timeframe field — fifteen-minute by default, with its own ↳ Micro Targets toggle.
⚛️ Tick and its timeframe field — five-minute by default, with its own ↳ Tick Targets toggle.
Each slot's timeframe field is free — the names are conveniences, not constraints. A slot set below your chart timeframe is ignored.
● 🎯 Confluence
🎯 Show Confluence Zone — highlights the band where several timeframe boxes overlap.
↳ 🎯 Confluence-Box Targets — draws the full entry, invalidation and three-target ladder for that band.
Min Overlapping TFs — how many boxes must share a band before it is flagged, from 2 to 7. Raise it for fewer and stronger zones.
● 🎯 Breakout Targets
Extension Factor — stretches the whole ladder, from 0.3 to 3.0. At 1.0 the targets sit at the standard multiples; at 2.0 every step doubles. Values below 1.0 are treated as 1.0. Raise it for longer holds, leave it alone for intraday work.
Show Invalidation Level — draws the level that ends the idea. Leave this on.
⟲ Enable Reversal — allows a box to trade against its own structural direction when the opposing reading is strong enough. Reversals engage at a high threshold and only release below a lower one, and a conflicting directional reading blocks them. Off by default, in which case every box trades its plain structural direction and nothing is ever marked ⟲.
🔒 Freeze Chart on Entry — holds the picture from the most recent confirmed entry until a newer one replaces it. Live states keep running against the frozen levels. Off by default, which is what you want for live trading; turn it on for review.
✅ Acceptance Filter — master switch for the acceptance grading. Off reduces entries to a single close beyond the edge.
⚙️ Acceptance Role — Show Only displays the grade without acting on it; Exit Alarm closes a trade that never establishes acceptance; Entry Gate refuses entry until acceptance is proven. Entry Gate is the default and the most selective.
⚖️ Asymmetric Exit — Off invalidates on one close back inside the edge; Show Only measures the return but still exits on that close; Filter requires the return to establish itself first.
🛑 Stop Loss At — Entry Candle Extreme, Box Midpoint, Box Edge or Last Swing. Last Swing is the default. A stop too close to the entry to be meaningful is replaced with the opposite edge so the R figure stays honest.
🪜 Trail Stop — Off keeps the stop at entry; Breakeven after TP1 moves it to the entry level once the first target pays; Step Ladder additionally moves it to the first target when the second pays. The stop only moves toward profit, and every move transmits.
● 🧪 Breakout Quality
🧭 HTF Rotation — Off, Show Only or Filter. In Filter mode a break landing inside a larger box is refused as an entry.
🛣️ Road Ahead — Off, Show Only or Filter. Reports the distance from the break to the first obstacle in R, and in Filter mode refuses entries with too little room.
🕳️ Excess Tail — Off, Show Only or Filter. In Filter mode a poorly supported extreme closes the open trade.
🧮 Quality Score — Off, Show Only or Filter. Replaces the individual pass/fail tests with a Setup Score before entry and a Deterioration reading after it; Filter mode gates on both.
Promote each of these from Show Only to Filter one at a time. Enabling several filters at once on an unfamiliar instrument produces very few entries and no information about which filter was responsible.
● 🔗 TP Cluster Zone
🔗 Show TP Cluster Zone — highlights bands where targets from several timeframes agree. Requires the multi-timeframe boxes.
🔢 Min Agreeing TFs — how many distinct timeframes must land in the same band, from 2 to 9.
📐 Tolerance Mode — ATR or Percent, deciding how the agreement band is measured.
📐 ATR × Tolerance — in ATR mode, how many ATRs apart targets may sit and still merge. Lower values demand tighter agreement.
📐 Percent Tolerance % — the same control in Percent mode, as a percentage of price.
🧲 Weight by Intent — blends cross-timeframe agreement with the intent readings of the boxes that formed the cluster, so a band whose intent supports its direction scores higher. Off means strength comes from timeframe count alone.
📐 ATR Length — the ATR length used for cluster tolerance only, independent of everything else.
🧲 Require Intent Confirmation — draws only clusters that carry independent confirmation. Off draws every qualifying cluster and simply marks the confirmed ones.
● 📊 Dashboard
📊 Show Dashboard — the summary panel.
Position — Top Right, Top Left, Bottom Right, Bottom Left or Middle Right.
Summary Strip Position — anchors the horizontal box-summary table at the top or bottom centre of the chart. It stays horizontally centred either way and does not affect the dashboard.
● 🔔 Alerts
↑ Long Action and ↓ Short Action — the values placed in the action field of a breakout entry payload. Match these to the commands your receiver expects.
✕ Close Long Action and ✕ Close Short Action — the values sent when a position is closed.
◆ TP-Hit Action — sent as each target is reached.
↕ Move SL Action — sent whenever a reached target moves the stop. Configure this; a stop that moves on the chart but is not transmitted protects nothing.
The four structure-shift action fields — two entry and two close values, sent when the prevailing direction flips rather than when a box breaks. Give them distinct names so your receiver can separate them from box orders.
🔗 TP Cluster Action — sent when price reaches a cluster band.
● 🎨 Layered Zone Colors
Current-TF: Box Color and Current-TF: Text Color — the fill and label colour of the current-timeframe box.
Position / Swing / Intraday / Short-Term / Scalp / Micro / Tick: Box Color — one colour per higher-timeframe slot. Keep them distinct; you will be identifying boxes by colour at a glance.
Bias Up Text , Bias Down Text and Bias Neutral Text — the three colours used for the directional readings.
The two Intent text colours — the positive and negative states of the Intent reading, sitting directly beneath the bias colours in the group.
Conviction Mixed Text — the colour used when conviction is partial rather than full.
Confluence: Box Color and Confluence: Text Color — the shared-band box and its label.
Dashboard: Header BG , Row BG , Section BG and Text Color — the panel's own palette.
Trade Label Text — the text colour on ladder labels. Label text automatically switches to a dark variant where that reads better against the line colour.
TP Cluster: Strong / Medium / Weak Fill — the three strength colours of the cluster box.
TP Cluster: Confirmed Fill and Confirmed Border — the distinct treatment given to a confirmed cluster.
TP Cluster: Border and TP Cluster: Text — the outline and label colour of an unconfirmed cluster.
● 🔲 Embedded Label Style
Box Background Color — the backing panel behind the labels drawn inside boxes. Darken it to make label text readable over busy price action; lighten it toward transparency to keep the chart open.
⚠️ Disclaimer
This tool is provided for educational and informational purposes only. Nothing it displays constitutes financial, investment or trading advice, and no reading, level, signal or alert should be treated as a recommendation to buy or sell any instrument.
Trading involves substantial risk of loss and is not suitable for every participant. Past behaviour of any market, and any historical appearance of the readings described here, offers no guarantee of future results. All levels and readings are analytical outputs, not predictions.
Users are solely responsible for their own decisions, their own risk management and their own position sizing. No liability whatsoever is accepted for trading losses or for any other outcome arising from the use of this tool. Test any configuration thoroughly before committing capital to it. Dynamic Trend-Based Fibonacci Extension Pro [MarkitTick] 💡 This advanced technical indicator implements a sophisticated, multi-layered framework for detecting and projecting Trend-Based Fibonacci Extensions through a dynamic lens. Unlike static tools, it automates the identification of high-probability A-B-C price structures across both local and higher timeframes, integrating volatility-adjusted swing detection with rigorous precision filters. It is designed for traders seeking a systematic approach to identifying institutional target zones, wave completion points, and high-quality retest opportunities with built-in risk-to-reward visualization.
This is the professional version of the free indicator Dynamic Trend-Based Fibonacci Extension
✨ Originality and Utility
The Dynamic Trend-Based Fibonacci Extension Pro stands apart from conventional charting tools by moving beyond simple point-and-click placement. Its primary originality lies in its adaptive nature and "state-aware" structure management:
● Adaptive Volatility Filtering
Traditional ZigZag and Fibonacci tools often fail during periods of changing volatility. This script utilizes an ATR-based threshold mechanism to dynamically adjust pivot detection sensitivity. This ensures that swing points are confirmed based on the current market environment rather than arbitrary fixed percentages.
● Retest Precision Engine
One of the most significant hurdles for traders is identifying when a broken structure remains valid for a retest. This script introduces a logic-gated "Retest Phase" that grays out invalidated structures and re-activates them only when specific high-conviction criteria are met, such as low-volume pullbacks or price rejection candles at Point C.
● Higher Timeframe (HTF) Confluence
The indicator provides a dual-layer perspective by projecting HTF Fibonacci levels directly onto the current chart. This allows traders to identify "Nested Structures"—where a local bullish setup aligns with a major HTF extension zone—dramatically increasing the statistical probability of the trade.
● Integrated Risk/Reward Visualizer
By calculating entry points at the breakout of Point B and placing stop-losses relative to Point C (with user-defined buffers), the script provides an immediate visual assessment of the trade's viability, including automated R:R ratio calculations.
🔬 Methodology and Concepts
The script operates through a sequential logic pipeline that ensures only structurally sound setups are displayed:
• Pivot Point Identification
The core uses a lookback depth algorithm to identify local Highs and Lows. For a point to be considered a "ZigZagPoint," it must represent a significant deviation defined by either a fixed percentage or an ATR multiplier. This eliminates market noise and focuses on structural impulses.
• The A-B-C Structural Logic
A bullish structure is defined as a sequence of a Low (A), a High (B), and a Higher-Low (C). Conversely, a bearish structure follows a High (A), a Low (B), and a Lower-High (C). The script validates that Point C has not breached the origin of Point A, ensuring a valid trend impulse exists.
• Fibonacci Extension Calculus
Extensions are calculated by measuring the distance between Point A and Point B, then projecting that distance from Point C. The formula used is:
Target = PriceC + ((PriceB - PriceA) * Ratio)
For instruments with extreme price ranges, such as Cryptocurrencies, the script offers a Logarithmic Scale mode, which calculates extensions based on the natural logs of the prices to maintain geometric accuracy.
• Validation Filters
Trend Filter: Point C must align with the direction of a 200-period EMA.
Momentum Filter: Utilizes the RSI to ensure Point C is occurring at an overbought/oversold extreme.
Volume Filter: Requires a volume spike at the pivot to confirm institutional participation.
Retracement Depth: Ensures the B-C move is between 38.2% and 88.6% of the A-B impulse to prevent shallow or over-extended setups.
🎨 Visual Guide
The visual output is highly organized to maintain chart clarity despite the complexity of the underlying data:
● Primary Structure Lines
Solid Trendlines: Represent the A-B impulse move.
Dashed Trendlines: Represent the B-C retracement move.
Color Coding: Bullish structures appear in Emerald Green (#00E676), while Bearish structures appear in Sunset Red (#FF5252).
● Fibonacci Extension Levels
1.000 Level (Equality): Displayed as a dotted line, signifying where Wave C equals Wave A.
1.272 Level: Often used as a harmonic reversal or "bull trap" zone.
1.500 & 1.618 (Golden Zone): The area between these two levels is highlighted with a semi-transparent fill. This "Golden Zone" is the primary target for Wave 3 or Wave C extensions.
Elliott Wave Labels: Extension levels are automatically tagged with context, such as "Wave 3" or "Harmonic," to assist in wave counting.
● Retest and Invalidation Visuals
Grayed Out: When price closes beyond Point C, the entire structure turns gray (#555555), indicating it is currently inactive.
Orange Retest: If price returns to Point C under normal conditions, the structure turns Orange (#FF9800).
Cyan Ideal Retest: If a retest occurs with low volume and a rejection candle (Pin Bar), the structure turns Cyan (#00BCD4), marking a high-probability entry.
● Risk/Reward Zones
Entry Line: A Blue dashed line at the level of Point B.
Stop Loss Zone: A Red transparent box extending from Point C to the SL buffer.
Take Profit Zone: A Green transparent box extending to the 1.618 extension level.
● Higher Timeframe (HTF) Elements
HTF structures are drawn with thicker lines (width 3) and use distinct colors (Cyan for Bullish, Orange for Bearish) to ensure they are not confused with local timeframe data. Labels are prefixed with "HTF" for immediate identification.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
The indicator is built upon several pillars of quantitative finance and technical theory:
• Phidias and the Golden Ratio
The mathematical foundation is rooted in the Fibonacci sequence and the limit of its ratios, approximately 1.618. In financial markets, this ratio is used to model the "growth" of a price impulse, based on the observation that market cycles often expand in proportions found in nature.
• Volatility-Adjusted Thresholds (Statistical Deviation)
By using the Average True Range (ATR), the script applies the principles of statistical volatility. Instead of a linear threshold, it uses a non-linear filter that accounts for the standard "noise" of the asset. This is academically linked to the concept of the "Signal-to-Noise Ratio" in time-series analysis.
• Volume-Price Agreement (VSA)
The retest logic incorporates elements of Volume Spread Analysis. The requirement for low volume during a retest of Point C is based on the theory that if an impulse is to continue, the counter-trend move should exhibit a lack of supply (in bullish cases) or a lack of demand (in bearish cases).
• Logarithmic Growth Models
The inclusion of logarithmic extension calculations recognizes that price action in high-growth assets is often exponential rather than linear. By applying natural logarithms, the script treats price moves as percentage changes, which is the standard for long-term econometric modeling.
📖 How to Use
Setup Detection: Allow the script to identify an A-B-C structure. Wait for the "A-B-C" labels to appear on your chart.
Validation: Check the dashboard in the corner. Ensure the "Scale Mode" and "Detection" methods match your trading style.
Entry Strategy:
• Aggressive: Enter on the confirmation of Point C if the Volume and RSI filters pass.
• Conservative: Enter on a breakout of Point B (the Blue Entry Line).
• Retest: Wait for an "Ideal Retest" label (Cyan). This occurs when price touches Point C and forms a rejection candle on low volume.
Targeting: Use the 1.000 level for initial scaling and the 1.618 "Golden Zone" for final profit-taking.
Risk Management: Place your physical stop-loss at the Red SL line. If the structure grays out, the trade thesis is invalidated.
⚙️ Inputs and Settings
● ● ZigZag Detection
• Pivot Lookback Depth: Controls how many bars are required to confirm a high or low. Higher values find "major" trends; lower values find "scalping" setups.
• Use ATR-Based Threshold: Toggles between volatility-adjusted or fixed percentage swing detection.
● ● Retest Precision Filters
• Min Bars After Break: Prevents "instant" retests that are often just price volatility. Requires a gap between the break of C and the return to C.
• Low Volume on Retest: When enabled, the retest must occur on volume lower than the 20-bar average.
• Rejection Candle at C: Requires a Pin Bar or Engulfing candle to trigger an "Ideal Retest" status.
● ● Momentum & Trend Filters
• Enable RSI Filter: Filters for setups where Point C is at a momentum extreme.
• Enable Trend Baseline Filter: Uses a 200 EMA to ensure you are only trading in the direction of the long-term trend.
● ● Higher Timeframe
• Select Timeframe: Choose which HTF to pull data from (e.g., Daily for an Hourly chart). This displays the "Big Picture" extensions.
🔓 vs 🔒 Dynamic Trend-Based Fibonacci Extension (Pro vs. Free)
• Object-Oriented Optimization
Object-Oriented Optimization: The Pro version shifts from standard functional programming to advanced Object-Oriented Methods attached to User-Defined Types (UDTs). It also utilizes var-declared, pre-computed global arrays for Fibonacci ratios to drastically reduce per-bar memory allocation and processing overhead.
• Algorithmic Trade Validation
Algorithmic Trade Validation: Introduces institutional-grade confirmation layers, including a Trend Baseline Filter (EMA), RSI Momentum validation, and a Volume Spike identifier, ensuring structures are mathematically validated before generating signals.
• Precision Retest & Retracement Engine
Precision Retest & Retracement Engine: Upgrades basic structural invalidation with strict B-C retracement depth constraints (e.g., 0.382–0.886). It includes a dynamic Retest Engine that classifies pullbacks as "Ideal" or "Normal" using real-time volume analysis and wick-to-range candlestick rejection logic.
• Zero-Repaint MTF Integration
Zero-Repaint MTF Integration: Implements a Higher Timeframe (HTF) algorithmic overlay using strictly compliant request.security calls, anchored with offsets and barmerge.lookahead_on to absolutely prevent repainting.
• Advanced Analytics UI
Advanced Analytics UI: Features a dynamic on-chart Dashboard Table for real-time statistical tracking, an algorithmic Anti-Overlap label engine to prevent visual clutter, and visual Risk/Reward (R:R) mapping for Entry, Stop Loss, and Take Profit zones.
• Institutional JSON Webhooks
Institutional JSON Webhooks: Alert payloads are engineered as strictly formatted JSON strings designed for automated execution (e.g., PineConnector, 3Commas), dynamically calculating and appending the precise Entry Price, Target Price (TP), and a buffered Invalidation Price (SL).
• Fibonacci Time Extensions
Fibonacci Time Extensions: Projects vertical time-based targets (e.g., 1.0, 1.618) derived from the A-B impulse duration to forecast temporal reversal zones alongside price targets.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Smart Money Liquidity Flow System [MarkitTick] 💡 Markets do not move in straight lines — they breathe, recoil, and accelerate through a perpetual cycle of liquidity creation and consumption. The Smart Money Liquidity Flow System is a comprehensive multi-layer market analysis tool designed to surface the structural mechanics that underlie this cycle, bringing together swing-based market structure, dynamic supply and demand zones, liquidity sweep detection, volume anomaly recognition, volume-weighted imbalance mapping, and an intelligent composite alert engine into a single, unified overlay. A live structural dashboard, anchored to the chart as a heads-up display, consolidates all active system metrics into a single continuously-updated reference panel — delivering market trend state, zone strength, volatility, imbalance counts, zone freshness, order flow health, and pending liquidity exposure without requiring the trader to interpret the canvas in isolation. Rather than presenting isolated signals, this system exposes the relationships between price structure, volume behavior, and zone interaction — giving traders a layered context framework through which every bar can be interpreted not as a standalone event, but as a continuation of or deviation from the dominant structural narrative. Whether applied to equities, futures, forex, or crypto on any standard candlestick timeframe, the system operates entirely on confirmed bar data, ensuring that every visual element and every alert reflects a committed market state — not a transient, intrabar fluctuation.
✨ Originality and Utility
● A Unified Structural Intelligence Framework
Most market structure tools operate in silos. Break-of-structure indicators draw lines. Volume tools plot histograms. Fair value gap scanners shade boxes. Each layer is useful in isolation, but the trader is left to manually reconcile competing signals across separate panes and windows. The Smart Money Liquidity Flow System was built specifically to eliminate this reconciliation burden. Every analytical layer within it — structure breaks, zone generation, inducement detection, sweep tracking, volume classification, anomaly identification, imbalance marking — shares a common structural state, meaning that each element reinforces or contextualizes the others in real time on a single overlay. The result is a reading environment where confluence is surfaced automatically, rather than assembled manually.
● Non-Repainting by Architecture, Not by Configuration
Repainting is not merely a configuration error — it is an architectural failure. Many structure-based tools repaint because their signal logic depends on the forming bar's close or on future pivot confirmation. This system was designed from the ground up around confirmed bar data at every layer. Swing detection, zone creation, structure break classification, volume analysis, imbalance detection, sweep recognition, and alert dispatch all operate exclusively on bars that have closed and committed. The higher timeframe integration layer compounds this: when HTF data is engaged, the system requests only confirmed, prior-bar-closed values, preventing any leakage of future higher timeframe data into the current chart's history. The indicator is equally reliable in backtesting and in live deployment — the chart will not change its signals retroactively.
● Quantitative Volume Intelligence Integrated into Structure
Volume is not treated as a secondary decoration in this system. It is woven into the structural fabric as a primary filter and classifier. Volume-weighted imbalance detection ensures that only gaps backed by exceptional participation are marked — removing the noise of low-conviction gaps that appear frequently on quiet sessions. The volume classification engine contextualizes every high-volume bar by measuring how far back in time one must look to find a bar of equivalent or greater volume, providing a recency-relative reading of volume significance. The anomaly engine adds a further layer by identifying bars where volume effort is disproportionately large relative to the price result — a footprint consistent with contested, absorbed, or trapped participation.
● Adaptive Zone Memory with Structural Decay
Static zones are misleading: a supply zone that was relevant 400 bars ago carries materially different weight than one tested three bars ago. The time-decay mechanism within this system reflects this reality by progressively reducing the visual prominence of zones as they age, without removing them. This gives traders an immediate, intuitive read on zone freshness — recent zones are vivid and high-contrast; aged zones fade into the background. When zones are broken with force — particularly when multiple zones are penetrated in the same move — the system marks those zones as luminous, signaling that price has demonstrated multi-layered momentum rather than a single, isolated break.
● Composite Alert Architecture for Automated Workflows
The alert system is not a simple signal flag. It is a structured dispatch engine that accumulates all signals generated during a confirmed bar — including structure breaks, character changes, and zone breaks — and emits them as a single, fully-formed JSON payload. This architecture eliminates duplicate webhook calls, prevents alert fragmentation, and ensures that every automation endpoint receives a complete, machine-readable snapshot of the bar's structural events in a single message. Entry price, stop loss, and take profit are calculated dynamically for each signal type and formatted to tick precision, making the output immediately actionable for execution bridges without additional post-processing.
● Live Structural Dashboard as Continuous Situational Awareness
Beyond event-driven signals and canvas drawings, this system provides a continuously-updated heads-up display that consolidates the system's most actionable metrics into a fixed reference panel. Market trend, volume momentum, active support and resistance levels, ATR-based volatility, liquidity state, zone strength by merge count, FVG imbalance tallies, zone freshness decay percentage, order flow health, and pending inducement counts are all surfaced simultaneously in a single readable table — recalculated on every bar and available at a glance without any canvas interpretation. This design philosophy treats structural awareness as a continuous state, not a collection of discrete events.
🔬 Methodology and Concepts
● Break of Structure (BOS)
A Break of Structure reflects the continuation of the prevailing structural trend. When price breaks beyond the most recently established swing high in a bullish context, or beneath the most recent swing low in a bearish context, the system recognizes this as confirmation that the dominant directional bias remains intact. BOS events are rendered as dashed lines extending from the origin swing point to the break bar, labeled at midpoint, using the designated bullish or bearish structural color. A BOS signal implies that the market has successfully defended its trend and extended its range — the structural high-water mark has been elevated or the structural low-water mark has been depressed, consistent with ongoing directional order flow.
● Change of Character (CHoCH)
A Change of Character represents a structural inflection — the first significant signal that the prevailing trend may be reversing. When price, having been in a confirmed bearish structure, breaks above the most recent swing high with a confirmed close, the system identifies this as a bullish CHoCH. Conversely, a bearish CHoCH fires when a confirmed close breaks below the last swing low during an established bullish trend. CHoCH events use distinct colors from BOS events, making them visually separable at a glance. The CHoCH is not a reversal confirmation — it is the earliest structural warning that directional control may be shifting, and it is treated as a signal to begin monitoring for continuation evidence or re-entry setups in the new direction.
● Inducement (IDM)
Inducement points capture swing highs and lows that form within an active structural range — specifically, those that appear between the most recent structural high and low without breaking the structure. These intermediate price levels represent liquidity pools: concentrations of stop orders from traders positioned in anticipation of a breakout that has not yet materialized. When price subsequently sweeps through one of these levels, the system marks it with an IDM label at the original swing point. Inducement detection is directionally aware — it tracks both bullish inducement levels (above price in a bearish trend) and bearish inducement levels (below price in a bullish trend), calibrated to the current structural state.
● Liquidity Sweeps
Liquidity sweeps are detected when price extends beyond a confirmed swing point intrabar — printing a wick through the level — but closes back within it on the same bar. This pattern is characteristic of stop-hunt behavior: price momentarily reaches liquidity resting at or beyond the swing level, absorbs it, and reverses without structural commitment. The system marks these events with a water-droplet marker above or below the bar, depending on sweep direction. Sweeps that do not result in a structural break are visually distinct from BOS events precisely because they represent liquidity consumption without directional follow-through — a meaningful distinction for traders evaluating whether a move has genuine momentum or is merely clearing stops before a continuation in the opposite direction.
● Supply and Resistance Zones
When a confirmed swing high is identified, the system generates a resistance zone anchored to that swing. The zone's vertical range captures the price region at and around the high point, scaled to the prevailing market volatility. The zone persists and extends rightward on every subsequent bar, remaining active until price closes above it with confirmation — at which point it becomes invalidated and its visual state updates to reflect the break. Invalidated zones that were broken by multiple simultaneous breaks in the same move receive a distinct luminous treatment, signaling elevated structural significance.
● Demand and Support Zones
Demand zones are generated symmetrically from confirmed swing lows, capturing the price region at and below the swing point, again scaled to volatility. They persist, extend, and interact with price in the same manner as resistance zones — remaining active until a confirmed close breaks below the zone floor. The relationship between an active demand zone and the prevailing structural trend provides context: a demand zone in a bullish structural environment carries higher confluence weight than one forming counter-trend. Zone invalidation updates the visual state without deleting the box, preserving the historical structural map.
● Zone Merging and Consolidation
When a new swing high or low generates a zone that overlaps geometrically with an existing active zone of the same type, the system merges them rather than creating a duplicate. The merged zone's boundaries expand to encompass both the original and incoming zones, and the zone's label updates to display the cumulative merge count alongside a visual strength indicator. This consolidation behavior ensures that price regions tested multiple times — and therefore backed by repeated structural interest — are visually distinguishable from first-touch zones. Traders can optionally extend the merging sensitivity to include zones within a proximity tolerance measured in ATR units, capturing near-misses where zones are close but not perfectly overlapping.
● Time-Decay Zone Aging
Zone opacity is not static. As bars accumulate since a zone's creation, its fill color progressively fades toward transparency following an exponential decay curve. The rate of decay is tuned so that very recent zones are rendered at full intensity, moderately aged zones are partially faded, and old zones become nearly transparent — still visible but clearly subordinate in visual weight to fresh structure. This mechanism creates a natural hierarchy of recency within the zone landscape, allowing traders to prioritize zones that reflect current structural context without manually filtering or deleting historical zones.
● Volume Classification (Recency Ranking)
Every bar that registers a volume reading above the recent comparison window triggers a classification label, rendered at the center of the bar's body. The classification reflects how many bars one must look back to find equivalent or greater volume — a recency-relative ranking of volume significance. The highest tier captures volume that is exceptional even across the full historical lookback, while progressively lower tiers reflect increasingly common volume levels. This classification gives traders an immediate, at-a-glance sense of whether the current surge of participation is truly extraordinary or merely elevated within a recent, narrow window.
● Volume Anomaly Detection (Effort vs. Result)
When a bar registers unusually high volume but produces a disproportionately small price body relative to its total range, the system identifies this as an anomaly. This pattern — high effort, minimal result — is consistent with absorption activity: significant two-sided participation where buyers and sellers are contesting the price level without either side achieving directional conviction. The anomaly is marked with a label positioned above or below the bar depending on its relative close position within the range. Anomaly bars frequently precede reversals or consolidations and serve as high-attention markers within the broader volume narrative.
● Volume-Weighted Fair Value Gaps (VW-FVG)
A fair value gap — a three-bar imbalance where price skips over a price region without two-sided participation — is a well-known structural concept. This system filters gap detection through a volume qualifier: only gaps that form when the initiating bar carries a volume reading that exceeds the peak observed over a user-configurable historical lookback window are marked. This filter dramatically reduces the noise of low-significance gaps and retains only those imbalances formed during demonstrably exceptional participation — periods where the pace of directional conviction was strong enough to leave a measurable inefficiency in price discovery. VW-FVGs are displayed as shaded regions with labeled identifiers, and are automatically removed when subsequent price action fills them completely.
● Higher Timeframe (HTF) Integration
The system supports an optional HTF overlay mode that replaces the chart-timeframe swing detection with swing data sourced from a user-selected higher timeframe. When engaged, all zone generation, structure break classification, and inducement tracking reflect the rhythm and scale of the HTF market rather than the chart timeframe. HTF data is retrieved using a confirmed, offset-based request pattern that eliminates lookahead leakage — the HTF values available at any chart bar reflect only what was knowable at that moment, with no access to intrabar or unclosed HTF data. This makes the HTF integration suitable for both visual analysis and backtested strategy evaluation.
● Composite Alert and Webhook Engine
The alert engine operates on a confirmed-bar guard — no alert is dispatched until the current bar has fully closed. Within that guard, all structural events that occurred during the bar are evaluated: bullish and bearish CHoCH signals, bullish and bearish BOS signals, and zone break events in both directions. Each triggered signal generates an individual alert element containing the signal type (mapped to user-defined webhook action names), entry price, stop loss, and take profit, all formatted to tick precision. If multiple signals are triggered on the same bar, they are accumulated into a single composite JSON dispatch — one webhook call, all events, zero duplication.
● Live SMC Metrics Dashboard
The dashboard is a continuously-updated fixed-position table that consolidates eleven active system metrics into a single always-visible reference panel. It operates independently of the canvas drawings — a trader can assess full structural context without panning or interpreting individual visual elements. The dashboard surfaces the following metrics in real time:
Market Trend reflects the system's current structural classification — bullish, bearish, or neutral — derived from the active sequence of confirmed structure breaks. It updates on every bar in which a structural event is confirmed.
Vol Momentum renders a live block-bar indicator — a proportional fill of ten segments — representing the current bar's volume magnitude relative to the recent session high. The fill level and color shift dynamically with volume intensity, providing an instantaneous visual read of participation pressure without requiring interpretation of histogram bars.
Active Resistance displays the price level of the most recently confirmed swing high tracked by the structural engine, formatted to tick precision. This is the current structural ceiling — the level a bullish break must exceed to register a structural event.
Active Support displays the price level of the most recently confirmed swing low, formatted to tick precision. This is the current structural floor — the level a bearish break must breach to register a structural event.
Volatility (ATR) displays the current 14-period Average True Range formatted to tick precision, providing an at-a-glance reference for position sizing, zone width calibration, and stop placement context.
Liquidity State reflects the most recent zone interaction: whether a resistance zone has been broken bullishly, a support zone has been broken bearishly, or price is ranging within intact zones on both sides. This field updates in real time as zone breaks are registered.
Zone Strength displays the merge count for the closest active support and resistance zones simultaneously — exposing, in a single field, how many times each of the two most structurally proximate zones has absorbed overlapping swings. Higher merge counts indicate zones that have been structurally reinforced across multiple formation events.
FVG Imbalance reports the current count of open bullish and bearish volume-weighted fair value gaps — those that have not yet been filled by subsequent price action. This metric provides immediate context on the directional imbalance landscape remaining on the chart.
Closest Zone Age quantifies the freshness of the nearest active zone using an exponential decay model anchored to bar count since zone formation. The output is expressed as a percentage: values near 100% indicate a very recently formed zone; values approaching zero indicate a zone that has aged substantially. An icon prefix signals the freshness tier at a glance: high freshness, moderate freshness, or aging zone warranting reduced weighting.
Order Flow State reflects the most recent live-bar anomaly assessment: whether the current bar exhibits high-effort, low-result volume behavior characteristic of absorption or contested flow, or whether volume and price movement are consistent with healthy directional participation. This field updates on every tick, providing a real-time order flow reading ahead of bar close.
Pending Liquidity reports the count of inducement levels on each side — support-side and resistance-side — that have been registered within the active structural range but not yet swept. This metric surfaces, at a glance, how many intermediate liquidity pools remain unvisited within the current structural episode.
🎨 Visual Guide
● BOS and CHoCH Dashed Lines
When a Break of Structure or Change of Character is confirmed, a dashed horizontal line extends from the origin swing point across the chart to the break bar. Bullish BOS events use the designated cyan-family color. Bearish BOS events use the designated magenta-family color. Bullish CHoCH events use the designated green-family color. Bearish CHoCH events use the designated orange-red-family color. These lines persist until the garbage collection system removes older drawings as the chart extends, keeping the visual environment clean and contextually relevant.
● BOS and CHoCH Text Labels
A floating text label — reading "BOS" or "CHoCH" — is placed at the horizontal midpoint of the corresponding line, at the price level of the structural break. Labels are rendered with a transparent background so they sit cleanly against the chart background without obscuring price action. The label's text color matches the line color of the associated event, maintaining a one-to-one visual correspondence between label and line.
● Resistance Zone Boxes
Active resistance zones are rendered as filled rectangular boxes extending from the zone's origin bar rightward to the current bar. The fill uses the designated resistance zone color (magenta-family, highly transparent) with no border, creating a soft overlay effect. As zones age, the fill fades progressively toward transparency. When a zone is broken, the fill color remains but the box stops extending — a frozen record of the structural level that once held. Multi-break events trigger a luminous fill update, using the semi-transparent magenta-family luminous color to visually distinguish momentum-backed breaks from isolated ones.
● Support Zone Boxes
Support zones behave identically to resistance zones in structure but use the designated support color (cyan-family, highly transparent). Their fill decays with age, and multi-break events elevate them to the luminous cyan-family treatment. The visual symmetry between support and resistance zones makes the structural landscape immediately readable — cyan below, magenta above.
● Zone Strength Labels
When a zone absorbs an additional overlapping swing and merges, a text label reading "STRONG ⚡ Nx" (where N reflects the cumulative merge count) appears at the zone's center. The label is dynamically repositioned to the current midpoint of the zone as it extends in time. This label is the visual signal that a price region has been revisited and structurally reinforced multiple times — a marker of accumulated zone significance.
● IDM Labels
When an inducement level is swept, a small text label reading "IDM" appears at the price of the original inducement point. Bullish inducements (above price in a bearish structure, taken out by a downside wick) are labeled with a downward-pointing style. Bearish inducements (below price in a bullish structure, taken out by an upside wick) are labeled with an upward-pointing style. The label color is user-configurable in the yellow-family by default, making IDM markers visually distinct from all other system labels.
● Liquidity Sweep Markers
Liquidity sweep events are marked with a water-droplet emoji (💧) positioned just beyond the wick that triggered the sweep. When a bullish wick sweeps above a swing high without closing above it, the marker appears above the bar. When a bearish wick sweeps below a swing low without closing below it, the marker appears below the bar. The color of the marker is blue by default. These markers do not represent trade signals — they represent completed liquidity events and serve as context markers for understanding where stop orders were collected.
● Volume Classification Labels
On every high-volume bar, a single letter appears at the center of the candle body, reflecting the recency-relative significance of that bar's participation level. The text color is user-configurable. The label renders with a transparent background so it sits cleanly inside the candle without obscuring price action. This creates a subtle but continuous volume narrative layered directly onto price structure. The six tiers, from most common to rarest, are:
L — Local : Volume is elevated relative to the most immediate recent bars. Represents the lowest tier of high-volume recognition — notable within a narrow window but not unusual across any broader horizon.
N — Notable : Volume exceeds what has been seen across a moderately wider lookback. Signals a participation level that stands out beyond the immediate session but remains within the range of relatively routine elevated activity.
S — Significant : Volume surpasses a meaningfully extended historical window. Bars at this tier represent genuine participation surges that are uncommon on the instrument, carrying above-average structural weight.
M — Major : Volume is exceptional across a substantial historical range. Bars classified at this tier reflect participation events that are rare in frequency and tend to accompany large directional commitments or major absorption activity.
U — Uncommon : Volume reaches a level not seen across a very deep historical lookback. These bars are structurally significant outliers — episodes of extraordinary participation that frequently align with pivotal structural events or regime transitions.
C — Classic : The rarest classification. Volume at this tier exceeds the full extent of the available historical lookback, representing a participation event of historic magnitude on the instrument within the visible dataset. These bars demand the highest interpretive attention.
● Volume Anomaly Labels
On bars where volume-to-result anomaly conditions are met, a small "A" label appears above or below the candle depending on the bar's closing context. The label uses a downward-pointing style above bearish-leaning anomaly bars and an upward-pointing style below bullish-leaning anomaly bars. The anomaly color defaults to an amber-family tone, making it visually distinct from all other labels. Anomaly markers accumulate only for the most recent elements as governed by the visual limit setting.
● Volume-Weighted FVG Boxes
Fair value gaps that meet the volume threshold are rendered as filled rectangular boxes spanning the gap's price range across the bars of its formation. Bullish VW-FVGs use a configurable semi-transparent fill alongside a directional text label that identifies the gap type in a user-configurable color. Bearish VW-FVGs receive the same treatment with independent fill and text color settings. Borders are suppressed for a clean overlay appearance. Boxes extend rightward as price approaches them and are automatically removed when price fully fills the gap with a confirmed bar.
● SMC Metrics Dashboard Panel
A fixed-position table is anchored to the top-right corner of the chart, displaying eleven labeled rows across two columns — a metric name column and a live value column. The table background and text colors are fully user-configurable. Metric values update on every bar, with color-coded value fields that shift dynamically to reflect the current state: structural direction, volume intensity, zone freshness tier, and order flow health are each rendered in contextually appropriate colors, making the dashboard readable at a glance without requiring active interpretation. The Vol Momentum row renders a ten-segment block bar that fills proportionally to the current volume ratio, with the fill color shifting from gray through yellow to bright green as volume intensity increases. Zone freshness uses an icon prefix system — a timer icon for high-freshness zones, a balance icon for moderate aging, and a caution icon for significantly aged zones — paired with a numeric percentage that quantifies decay precisely. Pending liquidity counts are rendered with a magnet icon prefix to distinguish them from numeric zone or imbalance counts.
📌 Important note : the best way to resolve visual overlap is to navigate to the Object Tree and drag the indicator above the main chart layer, or simply hide the native candles in your chart settings.
📖 How to Use
● Initial Configuration
Begin by selecting a standard candlestick chart. The system will refuse to load on Heikin Ashi, Renko, Line Break, Kagi, Point & Figure, or Range charts — a deliberate safeguard against synthetic price data distorting structural analysis. Once on a valid chart type, open the settings panel and begin with the Market Structure group. Set the Left Bars and Right Bars values according to the chart timeframe: lower values on lower timeframes capture faster structure; higher values on higher timeframes capture slower, more significant swings.
● Reading Market Structure
Focus first on the BOS and CHoCH labels. A sequence of BOS labels in a single direction confirms trend continuation. The appearance of a CHoCH label is the first structural signal that directional control may be shifting. Do not treat a CHoCH as an immediate reversal entry — treat it as a change in the structural narrative that warrants attention and monitoring. A BOS in the new direction following a CHoCH provides the structural confirmation that the reversal has structural grounding.
● Interpreting Zones
Active zones (those that have not yet been broken and are still extending) represent the most structurally relevant supply and demand regions on the chart. Prioritize fresh zones — those rendered at full color intensity — over faded, aged zones. Multi-merge zones (those displaying the "STRONG ⚡" label) represent price regions that have absorbed multiple swing formations and may carry greater gravitational weight as price approaches them. When price enters an active zone in confluence with a BOS or CHoCH, the structural and zone signals reinforce each other.
● Combining Volume Context with Structure
Use the volume classification labels to assess the quality of structural breaks. A BOS occurring on a bar labeled "L" (local high volume) carries less conviction than one occurring on a bar labeled "C" (classic, long-run exceptional volume). Anomaly bars appearing inside or near active zones suggest contested participation — a potential sign that smart money is absorbing or distributing within the zone rather than breaking through it. VW-FVGs appearing between a CHoCH bar and the current price serve as potential re-entry zones if price returns to fill them.
● Monitoring Inducement and Sweeps
Track IDM labels to identify completed liquidity hunts within the active structural range. A sweep (💧) that takes an IDM level without structural follow-through is consistent with a classic stop-hunt pattern: the market collected liquidity from traders positioned at the inducement level but did not commit structurally. Subsequent structure breaks in the sweep direction after such events carry additional context — the opposing liquidity has been cleared, potentially clearing the path for a sustained move.
● Using the Dashboard for Rapid Situational Assessment
Before reading the canvas, consult the dashboard panel in the top-right corner. The Market Trend field establishes the current structural bias immediately. The Active Resistance and Active Support fields identify the precise price levels that define the structural range. Zone Strength reveals whether the nearest zones are first-touch or multiply-reinforced. FVG Imbalance surfaces directional imbalance exposure remaining on the chart. Closest Zone Age flags whether the structural context is fresh or aged — and by how much. Pending Liquidity shows how many intermediate stop-order pools remain unvisited within the current structural episode. The Vol Momentum bar and Order Flow State together provide a live read on participation character without waiting for a bar to close. Used together, these eleven metrics reduce the canvas interpretation workload to a confirmation exercise rather than a discovery process.
● HTF Integration Workflow
Enable the Higher Timeframe overlay when seeking alignment between the chart timeframe and a structurally dominant higher timeframe. For example, on a 15-minute chart with the HTF set to the 4-hour timeframe, the zones, BOS, and CHoCH labels will all reflect 4-hour structural events. This allows traders to identify when a 15-minute BOS aligns with a 4-hour supply zone interaction — a multi-timeframe confluence signal. The HTF pivot detection, zone generation, and structure classification all operate on confirmed higher-timeframe data with no lookahead leakage.
● Configuring Alerts and Webhooks
In the Webhook Action Names settings group, customize the action string for each signal type to match the expected field values of the execution bridge or automation platform receiving the alerts. Once configured, create a TradingView alert on the indicator and paste the webhook URL. The system will dispatch a single composite JSON message on each confirmed bar that contains any structural event, with all signals bundled into a signals array. Each signal object contains the action name, entry price, stop loss, and take profit, formatted for immediate programmatic consumption.
⚙️ Inputs and Settings
● Market Structure
Enable Higher Timeframe (HTF) — Activates the use of a user-selected higher timeframe for all swing detection, zone generation, and structural classification. When enabled, the chart-timeframe swing data is replaced by HTF-derived confirmed data.
HTF Resolution — Specifies the higher timeframe from which swing and ATR data are sourced. Only active when HTF mode is enabled. Accepts any valid TradingView timeframe string.
Left Bars — Defines the number of bars to the left of a candidate swing point required for confirmation. Higher values produce fewer, more significant swings. Minimum value is 1.
Right Bars — Defines the number of bars to the right of a candidate swing point required for confirmation. Higher values introduce more lookback delay before a swing is recognized. Minimum value is 1.
Risk/Reward Ratio — Governs the take profit distance relative to the stop loss distance for all alert signal types. A value of 2.0 means the take profit is placed at twice the distance from entry as the stop loss.
● Inducement Detection
Enable Inducement Detection — Activates the tracking and labeling of inducement points within the active structural range. When enabled, the system monitors for structural swings that form within the current high-low range and marks them when broken.
● Zone Merging
Enable Zone Merging — When active, overlapping zones of the same type are consolidated into a single expanded zone rather than rendered as separate boxes. Merged zones display a strength count label.
Allow Proximity Merging — Extends the merging logic to capture zones that are near but not perfectly overlapping, using a tolerance defined in ATR units. Only active when zone merging is enabled.
Proximity Tolerance (ATR) — Sets the ATR-based tolerance within which near-miss zones are treated as mergeable. A value of 0.5 means zones within half an ATR of each other will merge. Only active when both merging and proximity merging are enabled.
● Visuals
Max Visible Elements (Boxes/Lines) — Controls the maximum number of zones, BOS lines, labels, and other drawn elements retained on the chart at any time. Older elements are removed as new ones are added. Range: 1 to 100.
● Advanced Quant Features
1. Show Volume Anomalies (Effort vs Result) — Enables the detection and labeling of bars where volume is disproportionately high relative to the price result (small body relative to total range). These bars are marked with an "A" label.
2. Show Volume-Weighted FVG only — When enabled, fair value gaps are only marked when the middle bar of the three-bar formation registers a volume reading exceeding the peak observed over the configurable FVG Volume Lookback window. Low-conviction gaps are suppressed.
FVG Volume Lookback (bars) — Sets the historical window used to determine the volume peak threshold for VW-FVG qualification. A gap's initiating bar must exceed the highest volume recorded over this number of prior bars to be marked. Only active when VW-FVG mode is enabled. Range: 1 to 500.
3. Time-Decay Zone Aging (Fade over time) — Activates the exponential opacity decay for active zones. When enabled, zone fill transparency progressively increases with age, creating a visual freshness hierarchy.
4. Track Liquidity Sweeps (Wicks 💧) — Enables the detection and marking of wicks that penetrate swing levels without closing through them. Confirmed sweep events are marked with a water-droplet emoji at the wick extreme.
● Color
BOS Bullish — Color for bullish Break of Structure lines and labels. Default: cyan family.
BOS Bearish — Color for bearish Break of Structure lines and labels. Default: magenta family.
CHoCH Bullish — Color for bullish Change of Character lines and labels. Default: green family.
CHoCH Bearish — Color for bearish Change of Character lines and labels. Default: orange-red family.
Inducement Label Color — Color for IDM labels marking broken inducement levels. Default: yellow family.
Support Zone Fill — Fill color for active support zones. Default: semi-transparent cyan family.
Resistance Zone Fill — Fill color for active resistance zones. Default: semi-transparent magenta family.
Luminous Support (Multi-Break) — Fill color applied to support zones broken by multiple simultaneous break events. Default: moderately transparent cyan family.
Luminous Resistance (Multi-Break) — Fill color applied to resistance zones broken by multiple simultaneous break events. Default: moderately transparent magenta family.
Volume Text Color — Color of the volume classification letters rendered inside candle bodies. Default: white.
Anomaly Label Color — Color of the "A" label marking effort-versus-result anomaly bars. Default: amber family. Only active when anomaly detection is enabled.
Bullish VW-FVG — Fill color for bullish volume-weighted fair value gap boxes. Default: semi-transparent yellow family. Only active when VW-FVG mode is enabled.
Bearish VW-FVG — Fill color for bearish volume-weighted fair value gap boxes. Default: semi-transparent yellow family. Only active when VW-FVG mode is enabled.
Bullish FVG Text — Text color for the label identifying bullish VW-FVG regions on the chart. Default: green family. Only active when VW-FVG mode is enabled.
Bearish FVG Text — Text color for the label identifying bearish VW-FVG regions on the chart. Default: red family. Only active when VW-FVG mode is enabled.
● 📊 Dashboard Settings
Table Background — Sets the background color of the SMC Metrics dashboard panel. Supports transparency adjustment. Default: near-black with slight transparency.
Table Text — Sets the default text color used for metric labels in the left column of the dashboard. Metric value colors in the right column are system-determined and update dynamically based on state. Default: white.
● Webhook Action Names
Long Action — The action string injected into alert payloads for long entry signals (CHoCH bullish and BOS bullish). Default: "long".
Short Action — The action string injected into alert payloads for short entry signals (CHoCH bearish and BOS bearish). Default: "short".
Close Long Action — The action string injected into payloads when a bearish CHoCH triggers a position close on the long side. Default: "closelong".
Close Short Action — The action string injected into payloads when a bullish CHoCH triggers a position close on the short side. Default: "closeshort".
Zone Break Long — The action string injected into payloads when a resistance zone is broken bullishly. Default: "long".
Zone Break Short — The action string injected into payloads when a support zone is broken bearishly. Default: "short".
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Market Microstructure Theory and Structural Breaks
The BOS and CHoCH framework draws its conceptual foundation from market microstructure theory, particularly the work of researchers such as Albert Kyle (1985) and Lawrence Glosten and Paul Milgrom (1985), who formalized the relationship between informed trading, order flow, and price discovery. Within this theoretical tradition, a confirmed structural break — where price closes beyond a prior swing extreme — is interpreted as an event where directional order flow has overwhelmed the liquidity depth at that level, revealing the presence of informed participants. The distinction between a BOS (trend continuation) and a CHoCH (structural inflection) maps conceptually onto the microstructure literature's differentiation between liquidity provision aligned with trend and the emergence of counter-directional informed flow sufficient to shift the equilibrium price region.
● Demand and Supply Zone Theory and the Order Flow Imbalance Framework
The zone generation and management framework within this system reflects the theoretical construct of order flow imbalance, explored extensively in the market impact literature following Bertsimas and Lo (1998) and Torre and Ferrari (1997). Swing-derived supply and demand zones are interpreted as price regions where a significant directional imbalance occurred — areas where one side of the market (buyers or sellers) overwhelmed the available opposing liquidity with enough force to produce a structural swing. These regions are treated as potential future order fill zones: areas where unfilled large orders may remain resting, providing a gravitational pull on future price revisits. The time-decay mechanism is consistent with the empirical observation that order imbalances decay in relevance as market conditions evolve and new information arrives.
● Liquidity Theory and the Engineering of Sweep Events
The liquidity sweep detection framework is grounded in the theoretical tradition of liquidity engineering, most recently formalized within the smart money concept literature, which draws on Wyckoff's accumulation and distribution schematics (1908–1934) as well as modern adaptations by researchers studying block trading behavior. The premise is that stop orders accumulate predictably at swing highs and lows — structural price levels where retail participants conventionally place protective stops. Large participants with sufficient order size may find it advantageous to momentarily extend price to these levels to access the stop-order liquidity, fill large positions at favorable prices, and then allow or facilitate a reversal. The wick-without-close pattern detected by this system is a canonical signature of this behavior.
● Inducement and Liquidity Pool Theory
Inducement detection formalizes the concept of intermediate liquidity targets — price levels within an active structural range that represent logical stop clusters for participants positioned in the direction of the broken level. This concept aligns with order flow research on layered liquidity — the idea that market depth is not uniform but structured, with concentrations of resting orders at predictable structural intervals. When price breaks an inducement level, it has consumed a subset of the total liquidity available within the structural range, potentially clearing the path for a more significant structural move. The IDM label system surfaces these events as they occur, giving traders a real-time record of which liquidity layers have been consumed within the current structural episode. The Pending Liquidity dashboard metric extends this concept into a continuous, enumerated readout — making the count of remaining unswept inducement pools immediately visible without requiring canvas inspection.
● Volume Analysis: Effort vs. Result and Absorption Theory
The anomaly detection framework draws from Richard Wyckoff's Effort vs. Result principle and its quantitative descendants in volume spread analysis (VSA), developed by Tom Williams and later formalized by researchers in the market microstructure field. The core premise is that high volume accompanied by a narrow price range (small body relative to total wick) indicates contested two-sided activity — a condition consistent with absorption, where one side of the market is absorbing the aggressive orders of the other without allowing price to advance. This pattern frequently appears at structural turning points, supply zones, and distribution tops or accumulation bottoms, making it a high-attention marker within the broader volume narrative. The Order Flow State dashboard field operationalizes this detection as a continuous live read — extending anomaly awareness beyond completed historical bars to the forming bar in real time.
● Volume Recency Classification and Relative Strength of Participation
The volume classification system reflects the academic literature on relative volume analysis, including work by Ane and Geman (2000) on the relationship between trading volume, information arrival, and price volatility. The classification's recency-relative ranking approach — measuring how far back in time one must look to find equivalent volume — operationalizes the concept of "volume significance in context": a large volume reading on a historically quiet asset differs materially from the same reading on a highly active one. By anchoring the classification to a dynamic lookback rather than a fixed threshold, the system adapts naturally to regime changes in market participation levels. The Vol Momentum dashboard display complements this by rendering volume intensity as a proportional visual meter — translating the abstract recency ranking into an immediately perceivable graphical readout.
● Fair Value Gap Theory and Market Efficiency Deviations
Fair value gaps occupy a conceptual intersection between technical analysis and market efficiency research. The efficient market hypothesis in its semi-strong form (Fama, 1970) posits that price instantaneously reflects all publicly available information. However, empirical research — including the intraday momentum literature (Gao, Han, Li, and Zhou, 2018) and the order flow imbalance research of Cont, Kukanov, and Stoikov (2014) — documents recurring short-horizon price inefficiencies where the speed of information arrival temporarily exceeds the market's ability to provide two-sided liquidity. A fair value gap is a visible manifestation of this temporary imbalance: a three-bar sequence where price moves so directionally that no transacted price exists within a contiguous range, leaving an unfilled region that may act as a subsequent attractor as the market attempts to restore efficiency. The configurable volume filter applied by this system ensures that only gaps formed under conditions of genuinely exceptional participation — rather than low-liquidity drifts — are treated as structurally significant inefficiencies. The FVG Imbalance dashboard metric aggregates the current count of open gaps by direction, providing an instantaneous summary of the residual imbalance exposure on the chart.
● Zone Freshness, Exponential Decay, and Temporal Relevance Weighting
The Closest Zone Age metric in the dashboard is grounded in the theoretical principle of information decay in financial markets — the observation that the informational relevance of a price event diminishes as time elapses and new market conditions supersede it. This principle is formalized in the econophysics literature on market memory (Mandelbrot, 1963; Lo, 1991) and operationalized here through an exponential decay model that quantifies zone freshness as a percentage of original relevance. The exponential form is consistent with empirical observations of how market participants' collective memory of prior price events fades over time — rapidly at first, then more slowly as the residual structural significance stabilizes. Zones that have decayed significantly are not deleted — they remain as historical structural references — but their freshness percentage communicates to the trader that the zone's informational content has diminished relative to more recently formed structure.
● Composite Alert Architecture and Signal Aggregation Theory
The composite alert dispatch architecture reflects principles from systems design and event-driven architecture, where signal aggregation and single-emission patterns are preferred over fragmented, multi-emission approaches to reduce latency, prevent duplication, and ensure atomic delivery of correlated events. In the context of automated trading, fragmented alert dispatch creates race conditions in execution bridges: if a CHoCH and a zone break occur simultaneously and fire as separate alerts, the execution engine may process them out of sequence or duplicate the resulting order. The composite JSON emission pattern resolves this by treating all bar-close structural events as a single atomic unit, dispatched once, in deterministic order.
● Dashboard Panel Design and Situational Awareness Theory
The SMC Metrics dashboard reflects principles drawn from the human factors and situational awareness literature, most notably Mica Endsley's three-level model of situational awareness (1988, 1995): perception of elements in the environment, comprehension of their meaning, and projection of future states. A fragmented multi-indicator setup imposes high cognitive load at the perception and comprehension stages — the trader must locate, read, and reconcile signals across multiple panels before reaching any comprehension of the structural state. The fixed-position consolidated dashboard collapses the perception stage to a single visual anchor, reducing comprehension latency and freeing cognitive resources for the higher-order task of structural projection and decision-making. The color-coded dynamic value fields further reduce interpretation burden by encoding state change as a pre-attentive visual attribute, consistent with research by Healey and Enns (2012) on the role of pre-attentive processing in data visualization.
⚠️ Disclaimer
This indicator is provided for educational and informational purposes only. It does not constitute financial advice, investment advice, or a recommendation to buy or sell any financial instrument. All outputs — including structural labels, zone markings, volume classifications, anomaly markers, fair value gap indicators, dashboard metrics, and alert signals — are analytical tools intended to support the trader's own independent research and decision-making process. Past performance of any pattern, signal, or structural concept identified by this indicator does not guarantee future results. Trading financial markets involves substantial risk of loss, and all trading decisions are made solely at the trader's own risk. We disclaim all liability for any losses, damages, or adverse outcomes arising directly or indirectly from the use of this indicator or any signals derived from it. Users are solely responsible for ensuring that their use of this indicator complies with all applicable laws and regulations in their jurisdiction. Trendline Breakouts Targets Pro [MarkitTick] 💡 The Trendline Breakouts Targets Pro is a comprehensive and advanced technical analysis framework designed to automate the process of trendline projection and trade management. By allowing traders to define specific temporal anchor points, the algorithm calculates precise trajectories and actively monitors price action for structural breakouts. It removes the ambiguity often associated with manual charting by establishing strict mathematical rules for trendlines, while offering a robust suite of validation filters and dynamic profit-taking mechanisms. This tool bridges the gap between static chart drawings and active, real-time algorithmic execution monitoring.
This is the professional version of the free indicator Trend Break Targets
✨ Originality and Utility
This script distinguishes itself from standard drawing tools by transforming a static concept into a reactive, multi-stage trade management system.
Automated Extrapolation: Traders simply input two specific dates, and the indicator mathematically plots the exact trendline based on confirmed historical extremes, ensuring absolute objectivity.
Progressive Targeting Protocol: Instead of relying on fixed reward zones, the indicator recalculates its Stop Loss and Take Profit levels dynamically as the market successfully breaches consecutive target thresholds.
Multi-Tiered Authentication: It prevents premature entries by requiring strict confluence. Users can mandate up to six independent technical confirmations—ranging from Volume surges to RSI thresholds—before a breakout is deemed valid.
Comprehensive Risk Visualization: The script generates clean, translucent boxes directly on the chart, allowing traders to instantly visualize their exact risk-to-reward parameters without requiring external measurement tools.
🔬 Methodology and Concepts
● Algorithmic Trendline Construction
The foundational logic relies on the precise detection of local market extremes. The algorithm scans historical data surrounding the user-defined Start and End dates to locate mathematical Pivot Highs or Pivot Lows. Once these primary anchors are established, the script calculates the slope—the exact rate of price change over time—and projects a linear equation into the future to serve as the breakout threshold.
● Multi-Domain Validation Engine
A structural break of the trendline is necessary but not sufficient for a signal. The engine requires secondary confirmations:
Volume SMA: Ensures the breakout candle demonstrates elevated participation by comparing its volume to a defined Simple Moving Average.
Structural CHOCH: Validates that the broader market structure has shifted by confirming a break of the most recent swing high or low.
Momentum Filtering: Utilizes the Relative Strength Index (RSI) and MACD crossovers to ensure sufficient momentum is backing the directional move.
● Fibonacci-Scaled Target Mechanics
The framework calculates an initial Base Distance, representing the vertical span between the breakout price and the nearest logical pivot point. Subsequent profit targets are derived via geometric multipliers:
Target 1 reflects a standard 1:1 projection of the established Base Distance.
Target 2 is mathematically derived using the 1.618 golden ratio extension.
Target 3 maps extreme exhaustion points using the 2.618 sequence multiplier.
🎨 Visual Guide
● Core Chart Elements
Anchor Point Labels (1 & 2): Clearly display the historical origin coordinates used to construct the primary trend trajectory.
Dynamic Trendline: The central diagonal axis extending continuously from the anchor points across the right side of the chart.
Swing Point Nodes: Highly visible circular plots that track recent Pivot Highs and Pivot Lows, giving traders immediate context on local market structure.
Breakout Alerts: Distinct directional labels that populate exactly on the candle that breaches the line and satisfies all active confirmation filters.
● Trade Management Zones
Profit Target Boxes: Translucent graphical regions that illustrate the active take-profit zones based on current trade progression.
Stop Loss Boxes: Contrasting shaded areas displaying the active risk threshold, recalculating automatically as targets are reached.
Embedded Value Markers: Exact numerical price quotes printed adjacent to the visual boxes to eliminate guesswork during order placement.
📖 How to Use
Establish the Origin Coordinates: Access the primary configuration menu and set the Start Date (Point 1) and End Date (Point 2) corresponding to the structural highs or lows of the trend you are monitoring.
Calibrate Validation Sensitivity: Toggle mandatory condition filters such as Volume Spikes, SMA positioning, or RSI limits to match the volatility of your chosen asset.
Await Algorithmic Confirmation: Monitor the chart until the system prints a validated Breakout or Breakdown marker. This signifies that the slope has been breached with full technical confluence.
Execute and Manage: Utilize the drawn Profit and Loss boxes to structure your orders. As price achieves Target 1, observe the automated shifting of the Stop Loss zone to secure capital, and adjust your trailing stops accordingly.
⚙️ Inputs and Settings
● Temporal Configuration
Start Date / End Date: The precise timestamps defining the baseline anchors for trend projection.
Pivot Left / Right Lengths: Dictates the strictness of structural extreme detection; higher values demand greater isolation for a candle to be categorized as a pivot.
Fallback Lookback: A safety mechanism defining how many bars to scan for an extreme if a standard pivot is not immediately present.
Target Extend Bars: Controls the horizontal visual length of the generated target and stop-loss boxes.
● Filter Toggles
Require Volume Confirmation: Activates the volume SMA prerequisite.
Require CHOCH / Swing Break: Enforces a fundamental shift in local market structure before signaling.
Require MACD / SMA / RSI: Toggles standard momentum and moving average positioning filters.
● Aesthetic Customization
Color Modules: Independent color selection for trendlines, breakout markers, target zones, and stop-loss regions.
Display Overrides: Master switches to toggle visibility for secondary targets, all static targets simultaneously, or historical swing points to maintain a decluttered workspace.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Linear Interpolation in Time-Series Data
At its mathematical core, the indicator relies on linear extrapolation to project localized price action into future periods. By calculating the differential in price over the specific time elapsed between Point 1 and Point 2, the algorithm deduces a constant rate of change (the slope). This slope is incrementally multiplied by the progressing bar index to continuously update the exact dynamic threshold required for a valid breakout.
● Calculus-Based Local Extrema Detection
The proprietary pivot detection system acts as an algorithmic representation of local maxima and minima found in differential calculus. It utilizes a comparative scanning array to determine if a candidate data point holds the absolute highest or lowest value relative to a strictly defined, symmetrical subset of neighboring values. This isolates true structural shifts from standard market noise.
● Proportional Geometric Scaling
Target generation applies the mathematical principles of the Fibonacci sequence—specifically the 1.618 and 2.618 ratios—to financial time-series modeling. By calculating the initial Base Distance between the breakout threshold and the closest structural extreme, the script employs these golden ratios to systematically estimate future points of momentum exhaustion and liquidity resting areas.
● Multivariate Boolean Logic Matrices
The confirmation engine operates as a complex Boolean logic gate system. In order to switch the execution state from passive to triggered, it requires a simultaneous intersection of multiple independent variables. This logical AND operation effectively cross-references volume behavior, structural hierarchy, and momentum oscillators, functioning as a strict probabilistic filter designed to minimize Type I errors (false positives) in breakout trading.
● 🔓 vs 🔒 (Pro vs. Free)
● Logic & Signal Generation
• Free: Relies on localized, static price-action crossovers (close > trendline) to define a breakout. It uses isolated pivot calculations and Fibonacci constants (1.618, 2.618) to project targets statically without forward-looking validation.
• Pro: Introduces a robust Multi-Factor Confluence Engine. Breakout triggers are strictly gated behind mandatory, user-configurable boolean arrays including Volume confirmation (SMA crossover), momentum (MACD crosses, RSI thresholds), trend filters (SMA positioning), and structural validation (CHOCH and strict Swing Breaks). This severely minimizes false positives (whipsaws) and ensures high-probability market entries.
● Trade Management Architecture
• Free: Fire-and-forget logic. Once a line is broken, standard targets are drawn instantly without ongoing state tracking.
• Pro: Employs a sophisticated State-Machine architecture (tradeStage tracking). The algorithm tracks active positions dynamically through stages (Aiming for T1, Aiming for T2, etc.), progressively recalculating and adjusting active conditions. This enables dynamic progressive visuals where profit and loss boxes physically update on the chart chart based on the real-time lifecycle of the trade.
● Risk Management & Capital Preservation
• Free: Lacks native Stop-Loss (SL) computation. Focuses entirely on Take-Profit (TP) zones, leaving risk management up to the discretionary trader.
• Pro: Integrates a highly quantitative Risk Management Module. Calculates precise Stop-Loss levels natively tied to dynamic baseline distances (e.g., maintaining specific risk-to-reward ratios like setting SL distance at exactly 1/3 of the target distance). As the trade progresses through higher stages, the SL structure dynamically adjusts to lock in equity and manage downside risk systematically.
● Algorithmic Execution & Automation
• Free: A purely visual tool with no internal alert framework or payload generation.
• Pro: Built for automated execution. The Pro build features a strict JSON Alert Engine evaluating exclusively on barstate.isconfirmed. It dynamically constructs JSON payloads passing the ticker, timeframe, trade side, precise entry, dynamic TP, and progressive SL values directly to external webhooks, algorithmic bridges, or proprietary execution bots.
● Memory Management & Execution Efficiency
• Free: Standard historical buffer handling, suitable for everyday retail charting.
• Pro: Implements strict compile-time optimizations and max_bars_back overrides for high, low, and close arrays. This prevents buffer limit runtime errors when the indicator is scanning deep historical datasets for algorithmic backtesting, ensuring seamless performance across extensive quantitative studies.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Sloped LinReg Volume Profile Pro [MarkitTick] 💡 Most volume profile tools treat price and volume as if the market moves sideways — a flat slab of data anchored to fixed horizontal levels. Markets do not move sideways. They trend, rotate, and expand along a directional axis, and any volume distribution that ignores that axis is measuring the wrong thing. The Sloped LinReg Volume Profile Pro was built to resolve this fundamental mismatch. It anchors the entire volume distribution study to a dynamic, slope-corrected linear regression channel, so that every price level, every volume row, every key structural marker is expressed not in raw price terms but in deviation terms relative to the regression midline. The result is a volume profile that breathes with the trend — one that exposes where volume actually clusters relative to the market's directional trajectory, rather than where it happens to sit on a static price ladder. Combined with a suite of smart money detection modules, an anchored VWAP engine, multi-mode start-point logic, and a live ten-row analytics dashboard, this indicator gives traders a unified, structurally-aware view of price, volume, and order-flow activity that no flat-profile tool can replicate.
✨ Originality and Utility
● Slope-Corrected Volume Distribution
The defining innovation of this indicator is the projection of all volume data onto the axis of a linear regression channel rather than a fixed horizontal price grid. Every volume row, every deviation band, every structural marker is offset from the regression midline in proportion to the channel's slope. This means the profile itself tilts with the trend — a rising market's profile tilts upward, a falling market's profile tilts downward, and a sideways market's profile sits flat. Traders using conventional horizontal profiles are comparing volume to where price has been, not to where price is trending. This indicator compares volume to where price should be given its current directional momentum, which is a structurally superior reference.
● Intelligent Start-Point Architecture
Rather than forcing the user to manually anchor the profile, this indicator provides five distinct start-point detection modes, each targeting a different type of market context. Traders can anchor the profile to the most recent significant swing, to the opening of a named trading session, to the most recent volume spike, to the most recent ATR-explosive bar, or to the open of a higher-timeframe candle. Each mode is independently parameterised and operates on confirmed bar data, ensuring that the selected anchor is structurally meaningful rather than arbitrary.
● Smart Money Detection Layer
Three discrete order-flow analysis modules — Inducement Detection, Liquidity Sweep Detection, and Volume Anomaly Detection — operate in parallel with the volume profile and render their findings directly on the chart within the active channel window. Each module is independently toggleable. Their collective output allows traders to identify the moments when price interacts with liquidity pools in ways that deviate from ordinary flow, surfacing the footprints that precede significant directional moves.
● Unified Analytics Dashboard
A live ten-row heads-up dashboard consolidates all indicator outputs into a single, always-visible panel. The dashboard eliminates the need to read the chart and interpret multiple overlapping visuals simultaneously — every critical metric is expressed in plain text, color-coded by reading, and updated on every bar.
🔬 Methodology and Concepts
● Linear Regression Channel
The backbone of the entire indicator is a linear regression channel fitted to the user-selected price source over the active lookback window. The channel consists of a midline — representing the best-fit directional trend — and upper and lower deviation bands that bracket price activity on either side. The slope of the midline defines the directional axis of the profile. All volume distribution rows, POC markers, Value Area boundaries, and gradient clouds are expressed as deviations from this midline, not as absolute price levels. This makes the structural readings consistent across different trending conditions.
● Deviation Bands and Channel Boundaries
The upper and lower channel boundaries can be set to track either the maximum price excursion observed within the window (raw deviation mode) or a user-defined multiple of the channel's internal standard deviation (statistical deviation mode). The standard deviation mode produces bands that represent statistically expected price range, making readings above the upper band or below the lower band interpretable as overextended conditions. The maximum excursion mode captures the literal extremes the market has tested, which is useful for identifying the outer boundaries of accepted price range.
● Sloped Volume Profile Rows
The volume profile is constructed by dividing the channel's deviation range into a user-defined number of equally-spaced horizontal rows, each expressed as a deviation offset from the regression midline. Volume is allocated to rows based on the proportion of each bar's range that overlaps with each row's deviation band. This allocation is proportional — bars with large ranges distribute volume across many rows, while bars with narrow ranges concentrate volume in fewer rows. The result is a distribution map of where volume has clustered relative to the channel's directional axis.
● RSI Volume Filter — Liquidity Isolation
An optional RSI-based filter allows traders to restrict which bars contribute volume to the profile. In Extremes mode, only bars where the RSI reading is in overbought or oversold territory contribute — isolating the volume traded at exhaustion points. In Trend Confluence mode, only bars where the RSI reading aligns directionally with the channel slope contribute — isolating volume traded in the direction of the prevailing trend. This filter transforms the profile from a raw distribution map into a targeted map of either exhaustion-point liquidity or trend-aligned accumulation.
● Point of Control (POC)
The POC identifies the deviation row that has attracted more volume than any other row within the active channel window. It represents the price level — expressed as an offset from the regression midline — at which the market has spent the most transactional energy during the profile period. The POC is the market's revealed consensus on value within the current trend structure. Price repeatedly returning to the POC indicates sustained agreement; price migrating away from the POC indicates a shift in perceived value.
● Value Area — VAH and VAL
The Value Area captures the contiguous band of deviation rows that together account for a user-defined percentage of total profile volume, by default seventy percent. The Value Area High marks the upper boundary of this band; the Value Area Low marks the lower boundary. Price trading within the Value Area is operating within the zone of highest transactional agreement for the current trend phase. Price trading above the VAH or below the VAL is operating in territory where significantly less volume has changed hands — conditions that often precede either a return to value or an acceleration away from it.
● Profile Extremes
The extremes markers identify the outermost deviation rows reached during the profile window — the highest high deviation and the lowest low deviation recorded relative to the regression midline. These extremes define the absolute outer range of the market's accepted price territory during the current trend phase and serve as reference levels for assessing how far price has extended relative to the trend's historical range.
● Institutional Footprint Detection
Bars where volume deviates significantly above the statistical norm — specifically those exceeding a threshold derived from the distribution's mean and standard deviation — are identified as institutional footprints. These are bars where transaction volume is anomalously elevated relative to surrounding activity, suggesting the participation of large-order flow. The rows in the profile corresponding to these bars receive a distinct visual treatment to signal their disproportionate weight in the volume distribution.
● Volume Anomaly Detection
Volume anomalies are bars that simultaneously satisfy two conditions: volume is substantially elevated relative to recent history, and the bar's body-to-range ratio is below a user-defined threshold. This combination — high volume, wide range, small close-to-open movement — indicates that large two-sided activity occurred on the bar without producing a directional result. These bars are characteristic of absorption or high-intensity indecision and often mark pivotal moments where the dominant order flow is being tested or countered.
● Inducement (IDM) Detection
Inducement tracking monitors confirmed swing highs and swing lows within the active channel window and flags them as potential liquidity pools that price may return to sweep. An unbroken inducement level represents a standing pool of resting orders — stops, limit entries, or triggered liquidations — that the market has not yet absorbed. The dashboard counter surfaces how many unbroken inducement levels are currently active within the channel, giving traders a real-time read on the density of pending liquidity.
● 💧 Liquidity Sweep Detection
A liquidity sweep is identified when the prior bar's high or low penetrates the corresponding deviation band of the regression channel and the bar closes back inside it. This pattern — wick extension beyond the band followed by a close within it — is characteristic of stop-run behaviour: price reaching into a liquidity pool, triggering resting orders, and then reversing. Each sweep event is marked at its exact bar within the active channel window.
● Anchored VWAP
The Anchored VWAP is calculated from the channel's start point forward, weighting each bar's typical price by its volume. The anchored VWAP represents the average price paid per unit of volume since the anchor event, making it the volume-weighted cost basis for all activity within the current profile window. Its value is surfaced on the dashboard as a reference for assessing whether current price is trading at a premium or discount to the volume-weighted mean of the trend phase.
● Volume Compression Score
The Volume Compression Score measures how tightly the Value Area is concentrated relative to the total profile range. A high compression reading indicates that a disproportionately large share of total volume has traded within a narrow band of the channel — a condition associated with coiled energy, low-volatility consolidation, and potential for explosive moves. A low compression reading indicates that volume is broadly distributed across the channel range, reflecting a more diffuse, less directionally committed market structure.
● Channel Position Oscillator
The Channel Position Oscillator measures where the current close sits within the live channel, expressed as a percentage from the lower band to the upper band. A reading near one hundred percent indicates price is pressing the upper boundary; a reading near zero percent indicates price is pressing the lower boundary; a reading near fifty percent indicates price is centered on the midline. This oscillator transforms the channel's visual spatial information into a continuous numerical readout that can be assessed at a glance on the dashboard.
● LinReg Slope — Trend Direction Readout
The slope of the regression channel is evaluated for sign and magnitude to produce a binary trend direction label on the dashboard: bullish when the channel is rising, bearish when it is falling. The slope is derived from the full set of bars within the active channel window and reflects the aggregate directional bias of price over that period.
● Price Regime Classification
The Price Regime row on the dashboard classifies current price location relative to the channel's deviation bands into three states: inside the channel (balanced), above the upper band (overextended to the upside), or below the lower band (overextended to the downside). This classification is a live read on whether the market is operating within its established range or has broken into territory that historically resolves through reversion or acceleration.
● End-Point Control Modes
The profile's right boundary can be managed through five distinct modes: pinned to the current live bar for continuous updating, pinned to the last confirmed closed bar for a static view, auto-reset upon a channel breakout, extended forward by a user-defined number of bars for projection, or terminated at the POC-break event. Each mode changes the temporal scope of the profile, making the indicator adaptable to different trading workflows from live monitoring to forward scenario analysis.
🎨 Visual Guide
● Regression Channel Lines
Three parallel lines form the channel structure: the midline traces the regression best-fit, while the upper and lower deviation lines bracket the accepted price range. All three lines tilt with the channel's slope. Their color is fully user-configurable and renders with a soft transparency by default, keeping the channel visible without overwhelming the underlying price action.
● Sloped Volume Profile Bars (Polylines)
The volume profile is rendered as a series of filled parallelogram shapes — each row tilted to follow the channel slope, its width proportional to the volume accumulated in that row relative to the session maximum. High-volume rows appear as wide, prominent bars; low-volume rows appear as thin lines. Bullish-attributed rows render in the bullish volume color; bearish-attributed rows render in the bearish volume color. The profile extends rightward from the channel's start point to its active end point, giving it a sloped, three-dimensional appearance that visually communicates both volume density and directional bias.
● POC Line
The Point of Control is rendered as a solid, wider line running the full length of the channel at the deviation offset corresponding to the highest-volume row. Its color is user-configurable and defaults to a bright cyan tone. A left-pointing label reading "POC" anchors it at the channel's right boundary. The POC line is the most visually prominent element in the profile, drawing the eye to the market's highest-volume reference level.
● Value Area Lines and Fill
The Value Area High and Low are rendered as dashed lines running the full channel length at their respective deviation offsets. They share a configurable color that defaults to a medium cyan. The space between VAH and VAL is optionally filled with a semi-transparent background — configurable in color and transparency — creating a visual band that represents the zone of primary transactional agreement. Labels reading "VAH" and "VAL" appear at the right boundary.
● Profile Extremes Lines
The highest and lowest deviation extremes are rendered as dotted lines in a configurable violet tone, marking the outer boundaries of the price range observed during the profile period. These lines sit above the upper channel band and below the lower channel band when the market has exceeded the statistical deviation boundaries.
● Gradient Cloud Fill
Two gradient cloud regions fill the space between the regression channel and its outer deviation extremes — one above the midline and one below. Each cloud transitions smoothly from an inner color to an outer color across a configurable number of gradient steps, creating a visual depth effect that communicates proximity to the channel boundaries. The upper cloud defaults to a rose-to-magenta gradient; the lower cloud defaults to a teal-to-cyan gradient. Both gradients are fully customisable.
● Institutional Footprint Highlighting
Bars identified as carrying anomalously elevated volume are marked with a configurable semi-transparent fill, defaulting to a warm amber tone. The fill draws attention to the specific bars within the lookback window where large-order participation was most concentrated, providing a quick visual reference for identifying high-activity zones.
● Inducement (IDM) Labels
Inducement levels that have been broken by subsequent price action are marked with small text labels reading "IDM" positioned at the pivot bar and price level where the inducement originally formed. Labels for bullish inducements (broken swing highs) appear above the bar; labels for bearish inducements (broken swing lows) appear below. Each label is rendered in the user-configured IDM color against a transparent background. Up to fifty labels are maintained within the active channel window, with older out-of-window labels automatically removed.
● 💧 Liquidity Sweep Labels
Sweep events are marked with a water-droplet emoji rendered in the user-configured sweep color at the high or low of the swept bar, positioned precisely where the wick penetrated the deviation band. These markers are self-cleaning — labels that fall outside the active channel window are automatically deleted as the window advances.
● Volume Anomaly Labels
Bars qualifying as volume anomalies receive a small label marked "A" positioned at a comfortable offset above or below the bar, colored in the user-configured anomaly color. Bullish anomalies (close above midpoint of the bar) are labeled below the low; bearish anomalies are labeled above the high.
● Event Labels at Channel Terminus
Depending on the active End Point Mode, contextual labels appear at the right boundary of the channel: a projection label showing the number of bars extended when in Forward Projection mode; a breakout-reset label when a breakout triggers a channel reset; a POC-break label when a POC-Based Termination event fires.
● Live Analytics Dashboard
A fixed two-column table positioned at the top-right of the chart displays ten rows of live data: LinReg Slope, Price Regime, Volume POC price, Channel Age, Anchored VWAP, Volume Compression Score, Channel Position Oscillator, Inducement count, Liquidity Sweep status, and Volume Anomaly status. Label-column cells render on alternating dark background tones for legibility. Value-column cells are color-coded individually to their metric readings — green tones for strong/bullish, amber for neutral, grey for inactive, red/orange for bearish or anomalous. Compression and Position readings are rendered as ASCII progress bars showing both a proportional block-fill and a percentage value, enabling rapid visual assessment without requiring the user to interpret a number in isolation.
📖 How to Use
● Initial Setup
Apply the indicator to any standard candlestick chart. The indicator will not run on Heikin Ashi or Renko charts — it enforces standard chart types automatically. Begin with the default settings to establish a baseline view, then adjust the Channel Length and Start Point Method to match the market structure you are analysing.
● Selecting the Start Point
The Start Point Method determines what event anchors the left boundary of the profile. For trend-following contexts, "Swing High/Low (Smart Money)" anchors to the most recent significant pivot — ideal for profiling the current trend leg. "Session Open" anchors to the opening of the London, New York, or Asia session — ideal for intraday profiling. "Volume Spike" anchors to the most recent anomalous volume bar — ideal for profiling activity following a large institutional print. "ATR Explosive Bar" anchors to the most recent range-expansion bar — ideal for profiling post-breakout distribution. "HTF Candle Open" anchors to the opening of the current daily or weekly candle — ideal for profiling within the context of a higher-timeframe move.
● Reading the Volume Profile
Identify the widest rows — these represent the deviation levels where the market has conducted the most business relative to the channel slope. The POC line marks the single most active level. The Value Area band (bounded by VAH and VAL) marks the region of primary transactional agreement. Price trading within the Value Area is in the zone of established consensus; price trading outside it is in a less liquid, more contestable zone.
● Using the Gradient Clouds
The gradient clouds visualise the space between the regression channel and the profile's outer extremes. When price is pressing the upper cloud, it is operating near the top of the channel's accepted range. When price is embedded within the lower cloud, it is near the floor. The depth of the gradient provides a spatial cue — the further price penetrates toward the outer edge, the more overextended the move relative to the channel structure.
● Interpreting the Dashboard
Review the LinReg Slope row first — it establishes the directional context for all other readings. Then assess Price Regime to confirm whether price is inside the channel or extended. Check Volume POC to identify the current value reference level. The Volume Compression Score, rendered as an ASCII progress bar, gives a quick read on whether the market is coiled (high compression) or diffuse (low compression). The Channel Position Oscillator shows where within the channel price currently sits. The bottom three rows — Inducement, Liquidity Sweep, and Volume Anomaly — surface live smart money activity, each activating with a distinct color change and label when a qualifying event is detected.
● Using the RSI Volume Filter
Enable the RSI Volume Filter when you want to isolate specific types of volume. In Extremes mode, only volume from overbought and oversold bars contributes to the profile — producing a map of liquidity that formed under exhaustion conditions. In Trend Confluence mode, only volume aligned with the channel slope contributes — producing a map of trend-committed participation. This allows the profile to be tailored to the specific analytical question being asked.
● End Point Mode Selection
Use "Current Bar (Live)" for active monitoring during a trading session. Use "Confirmed Bar Only" for a clean, non-updating snapshot suitable for post-session review. Use "Breakout Auto-Reset" to have the channel automatically refresh when price escapes the deviation bands — keeping the profile anchored to the most recent structural phase. Use "Forward Projection" to extend the channel into the future for anticipatory analysis. Use "POC-Based Termination" to automatically end the profile when price invalidates the POC level, signalling a structural shift.
● Combining Modules for Decision Support
The most effective use of this indicator is as an integrated system rather than as individual components. A high Volume Compression reading combined with a Sweep event at the VAH or VAL suggests a coiled market probing for liquidity before a directional resolution. An Anomaly label at the POC level combined with a rising Inducement count suggests absorption near value with pending liquidity above or below. The dashboard condenses these multi-dimensional readings into a single panel, allowing rapid assessment without scanning multiple chart locations simultaneously.
⚙️ Inputs and Settings
● Dash
BG — Background color of the dashboard panel. Controls the fill color applied to dashboard cells in standard (non-alternating) rows.
Text — Default text color applied to dashboard label cells. Value cells use individually assigned metric colors.
● Linear Regression Settings
Channel Length — The number of bars used in the regression calculation when the Start Point Method is set to Default. Determines the lookback window for all regression-based calculations. Range: 10 to 5000.
Source — The price series used to fit the regression midline. Options: close, high, low, hl2, hlc3, ohlc4.
Upper Deviation — Toggles the upper deviation band. When enabled, the band renders at the user-defined multiple of the channel's internal standard deviation above the midline.
Upper Multiplier — The standard deviation multiple applied to the upper band when Upper Deviation is enabled.
Lower Deviation — Toggles the lower deviation band. When enabled, the band renders at the user-defined multiple of the channel's internal standard deviation below the midline.
Lower Multiplier — The standard deviation multiple applied to the lower band when Lower Deviation is enabled.
● Sloped Volume Profile Settings
Number of Rows — The number of horizontal volume rows the profile is divided into. Higher values produce finer granularity; lower values produce broader, smoother distributions. Range: 10 to 100.
Profile Width % — Controls the maximum horizontal width of the widest profile row as a percentage of the channel length. Range: 5 to 80.
Show POC Line — Toggles the Point of Control line and its label.
Show Value Area Lines — Toggles the VAH and VAL dashed lines and their labels.
Fill Value Area Background — Toggles the semi-transparent fill between the VAH and VAL lines.
Show Profile Extremes (Max/Min) — Toggles the dotted lines at the outermost deviation extremes.
Show Gradient Clouds — Toggles the gradient cloud fills above and below the channel.
Value Area % — The percentage of total profile volume that the Value Area must encompass. Range: 50 to 90. Default: 70.
● RSI Volume Filter (Liquidity Isolation)
Enable RSI Filter — Activates the RSI-based volume filter, restricting which bars contribute to the profile.
RSI Length — The lookback period for the RSI calculation used by the filter. Range: 2 to 50.
Filter Mode — Selects between Extremes (overbought/oversold bars only) and Trend Confluence (directionally aligned bars only).
Overbought Threshold — The RSI level above which a bar qualifies as overbought for the Extremes filter mode.
Oversold Threshold — The RSI level below which a bar qualifies as oversold for the Extremes filter mode.
● Advanced Quant Analytics
Highlight Institutional Footprints — Toggles the visual overlay on bars identified as carrying anomalously elevated volume within the profile distribution.
Institutional Footprint Color — The color applied to the institutional footprint bar highlights. Supports custom transparency.
Calculate Anchored VWAP (Dashboard) — Enables the Anchored VWAP calculation anchored to the channel start point and surfaces the result on the dashboard.
● Color Palette & Visuals
Channel Lines — Color applied to all three regression channel lines (midline, upper, and lower).
Bullish Volume — Color applied to profile rows that are attributed to bullish bars.
Bearish Volume — Color applied to profile rows that are attributed to bearish bars.
POC Color — Color applied to the POC line and its label.
VAH Color — Color applied to the Value Area High line and its label.
VAL Color — Color applied to the Value Area Low line and its label.
VA Background Fill — Color applied to the fill between VAH and VAL.
Profile Extremes Line — Color applied to the dotted extreme deviation lines.
● Cloud Gradient Settings
Gradient Smoothness (Steps) — The number of gradient steps used to render each cloud. Higher values produce smoother transitions; lower values produce more distinct bands. Range: 3 to 30.
Upper Cloud Inner — The color at the inner (channel-adjacent) edge of the upper gradient cloud.
Upper Cloud Outer — The color at the outer (extreme-adjacent) edge of the upper gradient cloud.
Lower Cloud Inner — The color at the inner edge of the lower gradient cloud.
Lower Cloud Outer — The color at the outer edge of the lower gradient cloud.
● 🎯 Start Point Method
Start Point Method — Selects the anchor logic for the channel's left boundary. Options: Default (Channel Length), Swing High/Low (Smart Money), Session Open, Volume Spike (Institutional), ATR Explosive Bar, HTF Candle Open (Daily/Weekly).
Swing Lookback Length — The number of bars on each side required to confirm a swing high or low when using the Swing High/Low start method. Range: 3 to 50.
Session — The trading session used as the anchor when using the Session Open start method. Options: London, New York, Asia.
ATR Length (Explosive Bar) — The ATR lookback used to identify explosive bars when using the ATR Explosive Bar start method. Range: 5 to 50.
ATR Multiplier — The multiple of ATR a bar's range must exceed to qualify as explosive. Range: 1.0 to 5.0.
HTF Timeframe — The higher timeframe candle open used as anchor when using the HTF Candle Open start method. Options: Daily, Weekly.
● 🏁 End Point Method
End Point Method — Selects how the channel's right boundary is determined. Options: Current Bar (Live), Confirmed Bar Only (bar_index-1), Breakout Auto-Reset, Forward Projection, POC-Based Termination.
Projection Bars (Forward) — The number of bars beyond the current bar that the channel extends when using the Forward Projection end method. Range: 5 to 200.
● 🧲 Inducement (IDM)
Show Inducement Labels — Toggles the IDM label markers on broken pivot levels within the channel window.
IDM Swing Lookback — The number of bars on each side required to confirm a swing pivot used in inducement tracking. Range: 2 to 50.
IDM Label Color — The color applied to IDM text labels.
● 💧 Liquidity Sweeps
Show Liquidity Sweep Labels — Toggles the sweep marker labels on bars where a channel band was penetrated and rejected.
Sweep Label Color — The color applied to sweep event markers.
● ⚠️ Volume Anomaly
Show Volume Anomaly Labels — Toggles the anomaly marker labels on qualifying bars.
Anomaly Volume Lookback — The lookback window used to establish the volume baseline against which anomaly bars are compared. Range: 2 to 50.
Max Body/Range Ratio — The maximum close-to-open distance relative to the bar's total high-low range for a bar to qualify as an anomaly. Bars with body ratios below this threshold (high volume, small directional result) are flagged. Range: 0.1 to 0.9.
Anomaly Label Color — The color applied to anomaly marker labels.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Linear Regression and Least-Squares Fitting
The channel's midline is derived through ordinary least-squares (OLS) regression — the same minimisation principle that underlies the foundational work of Gauss and Legendre and that remains the backbone of modern econometric time-series modelling. In financial applications, linear regression applied to price series was formalised in the quantitative finance literature through the work of researchers including Lo and MacKinlay (1988, 1999), who examined the statistical properties of price over time and the conditions under which directional trend components are statistically distinguishable from random noise. The channel's deviation bands extend this framework by incorporating dispersion metrics — standard deviation of residuals — as boundary conditions, a practice directly analogous to confidence interval construction in classical regression theory.
● Market Profile Theory and Auction Market Theory
The volume profile methodology is rooted in the Market Profile framework developed by J. Peter Steidlmayer in collaboration with the Chicago Board of Trade in the 1980s and expanded by James Dalton, Eric Jones, and Robert Dalton in "Mind Over Markets" (1990). Auction Market Theory — the intellectual foundation of Market Profile — holds that markets are continuous auctions seeking to facilitate trade, and that price moves to discover levels where two-sided trade is maximised. The Point of Control, Value Area, and distribution shape are direct implementations of this framework, translated from time-based TPO profiles to volume-weighted profiles in the tradition of Volume Profile analysis. The sloped projection of these levels onto the regression axis extends the framework into directional market contexts that Steidlmayer's original flat-profile construction did not address.
● Volume-Weighted Average Price (VWAP) Theory
The Anchored VWAP implementation draws on the VWAP literature rooted in the institutional execution research of Berkowitz, Logue, and Noser (1988), who established VWAP as a benchmark for evaluating execution quality relative to the volume-weighted fair value over a trading period. The anchoring methodology — fixing the VWAP calculation to a structurally significant event rather than the session open — is conceptually aligned with the anchored VWAP framework popularised in retail technical analysis and grounded in the same principle that the relevant cost basis for a price move is established at its origin, not at an arbitrary clock time.
● Smart Money Concepts and Liquidity Theory
The Inducement Detection and Liquidity Sweep modules are conceptually grounded in the body of market microstructure research examining stop-hunt mechanics and liquidity-driven price displacement. Academically, this is related to the Kyle (1985) model of informed trading, which demonstrates that informed participants strategically time their orders to extract liquidity from uninformed market makers. The empirical pattern of price penetrating a well-defined swing level, triggering resting orders, and then reversing — what the smart money concepts community terms a sweep — is a market-observable manifestation of this order-flow dynamic. The detection logic identifies confirmed instances of this pattern within the active structural window.
● Volume Anomaly Detection and Absorption Theory
Volume anomaly detection is grounded in the Wyckoff Method's concepts of Stopping Volume and No Demand / No Supply bars, articulated by Richard Wyckoff in the early twentieth century and later systematised by the Wyckoff Analytics community and researchers including Hank Pruden and Roman Bogomazov. The combination of elevated volume and a small body-to-range ratio is the textbook Wyckoff signature of a market absorbing aggressive supply or demand without producing a net directional result — a condition Wyckoff termed a "climactic action" when occurring after a sustained trend. The indicator's anomaly filter operationalises this observation through measurable threshold conditions rather than subjective chart reading.
● Dispersion and Concentration Metrics
The Volume Compression Score is conceptually related to the statistical literature on concentration indices and distribution kurtosis. A highly compressed volume distribution — where the majority of volume is concentrated in a narrow band of the profile — is analogous to a leptokurtic distribution in statistical terms and to a high-liquidity, low-volatility regime in market terms. The progression from high compression (coiled, pre-breakout) to low compression (diffuse, post-distribution) maps onto the well-documented volatility clustering phenomenon described in the GARCH family of models (Bollerslev, 1986, extending Engle, 1982), where periods of low volatility tend to precede periods of high volatility.
● RSI as a Regime Filter
The optional RSI filter layer applies the relative strength index — originally developed by J. Welles Wilder Jr. in "New Concepts in Technical Trading Systems" (1978) — not as a standalone signal generator but as a regime classifier. This approach aligns with the academic literature on momentum and mean-reversion regimes: RSI values in extreme territory identify bars where the market's short-term momentum is statistically stretched, while values aligned with the medium-term trend direction identify bars where momentum is directionally coherent. Using RSI to selectively gate volume into the profile transforms it from a passive distribution map into an active analytical instrument tuned to specific market regime hypotheses.
⚠️ Disclaimer
This indicator is provided for educational and analytical purposes only. Nothing contained within this indicator, its descriptions, its signals, its labels, or its dashboard outputs constitutes financial advice, investment advice, trading advice, or a recommendation to buy or sell any financial instrument. Past behaviour of price, volume, or any derived metric shown by this indicator does not guarantee, imply, or suggest that such behaviour will recur in the future.
Trading financial instruments involves substantial risk of loss. Market conditions can change rapidly and unpredictably, and no technical indicator — regardless of its analytical sophistication — eliminates the inherent uncertainty of financial markets. Users are solely responsible for their own trading decisions and should exercise independent judgement, conduct their own due diligence, and consider seeking advice from a qualified financial professional before making any trading or investment decisions.
We disclaim all liability for any direct, indirect, incidental, or consequential losses arising from the use of, or reliance upon, this indicator or any information it produces. Use at your own risk. Bull & Bear Volume Profile Pro [MarkitTick] 💡 The dynamic nature of financial markets demands tools that can adapt to changing structural environments in real-time. This sophisticated visual utility bridges the gap between traditional price action and advanced volume analytics by autonomously mapping trading activity to specific price levels based on prevailing market trends. Instead of relying on static, manually drawn boundaries, this indicator intelligently tracks market structure to anchor volume profiles directly to confirmed structural shifts. By differentiating the distribution of volume across bullish and bearish cycles, it provides traders with a profound, structural view of where institutional value is truly concentrated.
✨ Originality and Utility
● Structural Auto-Anchoring
Traditional volume profiles require the user to manually define the start and end points of a trend. This tool eliminates that subjectivity by employing an autonomous anchoring mechanism. It dynamically detects structural pivots and shifts in trend (Change of Character), resetting and drawing the profile exactly where the new market phase begins.
● Dual-State Profile Tracking
By isolating volume data into distinctly tracked bullish and bearish phases, the tool allows traders to observe how volume distribution morphs when control shifts from buyers to sellers, offering a dual-perspective on market liquidity.
● Historical Confluence Detection
A highly original feature is the automatic mapping of overlapping high-volume nodes and Point of Control (POC) levels from previous trend cycles against the current cycle. This automated historical memory highlights areas of deep, persistent liquidity.
🔬 Methodology and Concepts
● Volume at Price Aggregation
The core engine continuously harvests transaction data from lower timeframes to ensure a high-fidelity mapping of volume across specific price increments. Rather than plotting volume horizontally against time, it is stacked vertically to reveal price acceptance and rejection zones.
● Structural State Recognition
The algorithm reads market geometry by evaluating sequential swing highs and swing lows. When a structural threshold is breached, the logic reclassifies the market state. This triggers an archival process where the previous profile is saved, and a fresh profile is generated from the exact origin of the new trend.
● Fluid Slot Distribution
The price range of the current market cycle is segmented into dynamic rows or "slots." The indicator then distributes lower-timeframe volume into these slots, categorizing the relative density of trading activity into distinct visual nodes to separate fair value from transient price spikes.
🎨 Visual Guide
● Bullish Volume Profiles
When the market structure is in a confirmed uptrend, the volume profile is rendered using a teal color scheme. The volume bars extend horizontally to indicate trading density, with the boxes utilizing calculated transparencies to represent volume intensity visually.
● Bearish Volume Profiles
Conversely, when market structure shifts to a downtrend, the profile transforms into a red color scheme. This immediate visual cue alerts the trader to the prevailing structural dominance.
● The Point of Control (POC)
The single price level with the highest volume concentration is marked by a prominent horizontal line. In an active trend, this line is rendered as dashed, and in archived prior trends, it appears dotted. An explicit "POC" text label further anchors the exact coordinate.
● Slot Grouping and Percentage Labels
Significant clusters of volume (Consolidation Zones) are grouped and highlighted with semi-transparent background blocks. Alongside these blocks, text labels display either the exact volume transacted or the percentage of total cycle volume that the specific node represents.
● Confluence Zones
When historical heavy volume zones align with current active volume zones, the tool draws specific overlay boxes. A white translucent box indicates a "Group Confluence" (overlapping high-volume nodes), while a yellow translucent box indicates "POC Confluence" (overlapping historical and active POCs). Clear text labels mark these high-probability reaction zones.
📖 How to Use
● Trading the Point of Control
The POC serves as the gravitational center of the trend. In an established trend, pullbacks to the POC often present high-probability continuation setups as they represent the "fairest" price agreed upon by market participants.
● Navigating High Volume Nodes (HVNs) and Low Volume Nodes (LVNs)
Price tends to move slowly and chop within the grouped High Volume Nodes, making them excellent targets for take-profits or zones for mean-reversion trading. Conversely, price typically moves rapidly through Low Volume Nodes; these areas can be viewed as breakout launchpads or vacuum zones.
● Leveraging Confluence Blocks
The most powerful signals are generated when price approaches a Confluence Zone (yellow or white boxes). Because these zones indicate that both past and present market participants found value at these exact coordinates, they act as formidable support and resistance ceilings. Watch for price action confirmations (like pin bars or engulfing candles) upon testing these visual boundaries.
● Trend Reversal Confirmation
When the profile dramatically shifts from teal to red (or vice versa), it confirms a structural break. Traders can use this initialization of a new profile as a macro directional filter for subsequent lower timeframe entries.
⚙️ Inputs and Settings
● Auto Anchor (Structure)
Swing Length: Determines the sensitivity of the algorithm in detecting market turning points. A lower number reacts faster to minor pullbacks, while a higher number filters out noise for macro trend profiling.
● Volume Profile Settings
Use Custom Timeframe & Custom Timeframe: Allows the user to override the automated optimal timeframe engine and force the tool to read a specific granular timeframe for volume distribution.
Row Size: Controls the resolution of the profile. Higher numbers create more granular, thinner volume bars; lower numbers group price levels into thicker, broader blocks.
Profile Width (%): Adjusts how far across the chart the longest volume bar will extend visually.
Show Text & Labels / Show % Values / Show Slot Groups: Toggles the visibility of data labels, allowing traders to clean up their charts or dive deep into the specific volume statistics.
● Volume Profile Colors
Fully customizable color settings for the Bullish and Bearish profiles, including box colors, POC line colors, and text transparency.
● Confluence Zones
Toggles for enabling or disabling the visual display of Price Confluence (overlapping groups) and POC Confluence, alongside custom color selections for these critical overlay boxes.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Auction Market Theory
The fundamental premise of this indicator relies on Auction Market Theory, which postulates that financial markets exist solely to facilitate trade between buyers and sellers. The market moves directionally to explore new prices and moves laterally to build value. By categorizing price movements into specific structural phases, the tool visually identifies whether the market is in an exploratory phase (seeking liquidity) or a facilitating phase (building volume).
● Statistical Distribution and the Pareto Principle
Within any given trend cycle, volume does not distribute evenly. The methodology models trading activity similar to a normal distribution curve. The highest volume node (the Point of Control) represents the mean of the distribution in a perfectly balanced market. The tool's algorithm aggregates data to identify the densest concentration of volume, heavily relying on the Pareto principle (the 80/20 rule), where the majority of trading volume typically takes place within a narrow band of the total price range.
● Fractal Market Hypothesis and Data Aggregation
Financial markets are fractal, meaning smaller structures build into macro structures. By natively scanning and compiling lower-timeframe data sets, the indicator maintains the integrity of the volume distribution without suffering from the distortion of high-timeframe candle aggregations. It respects the chronological execution of trades, ensuring that the volume mapped to specific price slots represents actual, granular order flow execution rather than smoothed averages.
● Market Memory and Liquidity Voids
The automated identification of Confluence Zones is grounded in the psychological and institutional concept of "Market Memory." Institutional participants often leave residual limit orders or have defending interests at historical high-volume nodes. The tool's ability to cross-reference archived profiles with the active profile highlights these zones mathematically, presenting them as areas of high friction (liquidity) while identifying the spaces between them as low-friction voids (inefficiencies).
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Smart Auto Volume Profile Pro [MarkitTick] 💡 The Smart Auto Volume Profile Pro is an elite-tier charting companion designed to dynamically analyze market structure and volume distribution. By intelligently anchoring volume profiles to structural shifts—such as micro or macro Changes of Character (CHoCH)—this tool provides an adaptive look at where liquidity rests. Combined with a multi-timeframe Confluence Radar, gap detection, and a proprietary Smart Money volume separation engine, it offers traders an unparalleled, high-definition view of value areas and significant support or resistance zones.
This is the professional version of the free indicator Smart Fixed Volume Profile
✨ Originality and Utility
Standard volume profiles often force the user to guess the optimal starting point, leading to subjective and inconsistent analysis. The originality of this indicator lies in its fully automated structural anchoring system. It constantly scans for pivot highs and lows, identifying trend changes to automatically reset and redraw the volume profile from the exact origin of the new market leg.
Furthermore, the tool distinguishes itself through its unique "Smart Money" mode. Rather than treating all volume equally, it utilizes proprietary abstract thresholds to categorize volume nodes into theoretical "Whale" (large entity) and "Retail" (smaller entity) participation. This allows users to see not just where the most volume was traded, but potentially who was trading it. Coupled with a Golden Zone MTF Confluence Radar that scans up to four higher timeframes for overlapping Points of Control (POC), this indicator acts as a comprehensive command center for volume and price action analysis.
🔬 Methodology and Concepts
● Automated Market Structure Anchoring
At its core, the script evaluates rolling pivot points to determine the immediate or macro market trend. When a Change of Character (CHoCH) is detected—meaning a previous structural high or low is breached—the system theoretically assumes a new market cycle has begun. The profile anchor is immediately relocated to this origin point, ensuring the volume data analyzed is strictly relevant to the current ongoing trend.
● Volume Distribution and Smart Categorization
Using a sophisticated internal binning algorithm, the price range of the current trend is divided into configurable rows. Volume is then distributed across these price levels. In the proprietary Smart Money mode, a dynamic thresholding mechanism evaluates the intensity of volume per bar. Volume clusters that exceed the upper percentile thresholds are binned into the "Whale" category, while the remainder is classified as "Retail." This conceptual separation aims to highlight institutional interest levels versus retail crowd congestion.
● Multi-Timeframe Confluence Radar
The indicator actively retrieves volume data from multiple higher timeframes (such as 4H, Daily, Weekly, and Monthly). It calculates the Point of Control for each of these external timeframes and compares them against the local chart's POC. When these theoretical centers of gravity align within a tight tolerance, the algorithm registers a structural confluence, marking it as an area of high historical significance.
● Advanced Gap Analysis
The script continuously monitors for price disparities between trading sessions or bars. It conceptually categorizes these into Breakaway Gaps (occurring near structural breakouts) and Runaway Gaps (occurring mid-trend). It also tracks bullish and bearish windows, ensuring that exhausted or filled gaps are dynamically cleaned up to keep the chart pristine.
🎨 Visual Guide
● Volume Profile Display
Standard Boxes: Rendered in transparent blue hues, these horizontal bars represent the volume traded at specific price levels. Darker blue indicates higher volume density.
Smart Whale Profile: Displayed in vibrant cyan, showing price levels dominated by large-volume transactions.
Smart Retail Profile: Displayed in magenta, highlighting areas of standard or retail-level congestion.
● Slot Groups (Consolidation Zones)
• The Core Concept
Rather than analyzing trading volume at isolated, individual price ticks, the "Slot Groups" feature identifies broader, continuous price ranges where significant market activity has aggregated. These areas are highlighted as unified "blocks" representing major market consolidation.
• Strategic Value for Traders
High-Conviction Support & Resistance: These grouped zones act as major structural barriers on the chart. A massive consolidation block below the current price often serves as a robust support floor, while a thick block above acts as heavy resistance.
Market Equilibrium: These boxes highlight historical areas where buyers and sellers agreed on "fair value." Price tends to naturally gravitate back toward these magnetic zones or react aggressively when breaking out of their boundaries.
Noise Reduction: By automatically grouping adjacent high-volume levels together, the indicator filters out minor market fluctuations. This presents you with clean, actionable liquidity pools rather than a cluttered, fragmented volume profile.
• Visual Representation on the Chart
Shaded Boxes: The indicator projects clean, semi-transparent rectangles that span the exact upper and lower boundaries of these high-traffic zones, making the structural floors and ceilings instantly visible.
Contextual Labels: Alongside each box, a dedicated text label displays the exact weight of that consolidation zone (either as a raw volume figure or a percentage of the overall trend's volume). This allows you to quickly compare the strength of one zone against another.
• Smart Money Application
When operating in the indicator's "Smart Mode," these consolidation blocks are intelligently separated. The chart will display distinct, color-coded groupings specifically for "Whale" activity (highlighting potential institutional accumulation or distribution) versus standard "Retail" congestion, allowing you to visually separate institutional footprints from everyday market noise.
● Points of Control (POC)
Standard POC: A dashed line indicating the single price level with the highest total volume.
Whale POC: A solid cyan line marking the highest concentration of institutional-tier volume.
Retail POC: A dotted magenta line tracking the peak of retail trading activity.
● Institutional Order Flow: Mapping Liquidity Voids & Volumetric Support/Resistance
• Upper Red Zone
As the current bullish wave, mapped by this active volume profile, expands into this zone, it encounters a liquidity void, buyers rejected these premium prices and withdrew bid liquidity. This allowed sellers to drive the price down with extreme velocity and zero resistance, preventing any meaningful volume accumulation. The algorithm mathematically isolates this data to map the exact boundaries of the void. This zone now represents a future resistance due to the buyers' lack of conviction at these prices. If this volumetric void is filled in the future, it means the buyers' conviction has changed and they have accepted the price, thereby breaking this historical resistance.
• Lower Green Zone
As the current bearish wave, mapped by this active volume profile, expands into this zone, it encounters a liquidity void, sellers rejected these discount prices and withdrew ask liquidity. This allowed buyers to drive the price up with extreme velocity and zero resistance, preventing any meaningful volume accumulation. The algorithm mathematically isolates this data to map the exact boundaries of the void. This zone now represents a future support due to the sellers' lack of conviction at these prices. If this volumetric void is filled in the future, it means the sellers' conviction has changed and they have accepted the price, thereby breaking this historical support.
● Confluence Golden Zones
Golden Boxes: Highlighted in yellow/gold, these zones appear when the local POC mathematically aligns with the POC of higher timeframes. The thickness of the border indicates how many timeframes are overlapping.
Golden Labels: Text elements that explicitly state which higher timeframes are converging (e.g., "1D + 1W").
● Gap Boxes
Breakaway Gaps: Purple boxes indicating explosive momentum away from a structural pivot.
Runaway Gaps: Amber/Orange boxes indicating continuation in the middle of a trend.
Bullish/Bearish Windows: Bright green and red zones highlighting standard unfilled gaps in price action.
● Fibonacci Retracements
High/Low Bounds: Gray lines marking the 0.0 and 1.0 levels of the current structural swing.
Golden Ratio: A thick orange line representing the 0.618 retracement level.
Secondary Levels: Yellow and purple dashed lines for the 0.382, 0.5, and 0.786 retracements.
📖 How to Use
● Identifying Asymmetric Value
When utilizing the Smart Mode, traders can look for divergences between the Whale POC and the Retail POC. If the price is currently resting near the Whale POC but far from the Retail POC, it may indicate that "smart money" is defending a level that the general retail crowd has ignored, potentially offering a high-conviction defense zone.
● Trading the Golden Zone
The MTF Confluence Radar is a primary action trigger. When a Golden Zone is drawn on the chart, it signifies a massive, multi-timeframe consensus of value. Traders often use these zones as premium targets for take-profits or as heavy macro-support/resistance levels for mean-reversion entries.
● Contextualizing Breakouts with Gaps
Not all gaps are created equal. If the indicator highlights a Breakaway Gap immediately following a structural shift (CHoCH), it adds validity to the new trend's strength. Conversely, if value areas begin to form inside older, unfilled window gaps, it suggests the market is attempting to establish equilibrium in previously bypassed price ranges.
⚙️ Inputs and Settings
● Calculation Mode
Enable Manual Anchor: Overrides the automated structural detection, allowing the user to select a precise historical date and time to begin the volume profile calculation.
Auto Anchor Mode: Choose between "Micro" for aggressive, short-term minor swing detection (ideal for scalpers), or "Macro" for absolute high/low major swing detection (ideal for swing traders).
Structure Timeframe: Allows the algorithm to calculate structure from a different timeframe than the chart you are currently viewing.
● Volume Profile Settings
Profile Mode: Toggle between the "Standard" volume aggregation and the proprietary "Smart Money" split profile.
Row Size: Determines the vertical granularity of the profile. Higher numbers create more horizontal bars, showing more precise price levels.
Whale Threshold (%): An adjustable percentile boundary used in Smart Mode. A higher percentage requires significantly more volume per bar to be categorized as Whale activity.
● Confluence Radar
Enable TF1 - TF4: Toggles the scanning of specific higher timeframes (defaulting to 4H, Daily, Weekly, Monthly).
Tolerance (%): Determines how close the higher timeframe POCs need to be to the local POC to trigger a Golden Zone match.
● Gap Analysis Logic
Min Gap Size: Filters out irrelevant micro-gaps by requiring a minimum point difference.
Breakaway Window: Determines how many bars after a CHoCH a gap can occur and still be classified as a breakaway momentum gap.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
This indicator is fundamentally rooted in Auction Market Theory (AMT) and the Volume Point of Control (VPOC) paradigm. AMT posits that financial markets are highly efficient double-auction mechanisms primarily seeking equilibrium (fair value) between buyers and sellers. The volume profile is a statistical bell curve (often skewed or multimodal) plotted on the Y-axis, representing the normal distribution of accepted price.
The MTF Confluence aspect relies on the Fractal Market Hypothesis (FMH), which asserts that market structure and liquidity dynamics repeat across different scales of time. By mathematically intersecting the central tendency (the mode of the volume distribution) of macro timeframes with micro timeframes, the script identifies non-random liquidity pools where multi-scale market participants have historically agreed on fair value.
Furthermore, the Smart Money volume segregation logic abstracts the concept of Order Flow Imbalance and trade-size thresholding. By filtering the statistical anomalies in the volume dataset—those residing in the upper deciles of standard deviation—the algorithm attempts to isolate the footprints of institutional capital allocation from the ambient noise of standard Brownian market motion.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Smart Gap Concepts Pro [MarkitTick] 💡 Price gaps are among the most consistently misunderstood phenomena in technical analysis. They appear routinely on charts yet most traders treat them as statistical noise — anomalies to be ignored or avoided rather than structural events to be decoded. Smart Gap Concepts Pro exists to correct that misunderstanding. This indicator transforms raw gap data into a fully classified, multi-layered analytical framework, distinguishing between gaps that signal the beginning of a trend, those that confirm its continuation, those that mark its midpoint acceleration, and those that warn of its exhaustion — all in real time, across multiple timeframes, and enriched with a suite of supplementary tools that no single gap-detection tool currently offers in a unified form. It is built for traders who understand that where price jumps matters less than why it jumps, and who need a system capable of answering that question with precision on every bar of every session.
✨ Originality and Utility
● Beyond Binary Gap Detection
Most gap-detection tools on the market operate on a single binary principle: a gap exists, or it does not. Smart Gap Concepts Pro rejects this primitive framing entirely. Every detected gap passes through a multi-criteria evaluation that weighs price structure, volume conditions, trend maturity, directional bias, and session context simultaneously before it is classified. The result is a four-tier taxonomy that gives each gap a meaningful identity rather than a mere existence flag.
● Unified Gap Ecosystem in One Tool
What typically requires three or four separate indicators — gap detection, structure analysis, multi-timeframe overlay, and session filtering — is unified here into a single, cohesive system. The indicator tracks current-timeframe gaps, higher-timeframe gaps, Japanese candlestick window gaps (both rising and falling), and Island Reversal patterns, all within the same visual canvas and managed through a shared state architecture. No cross-indicator synchronization is required. No conflicting signals from separate tools. One indicator, one complete picture.
● Proprietary Scoring and Probability Engine
Each gap on the chart is not merely drawn and forgotten. The indicator continuously evaluates every active gap zone using a dynamic scoring system that accounts for price proximity, zone age, and the number of times price has interacted with the zone. This scoring converts gap zones from static annotations into living probability fields, updated bar by bar, expressing the likelihood that price will return to each zone. This transforms the indicator from a detection tool into a forward-looking decision support system.
● Structural Context Through Trend Bias
An optional cross-gap trend bias engine synthesizes structural market direction, gap population data, and price positioning relative to active zones into a single composite bias score. This score, displayed as a directional arrow and percentage, gives traders an at-a-glance read of whether the current gap landscape supports bullish or bearish continuation — without requiring the user to manually interpret the relationship between structure and gap distribution.
● Mirror Gap Symmetry Detection
The indicator includes a proprietary symmetry detection engine that identifies when a newly formed gap mirrors a prior gap of opposite direction in both size and price proximity. These Mirror Gap pairings highlight zones of structural tension where the market has expressed opposing imbalances of nearly identical magnitude, a configuration that carries significant confluence weight in price action and auction market analysis.
● Tiered Alert Architecture
Alerts are not binary. The indicator classifies each gap signal into one of three priority tiers — A, B, or C — based on a confluence scoring model that considers gap type, structural alignment, session open price interaction, volume conditions, and higher-timeframe echo presence. Tier A alerts represent the highest-confidence setups; Tier C alerts flag standard detections. All alerts are delivered via structured JSON webhook payloads for seamless integration with external automation systems.
🔬 Methodology and Concepts
● Gap Classification Framework
Structural Breakaway Gap (SBG) — A gap that forms simultaneously with a confirmed break of a prior structural pivot level, representing the transition from one market phase to another. An SBG occurring after a period of bearish structure signals a potential shift in auction control. An SBG emerging from a bullish structure signals potential continuation of the dominant regime. The SBG is distinguished from all other gap types by the presence of a structural pivot violation — without that structural event, the gap cannot receive this classification. The distinction between a breakaway associated with a Change of Character versus one aligned with a Break of Structure is preserved and displayed separately, giving traders the ability to distinguish between counter-trend reversals and trend-following entries.
Structural Continuation Gap (SCG) — A gap that forms in alignment with the prevailing structural bias and coincides with a structural confirmation event. Where the Structural Breakaway Gap marks the initiation of a new phase, the Structural Continuation Gap confirms that the market has accepted the new regime and is expanding the move. Traders seeking to add to existing positions in the direction of structure will find the SCG a reliable entry context.
Runaway Gap (RA) — A gap that forms in a trending environment without satisfying the criteria for structural classification or exhaustion. Often appearing at the midpoint of a trend leg, runaway gaps reflect unchallenged directional momentum. They are the most common gap type in strongly trending markets and represent zones where price moved so rapidly that no meaningful resistance or support was established. The indicator identifies these zones and tracks them as high-probability retest targets.
Exhaustion Gap (EX) — A gap that forms in a market that has demonstrated elevated volume conditions and has been trending for an extended period relative to the most recent structural anchor. Exhaustion gaps typically appear near the terminal phase of a trend leg and are associated with climactic price behavior — a final burst of directional energy before the market reverses or enters a consolidation phase. The indicator surfaces exhaustion gap conditions through the joint evaluation of volume intensity and trend duration, without disclosing the specific thresholds or calculation method used.
● Window Gap Classification
Rising Window (RW) — Derived from Japanese candlestick methodology, a Rising Window occurs when the low of the current bar exceeds the high of the prior bar, leaving an uncontested price range that acts as potential support on any pullback. The indicator tracks all rising window formations, computes their midpoint levels, and scores them continuously for revisitation probability. Rising windows that overlap with existing classified gaps are detected and flagged accordingly, elevating their analytical weight.
Falling Window (FW) — The bearish counterpart to the Rising Window. A Falling Window forms when the high of the current bar falls below the low of the prior bar. These zones act as potential resistance on any recovery. Like Rising Windows, they are tracked, scored, and managed across the life of the chart.
● Island Reversal Pattern
The indicator incorporates a dedicated Island Reversal detection engine operating in parallel with the primary gap classification system. An Island Reversal forms when a price cluster becomes isolated between two gaps of opposite direction — a gap up that separates a cluster from prior price action, followed by a gap down that closes the island. The reverse configuration (gap down, isolation, gap up) produces a bullish Island Bottom. This pattern carries significant reversal weight and is confirmed only when specific volume conditions are met on both the opening and closing gap events, ensuring that low-quality pattern matches are filtered out.
● Gap Magnet Probability Scores
Every active gap zone carries a continuous probability score displayed directly on the chart. The score reflects three inputs: how close current price is to the zone's midpoint, how old the zone is relative to the chart history, and how many times price has interacted with the zone's boundaries. These inputs are blended into a single percentage figure rendered in a color that shifts from red through amber to teal as the score increases. A high score indicates a zone with strong revisitation likelihood based on current conditions; a low score flags a zone that may be becoming irrelevant. Scores update on every bar.
● Gap Cluster Heatmap
The integrated heatmap sub-panel within the dashboard aggregates all active gap levels — current-timeframe gaps, window gaps, higher-timeframe gaps, and session open price levels — into a price-binned density map. Each bin represents a price range, and the count of gap-derived levels falling within that range is visualized as a filled bar. Bins with the highest concentration of overlapping levels are highlighted at full intensity; sparse bins appear at reduced intensity. The bin corresponding to the current price is highlighted to orient the user within the density distribution. "Super Magnet Zones" identified by the heatmap represent price areas where multiple independent gap events have produced overlapping levels — the most significant areas of potential price attraction on the chart.
● Multi-Timeframe Gap Overlay
When the higher-timeframe gap overlay is enabled, the indicator requests classified gap data from a user-selected higher timeframe and renders those zones on the current chart using dashed-border boxes. Higher-timeframe gaps are distinguished from current-timeframe gaps visually to prevent ambiguity. Only confirmed higher-timeframe gap events are displayed — the rendering logic ensures that intra-period, unconfirmed data is never used, maintaining the integrity of the overlay across all chart configurations.
● Session Open Price Tracker (IPO Lines)
The indicator can track and display the opening price of the Asia, London, and New York trading sessions as dynamic horizontal lines that extend forward in time from the moment of each session's opening bell. These lines expire automatically after a user-defined number of bars. When a session opening price falls within the range of any active gap zone, the affected gap box is visually marked — a configuration the indicator identifies as a high-confluence area where a significant institutional reference level and an unresolved price imbalance occupy the same range simultaneously.
● Gap Symmetry Index (Mirror Gap Detector)
The Mirror Gap Detector evaluates each newly classified gap against all existing active gaps of the opposite direction. When a new gap's size and price midpoint fall within configurable ATR-based tolerances of an existing opposite-direction gap, a Mirror Gap pairing is confirmed and labeled on the chart with a symmetry marker. Mirror gaps reflect balanced market structure — opposing imbalances of near-identical magnitude that suggest the market has repeatedly valued the same price area from both directions. These pairings often act as equilibrium references around which price oscillates.
● Session Filter
Every gap and window detection can be filtered by trading session. When the session filter is enabled, only gaps formed during allowed sessions are displayed. Each session receives a distinct border color on its gap boxes, providing immediate visual differentiation between Asia, London, and New York gaps. This allows traders to evaluate whether specific session environments consistently produce higher-quality gap signals on their instrument.
● Session Overlap Amplifier
An optional overlay marks gaps that form specifically during the London–New York or Asia–London overlap windows. Gaps produced during session overlaps often carry elevated significance due to the simultaneous participation of multiple major market centers. When a gap is detected during an overlap period, its box receives an enhanced border and a session overlap tag.
● Cross-Gap Trend Bias Engine
The Trend Bias Engine produces a composite directional score by synthesizing three inputs: the structural pivot bias derived from the price structure analysis layer, the directional balance of all active gaps on the chart (bullish count versus bearish count), and the position of current price relative to the largest active gap zone. These inputs are weighted and blended into a normalized score ranging from fully bearish to fully bullish. The score is displayed in the top-left panel as a directional arrow and percentage value, color-coded by conviction level.
● Alert Tier Classification
Each gap detection event receives a tier classification — A, B, or C — through a multi-factor confluence model. Tier A is reserved for gap events that simultaneously satisfy structural alignment, volume confirmation, session open price zone interaction, and higher-timeframe echo presence. Tier B includes events with partial confluence — such as merged gap zones, higher-timeframe agreement, or session overlap conditions. Tier C represents standard detections that meet the base classification criteria but do not satisfy the higher-conviction filters. The current tier is displayed in the dashboard and transmitted in the JSON webhook payload.
● Gap Merge Engine
When enabled, the merge engine identifies overlapping or closely clustered gap zones — both within a single pool (standard gaps or window gaps) and across pools — and consolidates them into a single unified zone. Merged zones inherit a combined label and an extended price range. The merge tolerance parameter controls the maximum price-distance gap between two boxes that can still qualify for merging. Cross-pool merges unify standard classified gaps with window gaps when their price ranges overlap, reflecting the analytical equivalence of simultaneous gap conditions.
🎨 Visual Guide
● Gap Zone Boxes
Each classified gap is rendered as a filled box spanning from the gap's lower boundary to its upper boundary. The fill color encodes the gap type: blue-family tones for Structural Breakaway Gaps, violet-family tones for Structural Continuation Gaps, amber-family tones for Runaway Gaps, and crimson-family tones for Exhaustion Gaps. All fill colors include a transparency level that allows underlying price action to remain visible through the zone. Boxes extend forward by a user-defined number of bars to express the zone's forward relevance. When price fills a gap zone past its midpoint, the box is automatically removed from the chart.
● Gap Zone Text Labels
Each box displays a compact classification label ("SBG", "SCG", "RA", "EX" for standard gaps; "RW" and "FW" for window gaps). Below the classification label, the current Magnet Probability Score is displayed as a percentage. The label color shifts dynamically: teal indicates a high-probability revisitation zone, amber indicates moderate probability, and red indicates low probability. This color-coded scoring system makes it possible to scan the chart at a glance and identify which active zones carry the most forward weight.
● Window Gap Boxes
Rising and Falling Window gaps are rendered in distinct colors — a cool green-family tone for bullish windows and a warm red-family tone for bearish windows — allowing immediate visual differentiation from the four classified smart gap types. Window gaps receive the same probability scoring and session filtering treatment as classified gaps, and their boxes are extended forward by a separately configurable extension value.
● Island Reversal Boxes and Labels
When an Island Reversal pattern is confirmed, the isolated price cluster is enclosed in a box spanning from the cluster's leftmost bar to the breakaway gap bar. The box is colored green for bullish Island Bottoms and red for bearish Island Tops, with high transparency to preserve chart legibility. A text label reading "ISLAND REV" is positioned above or below the box, color-matched to the pattern direction, and offset vertically by one ATR unit to prevent label overlap with the cluster's price range.
● Mirror Gap Labels
When the Mirror Gap Detector identifies a symmetry pairing, a small label reading "⟷ Mirror" is placed at the level of the newer gap. The label style is a downward-pointing callout, with a deep background color and a lavender-family text color chosen to stand out from standard gap box labels without competing visually with classification labels.
● Session Overlap Borders
Gaps detected during the London–New York overlap receive a bright cyan-family border. Gaps detected during the Asia–London overlap receive a bright violet-family border. The border width is elevated to two pixels to ensure the session overlap designation is visible even when multiple boxes occupy adjacent price ranges.
● Session-Specific Borders
When the session filter is active, each gap box receives a thin border in the color of the session during which it was formed: a soft violet for Asia, a sky blue for London, and a warm amber for New York. This border appears independently of the session overlap amplifier borders, stacking visually to indicate both origin session and overlap status when applicable.
● IPO Lines (Session Open Price Tracker)
Each tracked session open price is rendered as a dashed horizontal line in the color corresponding to the session that produced it: violet-adjacent for Asia, sky-adjacent for London, amber-adjacent for New York. Lines extend forward from the moment of the session open and expire after the configured number of bars. When an IPO line falls within an active gap zone, that gap's border is replaced with a bright white-adjacent line at elevated width, and the box text is updated to include the "IPOxGAP" marker.
● Higher-Timeframe Gap Boxes
HTF gap zones are rendered with a dashed border in a neutral gray-family color, distinguishing them from solid-bordered current-timeframe boxes. The fill uses a higher transparency level to allow current-timeframe content to remain visible through the HTF overlay. A yellow text label within each HTF box identifies the gap type and its timeframe origin with an " " suffix.
● Unified Dashboard
The dashboard panel anchors to a user-selected screen corner and displays a structured table of real-time information. Rows include: current trend bias with directional label and color, the type and direction of the most recently detected gap, the top and bottom price levels of the most recent gap formatted to tick precision, the current ATR value, the count of active standard gaps and window gaps with inline bar-graph fill indicators, the current alert tier, the count of active higher-timeframe gaps, and the structural pivot bias state. A footer row displays the indicator version and copyright.
● Gap Cluster Heatmap Panel
Appended below the dashboard rows, the heatmap panel renders one row per price bin. Each row displays the bin's midpoint price, a bar-graph fill indicating the density of gap-derived levels within that price range, and a numeric count. High-density bins use warm red-family text; mid-density bins use amber; low-density bins use blue. The bin containing the current price receives a highlighted teal background to anchor the user's attention to the current market position within the density distribution.
● Trend Bias Engine Panel
When enabled, a separate compact panel in the top-left corner of the screen displays the composite bias score as a directional arrow (⬆ for bullish, ⬇ for bearish, ↔ for neutral) followed by the numeric score expressed as a percentage. The text color shifts between teal (bullish conviction), red (bearish conviction), and gray (neutral). The panel has a dark background and teal border to distinguish it from the main dashboard.
📖 How to Use
● Initial Configuration
Begin by loading the indicator on your preferred chart and timeframe. Navigate to the Smart Gap: Filters group within the settings panel and configure the Structure Lookback Left and Right values to match the granularity of structure you wish to detect. Shorter lookback values produce more frequent pivot identifications on faster-moving instruments; longer values filter to only the most significant swing highs and lows. Set the Volume Avg Length and Volume Spike Multiplier to values appropriate to your instrument's typical volume behavior — most major instruments perform well with the default settings.
● Gap Zone Interpretation Workflow
When a new gap box appears on the chart, first read its classification label. An SBG appearing at a major structural level, confirmed on higher timeframes, and carrying a Tier A alert designation represents the highest-confidence context the indicator can produce. An RA or EX gap in isolation, without structural alignment, carries a lower baseline weight. Next, observe the box's Magnet Probability Score. A freshly formed gap will typically carry a moderate score reflecting its proximity to current price; this score will evolve as bars pass and price either approaches or retreats from the zone. High scores on aged zones that have survived multiple tests without being filled indicate unusually strong supply or demand imbalance.
● Multi-Timeframe Workflow
Enable the HTF overlay and select a timeframe one or two steps above your current chart (for example, use the daily chart if you trade on the one-hour). When an HTF gap box appears on the screen, any current-timeframe gap that forms within the same price range as an HTF box carries confluence from both timeframes. These dual-timeframe confluence zones are among the highest-weight configurations the indicator can identify.
● Session Open Price Workflow
Enable the IPO Lines option and configure which sessions are relevant to your instrument. On pairs or instruments with well-defined session dynamics (major forex pairs, equity index futures), session open prices frequently act as reference levels that attract price revisitation. When an IPO line falls within an active gap zone, the resulting "IPOxGAP" marker flags a configuration where a session reference level and an unresolved imbalance occupy the same range — a particularly high-confluence setup for entries in the direction aligned with current structural bias.
● Trend Bias Engine Workflow
Enable the Trend Bias Engine to generate a composite directional reading from the full landscape of active gaps, structural pivots, and price position. When the bias score reads strongly bullish (above +33) and a bullish breakaway or continuation gap forms, this represents alignment between the gap classification system and the aggregate market structure model. When the bias reads neutral or contradicts a gap's direction, reduce position size or wait for the bias to confirm.
● Alert Tier System Workflow
Enable the Alert Tier System and configure your webhook action string in the Alert Action input field. Set up TradingView alerts using the three named alert conditions — Tier A, Tier B, and Tier C — sending each to your automation platform. Tier A alerts may be configured for automated entry consideration; Tier B alerts for manual review; Tier C alerts for awareness and context only. The JSON payload included in each webhook contains the ticker, timeframe, gap direction, gap type, alert tier, and entry price, formatted for direct consumption by algorithmic execution systems.
● Gap Merge Engine Workflow
Enable the Gap Merge feature when trading instruments with high gap frequency or when multiple session types produce overlapping zones. Merged zones display a combined label listing all constituent gap types (e.g., "SBG + RW") and represent a price range where multiple independent gap events have produced coincident imbalance. These merged zones carry compounded analytical weight relative to either gap type in isolation.
● Heatmap Reading
Scan the Gap Cluster Heatmap section of the dashboard to identify price bins with peak density. These "Super Magnet Zones" represent price areas where the aggregate collection of currently tracked gaps — from all sources and timeframes — is most concentrated. When price approaches a high-density heatmap bin from either direction, consider it a high-probability interaction zone for potential support, resistance, or reversal behavior.
⚙️ Inputs and Settings
Island: Configuration
Trend Lookback — Defines the period used to assess the prevailing trend condition relative to which Island Reversal patterns are evaluated. Longer values capture broader trend context; shorter values are more responsive to recent price behavior.
Volume Spike Factor — The multiplier applied to average volume when determining whether a gap associated with an Island Reversal formation qualifies as a volume spike. Higher values require more extreme volume confirmation.
Max Island Duration (Bars) — The maximum number of bars the system will monitor an active island formation before invalidating the pattern. Formations that exceed this duration are abandoned regardless of their current state.
Smart Gap: Filters
Min Gap Size (Points) — The minimum price range a gap must span to be processed. Gaps smaller than this threshold are ignored entirely. Useful for filtering micro-gaps on low-resolution charts.
Structure Lookback Left — The number of bars to the left of a candidate structural pivot used in the pivot identification process. Controls how significant a pivot must be relative to its left-side context.
Structure Lookback Right — The number of bars to the right of a candidate structural pivot used in the confirmation process. Larger values require more confirmed right-side context before a pivot is accepted.
Volume Avg Length — The period over which average volume is calculated for use in gap volume spike detection.
Volume Spike Multiplier — The multiple of average volume a bar must exceed for its associated gap to qualify as volume-confirmed.
Trend Maturity (Bars) — The minimum number of bars that must have elapsed since the most recent structural pivot for a gap to qualify as an Exhaustion classification. Prevents premature Exhaustion labeling early in a trend.
Max Visible Gaps — The maximum number of standard gap zones retained on the chart simultaneously. When this limit is reached, the oldest zones are removed as new ones are detected.
Box Extension — The number of bars by which standard classified gap boxes are extended forward to the right of the detection bar.
Window Gap Box Extension — The number of bars by which Rising and Falling Window gap boxes are extended forward.
Enable Gap Merge — Activates the gap merge engine, which consolidates overlapping or adjacent gap zones both within and across gap pools.
Gap Merge Tolerance (Points) — The maximum price-distance separation between two gap zones that still qualifies them for merging. A value of zero restricts merging to zones that directly overlap.
Smart Gap: Vol Delta
Enable Vol Delta Filter — Activates an additional directional volume filter that evaluates the balance of buying versus selling pressure within the bar associated with each gap. When enabled, a gap must reflect directionally consistent volume pressure to be classified.
Min Imbalance Ratio — The minimum directional volume imbalance ratio required to pass the volume delta filter. Values above the midpoint threshold require progressively stronger directional volume alignment.
Gap Symmetry Index
Enable Mirror Gap Detector — Activates the symmetry detection engine that identifies gap pairings of opposite direction with near-equal size and proximate price levels.
Size Tolerance (ATR mult) — The maximum difference in size between two gaps, expressed as a multiple of the current ATR, for them to qualify as a mirror pairing. Smaller values require tighter size matching.
Level Proximity (ATR mult) — The maximum distance between the midpoints of two candidate mirror gaps, expressed as a multiple of ATR. Smaller values require the gaps to be closer in price.
Smart Gap: Session Filter
Enable Session Filter — When active, restricts the display of gap zones to only those formed during the permitted sessions defined below.
Show Asia Gaps — Permits gaps formed during the Asia session to be displayed when the session filter is active.
Show London Gaps — Permits gaps formed during the London session to be displayed when the session filter is active.
Show NY Gaps — Permits gaps formed during the New York session to be displayed when the session filter is active.
Trend Bias Engine
Enable Trend Bias Engine — Activates the composite directional bias scoring system and displays the bias panel in the top-left corner of the screen.
Alert Tier System
Enable Alert Tier System — Activates the multi-tier alert classification engine and enables the webhook-ready JSON alert payload system.
Alert Action — A user-defined string injected into the JSON payload as the "action" field. Used to route alerts to the correct handler within an external automation system (e.g., "buy", "sell", "gap").
IPO Lines
Enable IPO Lines — Activates the session opening price tracker.
Track Asia Open — When enabled, the Asia session opening price is tracked and displayed as a dashed line.
Track London Open — When enabled, the London session opening price is tracked and displayed as a dashed line.
Track NY Open — When enabled, the New York session opening price is tracked and displayed as a dashed line.
IPO Line Max Bars — The number of bars each session opening price line remains visible before expiring automatically.
Dashboard
Show Dashboard — Toggles the unified dashboard and heatmap panel on and off.
Position — Selects the screen corner to which the dashboard is anchored: Top Right, Top Left, Bottom Right, or Bottom Left.
Gap Cluster Heatmap
Price Bins — Defines the number of equal-width price bins into which the heatmap distributes all active gap-derived levels. More bins provide finer granularity; fewer bins consolidate density into broader ranges.
Session Overlap Amplifier
Enable Session Overlap Amplifier — Activates visual amplification for gaps detected during session overlap windows.
London-NY Overlap — When enabled, gaps detected during the London–New York overlap window receive the corresponding border treatment.
Asia-London Overlap — When enabled, gaps detected during the Asia–London overlap window receive the corresponding border treatment.
Smart Gap: Multi-Timeframe
Show Higher Timeframe Gaps — Activates the multi-timeframe gap overlay and requests classified gap data from the selected higher timeframe.
Higher Timeframe — The timeframe from which gap data is sourced for the HTF overlay. Any standard TradingView timeframe is supported.
Smart Gap: Visuals
Breakaway Gap (Start) — Fill color for Structural Breakaway Gap zones.
Continuation Gap (BOS) — Fill color for Structural Continuation Gap zones.
Runaway Gap (Middle) — Fill color for Runaway Gap zones.
Exhaustion Gap (End) — Fill color for Exhaustion Gap zones.
Bullish Window Color — Fill color for Rising Window gap zones.
Bearish Window Color — Fill color for Falling Window gap zones.
Mirror Gap Label Color — Text color of the Mirror Gap symmetry label.
Asia Border Color — Border color applied to gap boxes formed during the Asia session.
London Border Color — Border color applied to gap boxes formed during the London session.
NY Border Color — Border color applied to gap boxes formed during the New York session.
Asia IPO Line — Color of the Asia session opening price line.
London IPO Line — Color of the London session opening price line.
NY IPO Line — Color of the New York session opening price line.
HCZ Border (IPOxGAP) — Border color applied to gap zones that contain an active session opening price level.
Density Low — Text color used in heatmap bins with low gap-level density.
Density Mid — Text color used in heatmap bins with medium gap-level density.
Density High — Text color used in heatmap bins with high gap-level density.
Label Color — Default text color for heatmap price labels.
Background — Background color of heatmap rows.
London-NY Border Color — Border color applied to gaps detected during the London–New York session overlap.
Asia-London Border Color — Border color applied to gaps detected during the Asia–London session overlap.
HTF Box Border — Border color of higher-timeframe gap zone boxes.
HTF Text Color — Text color of labels within higher-timeframe gap zone boxes.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Auction Market Theory and Price Gap Formation
The conceptual foundation of Smart Gap Concepts Pro is rooted in Auction Market Theory as formalized through the Market Profile work of J. Peter Steidlmayer and elaborated by James Dalton in "Mind Over Markets." Auction Market Theory posits that price moves are the expression of ongoing auctions between buyers and sellers seeking to establish value. A price gap — defined as a range of price at which no transactions occur between two consecutive periods — represents a failure of the auction process: one side of the market moved so decisively that no counterparty was willing to engage at any price within that range. This failure to facilitate trade creates what Steidlmayer described as an "unfair price area" — a zone that the market is statistically likely to revisit as the auction seeks to resolve the uncompleted trade facilitation. The indicator's gap zone tracking system directly operationalizes this concept, maintaining each unresolved gap as an active reference zone until price returns to validate or fill it.
● Structure-Based Gap Classification and the Wyckoff Method
The classification of gaps relative to structural pivot events draws directly from the analytical lineage of Richard Wyckoff's Method of Reading the Tape, later systematized within the Smart Money Concepts framework. Wyckoff identified specific phases of market accumulation and distribution cycles, within which price movement relative to prior swing highs and lows carried diagnostic significance. A gap that coincides with the penetration of a prior swing high — particularly on elevated volume — is understood within this framework as a Sign of Strength: evidence of institutional accumulation breaking through supply. The Structural Breakaway and Structural Continuation Gap classifications within this indicator directly reflect this analytical tradition, incorporating structural pivot violation as a necessary condition for the highest-tier gap classification. The distinction between a Change of Character (first break against the prior trend, interpreted as tentative) and a Break of Structure (continuation of the emerging trend, interpreted as confirmation) reflects the nuanced reading of market phase transitions that Wyckoff analysis demands.
● Volume Analysis and the Kyle (1985) Market Impact Framework
The volume qualification filters embedded in the gap detection logic are informed by Albert Kyle's 1985 landmark paper "Continuous Auctions and Insider Trading," which formalized the relationship between trade size, price impact, and information content. Kyle's lambda — a measure of the price sensitivity of the market to order flow — provides the theoretical basis for the interpretation of volume spikes accompanying gap events. A gap formed on anomalously high volume is, within this framework, evidence of a large, informed order flow event that caused a permanent relocation of price rather than a transient liquidity imbalance. The volume spike multiplier input operationalizes this concept by requiring that the volume accompanying a gap exceed a configurable multiple of the recent rolling average. The Volume Delta filter further refines this by evaluating the directional composition of volume — distinguishing between gaps produced by balanced high volume (ambiguous) and gaps produced by directionally skewed volume (high information content).
● Exhaustion Gap Theory and Trend Duration Analysis
The Exhaustion Gap classification within this indicator corresponds to the analytical concept documented by Thomas Bulkowski in "Encyclopedia of Chart Patterns" and by Edwards and Magee in "Technical Analysis of Stock Trends" — a gap that appears in the terminal phase of a trend following an extended directional run, typically accompanied by climactic volume. Academic research on price momentum and mean reversion provides a complementary framework: Jegadeesh and Titman's work on return reversals following extended momentum periods demonstrates that trend continuation probabilities decrease as the trend matures. The Trend Maturity input implements this concept by requiring a minimum elapsed time since the most recent structural anchor before a gap can receive the Exhaustion classification, filtering out premature exhaustion labeling in early-stage trend moves.
● Japanese Candlestick Window Patterns and Eastern Technical Tradition
The Rising Window and Falling Window classifications are direct implementations of the candlestick gap concepts documented by Steve Nison in "Japanese Candlestick Charting Techniques," adapted from centuries of Japanese rice market trading practice. In the Eastern technical tradition, a window (Ma in Japanese) is understood not merely as a price gap but as a zone of tested support or resistance carrying cultural and psychological weight for practitioners of this methodology. The integration of window gap tracking into the same detection and scoring framework as Western structural gap analysis creates a synthetic multi-tradition view of price gap significance.
● Island Reversal Patterns and Exhaustion Theory
The Island Reversal detection engine implements the pattern as defined in classical Western technical analysis literature, most rigorously treated in the work of Harold McKinley Gartley and subsequently by John Murphy in "Technical Analysis of the Financial Markets." The Island Reversal is understood as a manifestation of exhaustion theory: a cluster of price activity that has become suspended between two opposing gaps represents a market that briefly escaped its prior trend context, was rejected at the extremes, and then re-engaged the prior trend through the closing gap event. The volume requirements applied to both the opening and closing gaps within the indicator's Island Reversal engine reflect the classical interpretation that both events must carry institutional-grade conviction for the pattern to carry predictive weight.
● Probability Scoring and Behavioral Finance
The Magnet Probability Scoring system embedded in each gap zone draws theoretical support from behavioral finance research on the "magnetic" properties of prominent price levels. The research of Lo and MacKinlay (1988) on price dependencies in equity markets and the subsequent work documenting the predictability of price returning to high-volume or structurally significant levels underpins the multi-factor scoring model. The three components of the score — proximity, age, and touch count — correspond to three distinct behavioral phenomena: the gravitational pull of price toward unfilled imbalance zones, the increasing significance of zones that survive multiple bars without resolution, and the reinforcement of zone significance through repeated price interaction.
● Gap Symmetry and Market Microstructure
The Mirror Gap Detector operationalizes concepts from market microstructure theory, specifically the notion of equilibrium price discovery. Research by Madhavan (2000) in "Market Microstructure: A Survey" and by O'Hara in "Market Microstructure Theory" documents the tendency of markets to establish equilibrium zones that are tested from multiple directions before a durable price level is established. Two gaps of opposing direction and near-equal size at proximate price levels represent the market's repeated reference to the same value area from both sides of the auction — a microstructural indicator of zone significance that transcends any single directional interpretation.
● Session Dynamics and the London Fix Effect
The session filter and session overlap amplifier are grounded in the well-documented academic and practitioner literature on intraday seasonality in financial markets. Research by Andersen and Bollerslev (1998) on intraday periodicity in volatility documents the systematic clustering of significant price moves at and around major session transitions. The London–New York overlap in particular is widely recognized as the highest-liquidity, highest-volatility window in the global foreign exchange and equity index futures markets. Gaps that form during this window are therefore produced in a price discovery environment with maximum participant diversity, lending them greater analytical weight than gaps formed in illiquid overnight sessions.
● Tiered Alert Architecture and Information Hierarchy
The three-tier alert classification system reflects the Grinold and Kahn framework from "Active Portfolio Management," which distinguishes between signals of varying information coefficient. A Tier A alert represents a convergence of multiple independent signal sources — structural confirmation, volume validation, session reference price interaction, and higher-timeframe agreement — analogous to a high-IC signal in the Grinold-Kahn framework: one where the probability of the signal reflecting genuine alpha is materially higher than baseline. Tier B and Tier C alerts correspond to progressively lower signal-to-noise environments. The tiered architecture allows practitioners to calibrate position sizing and execution urgency to the conviction level of each detected event.
⚠️ Disclaimer
This indicator is provided strictly for educational and informational purposes. Nothing produced by this tool constitutes financial advice, investment advice, trading advice, or a recommendation to buy or sell any financial instrument. All outputs are analytical aids intended to support a trader's independent decision-making process and do not guarantee any specific trading outcome. Past patterns and historical gap behavior do not guarantee future results. Trading financial instruments carries substantial risk of loss. We expressly disclaim all liability for any trading losses, financial damages, or other consequences arising directly or indirectly from the use of this indicator or any reliance placed upon its outputs. Users assume full and sole responsibility for all trading decisions made in connection with this tool. Always conduct your own research and consult a qualified financial professional before making any trading or investment decision. Dual-Axis Volume Pro [MarkitTick] 💡 There are volume analysis tools, and then there are instruments of genuine market intelligence. Dual-Axis Volume Pro is the latter — a dual-dimensional volume analysis system that fuses two historically separate domains of market study into a single, cohesive framework. Where conventional volume tools ask traders to choose between understanding *where* volume accumulates across price levels and *when* it concentrates across time, this indicator dissolves that choice entirely. It operates simultaneously along both axes of the chart — price and time — revealing the full topography of market participation in a way that neither dimension alone can express. The result is a tool that does not merely display volume data; it interprets it, structures it, and anchors it to the precise moment in market structure where that interpretation carries the most analytical weight.
✨ Originality and Utility
● A Framework Built on Structural Awareness
Most volume profile tools treat the anchor point — the starting boundary of the analysis window — as a user-configured constant. The trader picks a date, and the profile renders from that point forward. This approach places the burden of structural judgment entirely on the human. Dual-Axis Volume Pro inverts this paradigm. Its auto-anchor engine monitors market structure in real time across a selectable timeframe, and resets the volume accumulation window automatically each time the market confirms a Change of Character — the moment price breaks through the most recently established swing extreme and shifts the directional bias of the trend. The profile does not merely display volume from an arbitrary point; it displays volume from the point that the market itself identified as structurally significant. This alignment between structural events and volume measurement is the core intellectual contribution of the indicator, and it is one that no standard volume profile implementation provides.
● Dual-Axis Integration
The second dimension of the framework — the vertical volume overlay — adds a temporal perspective that horizontal volume profiles intrinsically cannot provide. The horizontal profile reveals price acceptance; the vertical overlay reveals time-based participation intensity. When these two perspectives are rendered simultaneously and anchored to the same structural event, traders gain a read on not just what price levels attracted volume, but which bars within the profile window were responsible for that volume — and whether those bars cluster in a way that suggests consolidation, momentum, or exhaustion. This dual-axis synthesis is what separates the indicator from any single-axis tool currently available in the public domain.
● Structural Regime Adaptability
Traders operate across radically different market contexts — scalping intraday swings, managing multi-day positional trades, or evaluating weekly structural cycles. The indicator accommodates all of these use cases through a dual swing-detection regime: a Micro mode that tracks short-cycle structure with sensitivity to minor price swings, and a Macro mode that filters to larger, higher-conviction structural pivots. Both modes drive the same anchor logic, the same profile accumulation engine, and the same visual output, giving the indicator consistent analytical behavior across trading styles without requiring the trader to manage separate tools.
● Analytical Depth Through Zone Classification
Volume data alone is descriptive. Dual-Axis Volume Pro transforms that raw description into market structure classification. Price levels within a volume profile are not equal; some represent areas of broad agreement and active participation, while others represent price zones the market crossed in haste — gaps in volume distribution that denote institutional exhaustion or structural resistance. The indicator surfaces these distinctions automatically, classifying horizontal price bands into consolidation zones (areas of volume clustering), exhaustion highs (resistance tails), and exhaustion lows (support tails), with each class rendered distinctly so traders can read the market's opinion at a glance.
🔬 Methodology and Concepts
● Change of Character (CHoCH) Detection
The foundational trigger for the indicator's auto-anchor system is the Change of Character — a structural event defined by price confirming a breach of the most recently established swing extreme in the direction opposite to the prevailing trend. When the market is in a bearish structural state and price closes above the most recent confirmed swing high, a bullish CHoCH is recognized. When the market is in a bullish structural state and price closes below the most recent confirmed swing low, a bearish CHoCH is recognized. Each confirmed CHoCH triggers a reset of the volume accumulation window, anchoring the new profile to the structural swing that defined the breakout origin. This ensures that the volume profile always reflects the market's activity since the last meaningful structural shift — not since an arbitrary calendar date.
● Swing Point Identification
The indicator evaluates price structure using a configurable swing detection methodology. In Micro mode, the system identifies minor swing highs and lows using a compact lookback window suited to intraday and short-term analysis. In Macro mode, the lookback window is expanded significantly, causing the system to recognize only major structural pivots — the kind that define multi-day or multi-week market cycles. In both cases, swing detection is performed on confirmed, closed bars, and the CHoCH evaluation uses the prior bar's confirmed closing price as the structural reference. This design prevents the anchor from being set on the basis of intrabar price fluctuations that may not survive to bar close, eliminating a common source of phantom signal generation in live trading environments.
● Multi-Timeframe Structural Analysis
The structural evaluation — swing detection and CHoCH confirmation — can be conducted on a timeframe independent of the chart's native resolution. When a higher structure timeframe is selected, the indicator reads price structure from that timeframe while rendering volume data on the chart's native resolution, allowing traders to align their volume accumulation windows with the structural context of a higher time horizon. This multi-timeframe capability means that a trader viewing a 5-minute chart can anchor their volume profile to structural events defined on the 1-hour or 4-hour timeframe — a configuration that meaningfully improves the relevance of the profile's analytical output for directional decision-making.
● Volume Profile Construction
Once an anchor is established, the indicator accumulates raw volume data from a resolution optimized for the span of the active profile window. The price range of the accumulated bars is divided into a configurable number of horizontal price bands — called rows or slots — spanning from the profile's lowest observed price to its highest. Each bar's volume is distributed across the slots it overlaps, proportional to the fraction of that bar's price range falling within each slot. This produces a horizontally oriented histogram in which each bar's height represents the relative volume transacted at that price level across the profile's full duration.
● Point of Control (POC)
The Point of Control is the single price slot within the profile that attracted the greatest volume over the measurement window. It represents the price level at which the market reached the highest degree of transactional agreement — the price both buyers and sellers were most willing to accept during the period. A POC near the current market price suggests the market is trading within its area of highest acceptance. A POC far from the current price suggests the market has migrated away from its prior equilibrium, which can carry directional implications depending on the direction of that migration.
● Value Area
The Value Area defines the price range within which a configurable percentage of total profile volume was transacted — defaulting to 70%. It is bounded by a Value Area High and a Value Area Low. The Value Area represents the market's negotiated zone of fair value for the profile period; the majority of participants transacted within this range. Price trading above the Value Area High suggests premium pricing; price trading below the Value Area Low suggests discount pricing. Expansions or contractions of the Value Area Width reveal whether the market's conception of fair value is broadening or narrowing over the profile window.
● Volume Consolidation Groups (HVN Zones)
Within the volume profile, consecutive price slots each registering volume above a statistically derived threshold are classified as consolidation groups — regions of the price distribution where transactional density clusters into a coherent band. Groups that overlap with the Value Area are classified as High Volume Nodes (HVN), reflecting zones of broad participation and expected price stability. Groups that fall outside the Value Area are classified as imbalance zones — areas of elevated activity occurring outside the market's primary fair value range, which can act as reference levels for future price behavior. The dominant group within each category receives distinct visual emphasis.
● Volume Exhaustion Gaps (EXH and EXL Zones)
At the extremes of the volume distribution — above the profile's primary transactional body toward the high, and below it toward the low — the indicator identifies consecutive price slots where volume falls at or below a low-percentile threshold. These gaps represent price levels the market moved through rapidly, with minimal transactional interest. Those at the upper extreme are classified as Exhaustion Highs (EXH) and reflect resistance zones where buying conviction was insufficient to attract sustained participation. Those at the lower extreme are classified as Exhaustion Lows (EXL) and reflect support zones where selling conviction similarly failed to sustain volume. EXH and EXL zones are among the most actionable outputs of the profile, as they define the price levels where the market demonstrated the lowest conviction in its prior directional move.
● Vertical Volume Overlay
The vertical volume display renders the volume of each individual bar within the active profile window as a vertical bar extending upward from the top of the horizontal profile. This temporal dimension of volume measurement reveals which specific bars — not which price levels — attracted the most participation during the profile period. High-volume bars in the early portion of a profile may indicate the impulsive phase of a structural move; high-volume bars clustered near the end may indicate accumulation or distribution near the profile's price extreme. The single bar within the profile window with the highest volume receives special visual emphasis, marking the moment of peak temporal participation.
● Vertical Volume Groups and Gaps
The same structural classification logic applied to horizontal volume slots is also applied to the vertical volume series. Consecutive high-volume bars are grouped into temporal consolidation zones, rendered as boxes above the profile body. Consecutive low-volume bars at the temporal extremes of the profile are classified as exhaustion tails — periods of the profile window during which the market moved with minimal conviction. This parallel classification between the horizontal and vertical dimensions creates a two-axis view of where and when the market was most and least committed.
● POC Dominance Score
The dashboard surfaces a normalized measure of how concentrated the profile's total volume is within the POC slot. A high dominance score indicates a sharply peaked volume distribution — the market agreed strongly on a narrow price range. A low dominance score indicates a flat distribution — volume was spread broadly across the profile's price range, suggesting less conviction and potentially greater price instability. This score is rendered as a visual progress bar scaled from zero to ten for rapid interpretive access.
● Value Area Width Score
A second normalized dashboard metric measures the Value Area's width as a percentage of the total profile price range. A narrow Value Area Width indicates that the market's fair value consensus was concentrated in a small fraction of the profile's total price span — a sign of tight market agreement. A wide Value Area Width indicates that participation was broadly distributed across a large fraction of the price range — a sign of range expansion and less defined equilibrium.
● Anchor Age
The dashboard reports the number of confirmed bars elapsed since the current anchor was set. This metric reveals how mature the active profile is. Young profiles — set on a recent CHoCH — are still accumulating volume and may not yet have developed statistically meaningful distribution features. Mature profiles — those that have accumulated volume across many bars — are more likely to reflect stable, reliable market structure.
● Data Buffer Utilization
The indicator continuously monitors the volume of lower-timeframe data accumulated in its internal buffer, expressed as a normalized score. This metric serves as a system health indicator, informing traders when the buffer is approaching its practical limit and the profile's internal data density is at maximum capacity.
🎨 Visual Guide
● Horizontal Volume Profile Bars
The volume profile renders as a series of horizontal boxes extending rightward from the profile's start time. Each box represents one price slot. The width of each box is proportional to the volume transacted at that price level relative to the POC — the widest box always represents the POC slot. Boxes are colored using a gradient that transitions from a lighter, more transparent shade for low-volume slots to a richer, more opaque shade for high-volume slots. The POC slot receives a distinct fill to mark it unambiguously as the highest-volume level. An outer bounding box with a subtle background fill encompasses the full price range of the profile, providing a clean visual boundary.
● POC Label
A text label reading "POC" is centered within the POC slot's box when text display is enabled, making the Point of Control immediately identifiable without requiring the trader to infer it from bar widths alone.
● Percentage and Volume Labels
When text display is active, each slot — or each group/gap zone — carries a label showing either the percentage of total profile volume that the slot represents, or the raw volume figure, depending on user preference. These labels are rendered in a light tone against the profile's dark background, calibrated for legibility at standard chart zoom levels.
● Consolidation Group Boxes
Volume consolidation groups are rendered as filled boxes spanning the price range of the group across the full horizontal width of the profile. Groups within the Value Area receive a blue-tinted fill aligned with the profile's primary color theme. Groups outside the Value Area receive an amber fill that marks them as imbalance zones. Each group box is bordered to distinguish it from standard slot bars. A tag label at the left edge of each group reads "POC," "HVN," or "IMB" depending on the group's classification, with a secondary label at the group's vertical midpoint showing the group's volume share.
● Exhaustion Gap Zones
Exhaustion High zones are rendered with a translucent red fill, and Exhaustion Low zones with a translucent teal fill. Each gap zone is labeled at its midpoint with its volume percentage or raw figure, and tagged at the left edge with "EXH" or "EXL" respectively, using colors that mirror the zone's fill for immediate contextual clarity.
● Extended Zone Projections
When the zone extension option is enabled, each consolidation group and exhaustion gap zone is additionally rendered as a separate box extending from the profile's right boundary to the right edge of the visible chart, projecting the price band of each structural zone forward in time. This allows traders to use group and gap boundaries as prospective reference levels without manually drawing lines.
● Vertical Volume Bars
Above the horizontal profile body, a series of vertical lines rises from a baseline set at the top of the profile's price range. Each line corresponds to one lower-timeframe bar within the active profile window. Line height encodes volume magnitude, scaled to a configurable percentage of the total profile price range. Standard bars are rendered in blue; the single bar with the highest volume is rendered in a distinct amber or gold tone and drawn with a heavier line weight, marking the moment of peak temporal participation.
● Vertical Volume Group and Gap Boxes
When temporal grouping is active, individual vertical lines are replaced by filled rectangular boxes spanning each temporal consolidation group. The dominant group — the cluster of consecutive high-volume bars with the greatest aggregate volume — receives an accent-colored border and fill matching the dominant bar color. Temporal exhaustion tails at either end of the profile's time span receive translucent red or teal fills mirroring the horizontal gap classification scheme. Each box and gap is labeled with its percentage or raw volume contribution.
● Embedded Dashboard Table
A fixed-position table anchored to the upper-right corner of the chart displays eight live metrics in a two-column layout: a label column on the left and a value column on the right. Alternating row backgrounds in deep navy tones with controlled transparency reduce visual fatigue. Row zero carries a header identifying the indicator and the active symbol and timeframe. Rows one through eight display the eight dashboard metrics described above. Bar-chart-style progress indicators rendered in Unicode block characters provide visual encoding of normalized scores at a glance.
● Color Coding of Dashboard Values
Normalized score values — POC Dominance and Value Area Width — are colored on a four-tier scale: scores above seven render in bright green, indicating a strong or concentrated reading; scores from four to seven render in lime, indicating a moderate reading; scores from one-and-a-half to four render in amber, indicating a weak reading; scores below one-and-a-half render in neutral gray, indicating a negligible or near-zero reading. This consistent color gradient allows traders to assess the intensity of any scored metric without reading the numeric value.
📖 How to Use
● Initial Configuration
Upon adding the indicator to a chart, the first decision point is the anchor mode. Traders who wish to follow market structure automatically — the recommended configuration — should leave the manual anchor disabled and select between Micro mode for short-cycle trading or Macro mode for larger structural timeframes. Traders who need to analyze a specific historical period — for example, the volume distribution during a prior earnings release or a defined macro event window — should enable the manual anchor and configure the start and end dates accordingly.
● Selecting the Structure Timeframe
The structure timeframe input determines the resolution at which swing detection and CHoCH evaluation occur. Leaving it empty applies analysis on the chart's native timeframe. Setting it to a higher value — for example, using a 15-minute chart but setting the structure timeframe to 1 hour — causes the indicator to recognize structural events at the larger timeframe scale, producing profiles anchored to more significant market turning points. This configuration is particularly useful for traders who want lower-resolution chart detail but higher-resolution structural context.
● Reading the Profile
The widest slot in the horizontal profile identifies the POC — the highest-conviction price level. The outer boundaries of the profile's VA-shaded group zones define the Value Area. Slots or groups rendered outside the Value Area in the amber imbalance style represent price levels where the market transacted actively but at a pace inconsistent with its primary equilibrium — these are the levels to watch for potential structural reactions. Red gap zones above the profile body and teal gap zones below it mark the price levels the market moved through most quickly, where the fewest participants committed volume. These extremes frequently define the natural boundaries of structural reversals.
● Reading the Vertical Volume Overlay
Scan the vertical bars or temporal group boxes above the horizontal profile. If the dominant bar or dominant group appears in the early portion of the profile window, it suggests that the highest conviction occurred at the moment of the structural event — consistent with an impulsive move. If it appears in the later portion, it suggests renewed participation as the price approached its current level — consistent with accumulation or distribution behavior. Temporal exhaustion tails at either end of the vertical overlay indicate periods during the profile window where the market moved without meaningful participation, which can corroborate the significance of the horizontal exhaustion gaps at the same structural extreme.
● Using the Dashboard
Monitor the Structure row for the current market structural bias. Monitor the Anchor Age row to assess profile maturity; treat young profiles with more caution than mature ones. Track the POC Price row to identify the current equilibrium level. Use the POC Dominance score to assess whether the market is focused or distributed: a high score suggests the market is highly biased toward a single price level, which can indicate a strong reference point for mean-reversion setups. Use the Value Area row to assess whether the market's fair value band is narrow or broad, informing expectations about near-term range behavior.
● Combining Dimensions
The most powerful analytical configurations pair the horizontal and vertical outputs. When a horizontal HVN group aligns with a temporal consolidation cluster in the vertical overlay — meaning the market was both price-focused and time-focused in the same zone — the resulting level carries compound structural significance. When a horizontal EXH gap aligns with a temporal exhaustion tail, the case for treating that price extreme as a high-probability reaction zone is reinforced. These dual-axis confluences represent the core analytical use case of the indicator.
● Profile Extension
The "Extend Profile to Present" toggle controls whether the profile's right boundary advances with each new bar or terminates at a fixed end date. In auto-anchor mode, extension is typically left enabled, allowing the profile to grow continuously until the next CHoCH resets it. In manual mode, disabling extension and setting an explicit end date allows precise historical window analysis.
⚙️ Inputs and Settings
● 🛠️ Calculation Mode
Enable Manual Anchor — When active, the auto-CHoCH detection system is bypassed entirely. The profile begins at the manually specified start date and optionally terminates at a manually specified end date. Use this setting for event-window analysis or when a specific historical period must be isolated.
Manual Start Date — Defines the precise timestamp at which the manual volume profile begins accumulating data. Only active when Manual Anchor is enabled.
Manual End Date — Defines the timestamp at which the manual profile stops accumulating data. Has no effect when "Extend Profile to Present" is enabled.
Extend Profile to Present — When enabled, the profile's right boundary advances to the current bar on every calculation cycle. When disabled in manual mode, the profile terminates at the specified end date.
● 🔄 Auto Anchor & Structure (MTF CHoCH)
Anchor Mode — Selects between Micro (Minor Swing) and Macro (Major Swing) structural detection regimes. Micro targets shorter, more frequent structural cycles. Macro targets larger, less frequent pivots.
Structure Timeframe — The timeframe on which swing detection and CHoCH evaluation are performed. Leave empty for the chart's native timeframe. Higher values produce anchors based on larger structural events.
Micro Swing Length — Controls the sensitivity of the minor swing detection in Micro mode. Smaller values detect more frequent, shallower swings. Larger values require more confirmation bars and identify more pronounced pivots.
Macro Swing Length — Controls the sensitivity of the major swing detection in Macro mode. Should be set to a value meaningfully larger than the Micro length to ensure Macro mode captures only significant structural pivots.
● 📈 Volume Profile Settings
Show Volume Profile — Master toggle for the entire horizontal volume profile rendering system, including all slots, labels, groups, and gaps.
Use Custom Timeframe — When enabled, the indicator uses the explicitly specified lower-timeframe resolution for volume data collection rather than the automatically selected optimal resolution.
Custom Timeframe — The specific resolution used for volume data collection when the custom timeframe option is active.
Row Size — The number of horizontal price slots into which the profile's price range is divided. More rows increase price resolution but reduce the volume per slot. Fewer rows produce a coarser but statistically more stable distribution.
Profile Width (%) — Controls the maximum horizontal extent of the profile bars as a percentage of the profile's time span. Lower values produce a more compact visual profile; higher values allow bars to extend further rightward.
Show Text & Labels — Enables or disables all volume percentage or raw volume labels within the profile and on group and gap zones.
Show % Values — When enabled, labels display each slot's volume as a percentage of total profile volume. When disabled, raw volume figures are shown instead.
Show Slot Groups (Consolidation Zones) — Enables the detection and rendering of horizontal volume consolidation groups and exhaustion gap zones.
Show Only Groups & Gaps — Suppresses individual slot bars and renders only the consolidated group boxes and gap zones, simplifying the visual output for traders who focus exclusively on structural zone analysis.
Extend Group Zones to Right — Projects each detected consolidation group and exhaustion gap zone as a box extending to the right edge of the chart, providing forward-looking reference levels.
Value Area (%) — Defines the percentage of total profile volume that the Value Area must encompass. The standard academic convention is 70%. Increasing this value expands the Value Area to include more volume; decreasing it produces a tighter, more selective fair value band.
● 🎨 Volume Profile Colors
Standard: Box Color — The base color applied to individual slot bars. The profile's gradient coloring uses transparency variations of this color to encode volume intensity across slots.
Standard: POC Line Color — The color used to distinguish the POC slot and its label from standard slots.
Standard: Text Color — The color applied to percentage and volume labels rendered within the profile.
Imbalance Zone Color — The color applied to consolidation groups and their labels when those groups fall outside the Value Area, identifying them as imbalance zones distinct from the primary HVN coloring.
● 🔲 Embedded Label Style
Box Background Color — The background color of the label boxes used for group volume labels and gap volume labels within the profile.
Gaps: Resistance Text Color — The text and accent color used for Exhaustion High gap labels, indicating resistance zones above the profile body.
Gaps: Support Text Color — The text and accent color used for Exhaustion Low gap labels, indicating support zones below the profile body.
● 📊 Vertical Volume Settings
Show Vertical Volume — Master toggle for the vertical volume overlay. When disabled, no vertical bars, group boxes, or gap zones are rendered above the profile body.
Bar Color — The color applied to standard vertical volume lines in the individual-bar rendering mode.
Dominant Bar Color — The color applied to the single vertical bar with the highest volume within the active profile window, and to the dominant temporal group when grouping mode is active.
Height % of Profile Range — Controls the maximum height of the vertical volume display as a percentage of the total profile price range. Higher values allocate more vertical space to the overlay; lower values keep it compact.
Show VV Groups & Gaps — When enabled, individual vertical bars are replaced by temporal consolidation group boxes and exhaustion tail zones, applying the same structural classification logic to the time dimension as the horizontal profile applies to the price dimension.
Show Raw Volume (not %) — When enabled, labels on the vertical volume display show actual traded volume quantities rather than percentage shares of the total range volume.
● 📊 Dashboard Settings
Background Color — Controls the background fill of alternating dashboard rows, allowing the table's contrast and opacity to be adjusted to match the chart's visual theme.
Text Color — Controls the color of the label text in the left column of the dashboard table.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
The analytical foundations of Dual-Axis Volume Pro are rooted in three converging bodies of academic and practitioner research: market microstructure theory, volume profile analysis as derived from Market Profile methodology, and structural market analysis as formalized in the post-Wyckoff era of price action theory.
The horizontal volume profile component draws its conceptual lineage from J. Peter Steidlmayer's Market Profile framework, originally developed in collaboration with the Chicago Board of Trade in the 1980s. Steidlmayer's foundational insight — that markets are auction mechanisms seeking the price that facilitates the greatest volume of trade — provides the theoretical justification for treating the POC as the market's equilibrium price and the Value Area as its zone of fair value. The academic treatment of this concept was extended by researchers in market microstructure, including the work of Kyle (1985) on information and liquidity, which formalized the relationship between transactional volume and price efficiency. The Value Area, in this framework, can be understood as the empirical manifestation of the market's short-run price discovery equilibrium — the range within which the greatest proportion of informed and uninformed order flow reached agreement.
The classification of volume distribution features into High Volume Nodes and Low Volume Nodes (exhaustion gaps) draws on the auction market theory interpretation of market dynamics, as articulated by practitioners including Dalton, Jones, and Dalton in their seminal work "Mind Over Markets." Within this framework, high-volume nodes represent price levels where the market repeatedly returned — areas of acceptance — while low-volume nodes represent price levels the market rejected and moved through rapidly — areas of rejection. The EXH and EXL classifications within Dual-Axis Volume Pro operationalize this distinction in a quantified, threshold-based manner rather than leaving the identification to subjective visual inspection.
The Change of Character mechanism that drives the auto-anchor system is grounded in the structural market analysis tradition formalized by Charles Dow and extended by twentieth-century practitioners in the Wyckoff and Elliott traditions. The concept that markets define their directional bias through the sequential formation and breach of swing highs and lows — and that a breach of the prevailing structural extreme constitutes a meaningful regime shift requiring analytical reassessment — is a foundational principle of modern price action theory. The auto-anchor system automates this reassessment by resetting the volume measurement window precisely at the point of structural regime change, ensuring that the profile's data window and the market's structural context remain continuously synchronized.
The vertical volume component can be contextualized within the literature on volume and price dynamics, including Lo and Wang's (2000) work on trading volume and the predictability of returns, which demonstrated that volume concentration within specific time intervals carries information about the strength and persistence of price movements. The identification of temporal volume clusters — periods within a profile window where consecutive bars register above-average participation — applies this insight in a direct, visual form: the trader can observe not only which price levels were accepted, but which moments within the structural cycle were characterized by the greatest market conviction.
The normalized scoring system applied to POC Dominance and Value Area Width reflects concepts from statistical distribution analysis. A highly concentrated POC — captured by a high dominance score — corresponds to a leptokurtic (heavy-tailed, narrow-bodied) volume distribution, where the market's agreement is focused at a single price level. A broadly distributed POC — captured by a low dominance score — corresponds to a platykurtic (flat, wide-bodied) distribution, where agreement is diffuse. This framing connects the indicator's dashboard metrics to the broader academic literature on distribution shape and its implications for market stability, liquidity, and mean-reversion potential.
⚠️ Disclaimer
This indicator is provided strictly for educational and informational purposes. Nothing contained within this tool, its outputs, its labels, or its documentation constitutes financial advice, investment advice, or a recommendation to buy or sell any financial instrument. All trading involves substantial risk of loss, and past analytical patterns do not guarantee future price behavior. We expressly disclaim all liability for any trading losses, financial damages, or adverse outcomes arising from the use or interpretation of this indicator. Users are solely responsible for their own trading decisions. Always conduct independent research and consult a qualified financial professional before making any investment or trading decision.
Volume-Weighted Support & Resistance [MarkitTick] 💡Most support and resistance tools ask the trader to do the hard work: manually select a range, pick a starting point, and decide when to reset. The result is a static snapshot that grows stale the moment the market makes its next decisive move. This indicator was built to eliminate that dependency entirely. It observes market behavior as it unfolds, recognizes the precise moments when directional authority shifts hands, and autonomously re-anchors its entire analytical framework to the most contextually relevant origin point — all without requiring a single manual interaction from the trader. The result is a continuously adaptive, transaction-density-based map of price levels that the market has collectively agreed upon as meaningful, rebuilt in real time as the market itself redefines what meaningful means. It is designed for traders who understand that the most powerful support and resistance levels are not drawn with a ruler — they are revealed by the aggregate behavior of every participant who traded through a given price region and the conviction with which they did so.
✨ Originality and Utility
● Self-Governing Analytical Anchor
The overwhelming majority of volume-based analytical tools on TradingView are passive: they display information within a range the trader specifies and do nothing further. This indicator operates on an entirely different paradigm. It continuously monitors the structural behavior of price and, when a genuine directional regime transition is detected, automatically archives the previous analytical period, initiates a fresh accumulation window, and begins rebuilding its output from the new structural origin. This creates an analytical lifecycle that mirrors the market's own rhythm rather than the trader's calendar or convenience. No other action is required once the indicator is placed on the chart.
● Transaction Density as the Foundation of Significance
Where conventional support and resistance tools rely on price geometry — horizontal lines drawn from obvious highs and lows — this indicator derives all of its levels from the concentration of actual transactional activity. A price level gains significance not because it appears on a chart as a visual anchor, but because a disproportionate volume of market participation occurred there. This distinction is critical: levels built on transaction density represent zones where large numbers of traders are committed to a position at a specific price. That commitment creates both the memory and the motivation that make those levels relevant on re-approach.
● Temporal Depth Without Manual Reconstruction
Because the indicator maintains a deep archive of prior directional periods, the chart is never limited to the current moment's activity. Traders can observe the layered transaction density from multiple sequential market cycles simultaneously, each rendered in its own analytical context. This temporal depth provides a probabilistic landscape of where price has encountered resistance, found acceptance, and built the foundations of subsequent directional moves — all without the trader needing to manually scroll back, select ranges, or reconstruct prior periods.
● Macro-Structural Alignment Mode
An optional operating mode allows the indicator's structural anchor detection to be governed entirely by a higher timeframe's price behavior rather than the chart's native resolution. This means a trader operating on an intraday chart can have their support and resistance zones anchored to the structural transitions of the daily, weekly, or any other higher timeframe — ensuring that the levels displayed carry macro-structural significance rather than being products of lower-timeframe noise.
🔬 Methodology and Concepts
● Directional Regime Transition Detection
At the core of this indicator is a proprietary structural evaluation engine that continuously interprets price behavior in terms of directional authority. When the market has been in a defined behavioral state and then decisively crosses a threshold that invalidates that state, a regime transition event is registered. This event serves as the trigger for all downstream analytical processes — it is the moment the indicator understands that the market has changed its mind, and that the previous period's transactional landscape must be archived and a new one must begin. The sensitivity of this detection process is fully configurable, allowing the trader to tune how reactive the indicator is to structural changes based on their strategy's timeframe and tolerance for noise.
● Activity Density Profiling
Once an anchor origin has been established, the indicator begins constructing a transaction density profile across the full price range that separates that origin from the present bar. This profile maps how aggressively the market participated at each level within that range. Levels where participation was intense emerge as high-density zones; levels that price passed through quickly with limited engagement register as low-density corridors. The profile is not static — it grows and updates with every new bar, incorporating the transactional behavior of each candle into its cumulative model of the period.
● Transactional Concentration Clusters
Rather than treating each individual price band within the profile as an isolated output, the indicator identifies contiguous regions of elevated transactional activity and groups them into unified clusters. Each cluster represents a coherent zone where collective participation was sustained across a range of prices — not just a single level. These clusters are the primary visual and analytical output of the indicator: they define the support and resistance zones that are rendered on the chart. A wide, dense cluster indicates a broad region of deep market agreement. A narrow cluster signals a precise price level with concentrated transactional significance.
● Peak Activity Axis
Within the dominant transactional concentration cluster of each analytical period, a single price region registers the highest concentration of market activity. This axis acts as the gravitational center of the entire profile — the level around which the market spent the most time and energy. On chart, this axis is marked with a distinct visual indicator at the midpoint of its cluster zone. When price returns to this axis from either side, it typically encounters the most pronounced reaction of any level in the profile, as it represents the price at which collective market conviction was highest during the prior period.
● Multi-Epoch Transaction Landscape
The indicator does not discard prior analytical periods when a new regime transition occurs. Instead, it archives each completed period and continues to render its transaction density clusters on the chart. This means the trader's view at any given moment reflects not just the current period's developing density profile, but also the layered residue of multiple prior periods — each anchored to its own structural transition event. When clusters from multiple epochs stack vertically at the same price level, that confluence represents a zone that has demonstrated repeated transactional significance across different market regimes, making it analytically more robust than a level that appeared in only a single period.
● Forward-Projected Interaction Corridors
Beyond displaying the transaction density clusters within their historical formation window, the indicator selects the most price-proximate active zones above and below the current price and extends them forward in time. These extensions communicate to the trader which specific levels are most likely to be encountered in the near-term price path. The zones nearest to current price on the resistance side and the support side are each highlighted with their own visual treatment, creating an immediately actionable map of the levels the market is most likely to interact with next. Zones where the current price is already residing receive a distinct neutral visual treatment, indicating that the market is inside a zone of prior transactional significance without having yet resolved its direction relative to that zone.
● Automatic Resolution Intelligence
The granularity of the transactional data feeding the density profile is dynamically calibrated to the duration of the active analytical window. When the period is brief, higher-resolution data contributes to the profile; when the period spans a longer historical range, the data resolution adjusts accordingly. This automatic calibration ensures that the density profile is never under-populated with data from a period too short to fill it meaningfully, and never dominated by noise from an overly granular source relative to the structural context. Traders can also override this intelligence and specify a fixed data resolution if their workflow demands precise control.
● Macro-Structural Override Layer
When the higher timeframe structural mode is engaged, the anchor origin detection is fully delegated to the price behavior of the selected macro timeframe. Structural regime transitions on the macro timeframe determine when the indicator resets, archives, and rebuilds its density profiles — regardless of what the chart timeframe's price action suggests. This creates a top-down analytical alignment where every support and resistance zone rendered on the chart has been sanctioned by structural behavior on a timeframe that carries greater participant weight. The result is a set of levels that are contextually grounded in macro-structural significance rather than chart-resolution noise.
● Zone Priority Resolution
When multiple transactional clusters from different analytical periods overlap at the same price region, the indicator applies a deterministic resolution protocol that preserves the analytically superior zone and removes the redundant one. This prevents the chart from becoming cluttered with overlapping visual elements at the same level while ensuring that the zone with the greatest structural relevance is retained for the trader's decision-making. The visual output remains clean and unambiguous even when multiple historical periods have generated clusters in the same price territory.
🎨 Visual Guide
● Transaction Density Zone Boxes
Each transactional concentration cluster is rendered as a colored rectangular zone on the chart. The zone spans the full price range of the cluster horizontally and the full bar range from the first to the last candle that contributed activity to that zone vertically. Zones associated with upward directional regimes are rendered in one color family; zones associated with downward directional regimes are rendered in a contrasting color family. This color distinction provides immediate visual context about the directional character of the period in which each zone was formed, allowing traders to assess whether they are approaching a zone built by buyers or by sellers.
● Peak Activity Midpoint Marker
Running through the center of each zone box is a dashed line positioned at the midpoint of the zone's price range. This line marks the transactional axis of the cluster — the level closest to the zone's peak activity region. When price approaches a zone box, the dashed line offers a precise reference for the most magnetically significant level within that zone, helping traders identify where the strongest reaction is most likely to occur should price enter the zone.
● Activity Intensity Labels
An optional text label appears at the right edge of each zone box, displaying either the aggregate transactional weight of that cluster or its share of the total period's activity — selectable by the trader. Labels are color-matched to their parent zone's visual treatment, maintaining chart readability while providing quantitative context about each zone's relative significance. A zone displaying a high share value communicates that a disproportionate amount of the period's total market participation occurred there, reinforcing its significance as a potential inflection point.
● Dynamic Extension Rendering
The nearest qualifying zones above and below the current price are extended forward to the current bar using a distinct visual treatment separate from their base formation colors. Resistance extensions — zones entirely above current price — are rendered in a warm tone signaling overhead supply territory. Support extensions — zones entirely below current price — are rendered in a cool tone signaling underlying demand territory. Zones that the current price is actively testing from inside receive a neutral gray treatment, indicating positional ambiguity. This three-state visual system gives the trader an immediate read on the market's current structural location relative to its most relevant transactional history.
● Directional Coloring Logic
All color outputs respond dynamically to the market's current price relative to each zone's boundaries. The visual transitions are seamless — using TradingView's native object mutation rather than creating new objects — ensuring that the chart remains visually clean and free of layering artifacts. The border treatments of extended zones are consistent with their fill colors, creating a unified visual identity for each zone type that allows rapid visual parsing of the chart's support and resistance landscape.
📖 How to Use
● Reading the Current Analytical Period
The most recently formed transaction density clusters represent the market's current working map of significant price levels. Zones that have formed closer to the present bar reflect more recent transactional agreements and are generally more immediately relevant to near-term price behavior. When price approaches one of these zones from either direction, the zone represents a region where prior market participants made commitments and may act defensively on re-approach. Strong reactions at a zone confirm its continued relevance; a clean breach through a zone suggests that the prior conviction has been overridden by newer, more aggressive participation.
● Using the Forward-Projected Extensions
The extended zones directly above and below the current price are the indicator's primary forward-facing output. They communicate the most proximate levels that are structurally backed by transactional history and have not yet been resolved by the current price path. Traders can use the nearest resistance extension as a target or a decision point for existing positions on the long side. The nearest support extension serves the same function for positions on the short side. When price enters a zone whose extension is active, the zone's visual treatment shifts to the neutral state, signaling that the market is currently negotiating — and that the outcome of that negotiation will determine whether the zone holds or is absorbed.
● Interpreting Multi-Epoch Cluster Confluence
When zones from multiple historical periods converge at the same price level, that confluence is analytically more significant than any single zone in isolation. The trader should treat such confluence as a high-conviction structural reference: the market has repeatedly shown a willingness to concentrate activity at that level across different directional regimes. These confluences are particularly valuable as targets, reversal zones, or areas to expect heightened volatility and directional decision-making.
● Operating in Higher Timeframe Mode
When the macro-structural alignment mode is enabled, the indicator's anchor points are governed by a higher timeframe's structural transitions. In this mode, the support and resistance zones displayed on the chart carry the weight of macro-structural significance. Intraday traders using this mode should interpret the zones as representing the supply and demand commitments of participants operating on longer timeframes — participants whose positions are typically larger and whose responses at key levels are more decisive. Zones formed under this mode are best treated as high-conviction structural boundaries rather than tactical micro-levels.
● Calibrating Sensitivity
The structural detection sensitivity control governs how quickly the indicator recognizes a directional regime transition and initiates a new analytical window. Higher sensitivity values cause the indicator to detect structural transitions from smaller price swings, resulting in more frequent re-anchoring and a greater number of historical periods visible on the chart. Lower sensitivity values require more decisive price movement before a transition is registered, keeping the analytical window broader and the zones fewer but more structurally significant. Traders should calibrate this setting to their typical holding period: shorter-term traders generally benefit from higher sensitivity; longer-term traders from lower sensitivity.
● Managing Zone Depth
The number of forward-projected support and resistance extensions can be adjusted to control how many levels are actively highlighted at any given time. Setting this to a lower value focuses the trader's attention on the single most proximate level in each direction — a clean, uncluttered setup reference. Increasing this value provides a broader field of view, showing multiple upcoming levels in each direction and giving the trader visibility into the structural landscape several zones ahead of the current price.
⚙️ Inputs and Settings
● Structural Sensitivity Controls
Swing Sensitivity — Controls how reactive the structural regime transition detection is to price movement. Adjust to match the scale of price swings relevant to your trading timeframe.
Enable Macro-Structural Alignment — Toggle that activates the higher timeframe structural override mode, delegating all anchor transition decisions to the macro timeframe's price behavior.
Macro Timeframe Selector — Selects the higher timeframe used for structural regime transition detection when the macro-structural alignment mode is active.
● Transaction Data Resolution
Enable Custom Data Timeframe — Toggle that allows the trader to manually specify the resolution of the transactional data feeding the density profile, overriding the indicator's automatic resolution selection.
Custom Data Timeframe — When the custom resolution mode is active, this selector determines the granularity of intrabar transactional data incorporated into the density profile.
● Display and Annotation Controls
Show Text Labels — Toggle that enables or disables the quantitative annotation labels displayed at the edge of each transaction density zone.
Label Value Format — Selects whether the zone labels display the absolute transactional weight of the cluster or its proportional share of the total period's activity.
Forward Projection Depth — Determines how many of the nearest qualifying support zones and resistance zones are extended forward to the current bar as active interaction corridors.
● Transaction Density Zone Colors (Bullish Regime)
Bullish Zone Fill — Fill color applied to transaction density zone boxes formed during upward directional regimes.
Bullish Peak Axis Color — Color applied to the peak activity midpoint line within bullish-regime zone boxes.
Bullish Label Color — Text color applied to quantitative annotations within bullish-regime zones.
● Transaction Density Zone Colors (Bearish Regime)
Bearish Zone Fill — Fill color applied to transaction density zone boxes formed during downward directional regimes.
Bearish Peak Axis Color — Color applied to the peak activity midpoint line within bearish-regime zone boxes.
Bearish Label Color — Text color applied to quantitative annotations within bearish-regime zones.
● Dynamic Extension and Slot Colors
Price-Above Zone Fill — Fill color applied to zones where the current price is positioned above the zone's midpoint, indicating the zone is being approached from below.
Price-Below Zone Fill — Fill color applied to zones where the current price is positioned below the zone's midpoint, indicating the zone is being approached from above.
Resistance Extension Fill — Fill color applied to zones that are extended forward as active overhead resistance corridors.
Resistance Extension Border — Border and line color applied to resistance extension zones and their associated peak axis markers.
Support Extension Fill — Fill color applied to zones that are extended forward as active underlying support corridors.
Support Extension Border — Border and line color applied to support extension zones and their associated peak axis markers.
Inside Zone Fill — Fill color applied to zones that the current price is actively residing within, indicating positional ambiguity.
Inside Zone Border — Border and line color applied to inside zones and their associated peak axis markers.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
The analytical philosophy embedded in this indicator draws simultaneously from several distinct and, in some respects, competing intellectual traditions in market microstructure theory, behavioral finance, and quantitative portfolio research. No single framework is implemented exclusively — the indicator's design reflects a deliberate synthesis of ideas across these traditions, creating an analytical instrument whose theoretical grounding cannot be anchored to any single academic lineage.
From the tradition of market microstructure theory, particularly the literature on order flow and price discovery, the indicator inherits the foundational proposition that price does not move randomly through a continuous field of equivalent levels. Instead, price is attracted to and repelled from specific levels where the density of prior transactional commitment creates what the microstructure literature describes as informational anchoring. The work of Kyle (1985) on the relationship between informed trading and price impact, and the subsequent extensions by Glosten and Milgrom on the sequential trade model, established the theoretical basis for treating price levels differently based on the volume of activity that has occurred there. This indicator operationalizes that distinction in a visual and actionable form.
From the behavioral finance tradition — particularly the research on reference point theory and the disposition effect documented by Shefrin and Statman (1985) and extended by Odean (1998) — the indicator inherits the understanding that traders do not evaluate price levels in isolation but relative to the prices at which they established their positions. A zone of concentrated transactional activity represents, in aggregate, a region where a large population of traders are psychologically anchored to a specific price. When price returns to that region, the collective behavioral response of those traders — whether defensive protection of their entry or relief liquidation of underwater positions — creates the price friction that manifests as support and resistance. The indicator gives this behavioral phenomenon a structural and visual form.
From the quantitative tradition of market regime modeling, including the work on hidden Markov models applied to financial time series (Hamilton, 1989; Ang and Timmermann, 2012) and the broader literature on structural break detection in price processes, the indicator inherits its most architecturally distinctive feature: the automatic recognition of directional regime transitions as the trigger for analytical renewal. The insight that financial markets are not ergodic — that their statistical properties change meaningfully when the directional regime changes — implies that support and resistance levels built during one regime carry different analytical weight than those built during another. By anchoring each density profile to a structurally defined period, the indicator respects this regime-conditionality rather than averaging across regimes indiscriminately.
From the risk-parity and factor-model traditions — particularly the work on cross-sectional dispersion in asset returns and the concentration of trading activity around factor rebalancing events — the indicator draws the intuition that the significance of a transactional density zone is not merely a function of volume in isolation but of volume relative to the structural context in which it was generated. High volume in the context of a trend continuation carries different analytical implications than the same volume at a structural inflection point. This context-sensitivity is embedded in the indicator's anchoring logic, which ensures that every density profile is evaluated within the structural narrative of the regime that produced it.
These four traditions — microstructure theory, behavioral finance, regime modeling, and factor-conditioned volume analysis — are woven together in the indicator's design in ways that resist reduction to any single framework. A researcher attempting to reconstruct the indicator's analytical philosophy from first principles would find themselves navigating a genuinely multi-paradigm architecture, where the theoretical justifications for each design choice can be traced to multiple, mutually reinforcing but structurally distinct bodies of literature. This is not theoretical ambiguity for its own sake — it reflects the genuine complexity of price behavior, which is simultaneously a microstructure phenomenon, a behavioral phenomenon, a regime phenomenon, and a distributional phenomenon. Any analytical tool that pretends otherwise is, by definition, an oversimplification.
The temporal depth feature — the maintenance of multiple sequential historical density profiles — finds specific theoretical support in the literature on long-memory processes in financial markets (Lo, 1991; Baillie, 1996) and in the empirical work on the persistence of price-level significance across market cycles. The finding that markets repeatedly return to levels of prior high-volume activity — even across regime changes — has been documented in equity, futures, and currency markets alike, and provides the empirical foundation for treating historical transaction density as a forward-relevant analytical input rather than a purely retrospective one.
The automatic resolution calibration reflects the theoretical literature on optimal sampling frequency in high-frequency financial data, drawing on insights from realized volatility estimation and the Epps effect — the empirically observed decay in return correlations at progressively finer sampling intervals. By dynamically selecting a data resolution that is appropriate to the duration of the analytical window, the indicator avoids the microstructure noise that contaminates profiles built on inappropriately fine data, while also avoiding the resolution loss that occurs when excessively coarse data is applied to a short structural window.
The zone priority resolution mechanism, which resolves overlapping clusters across analytical periods, draws implicitly on the economics literature on information aggregation and the theory of market consolidation zones as informational equilibria. When multiple historical periods generate overlapping transactional density at the same price level, the theoretical implication is that the market has repeatedly discovered an informational equilibrium near that price — and that the most recent, most structurally significant expression of that equilibrium should take precedence in the trader's analytical framework. The indicator's resolution logic operationalizes this theoretical hierarchy in a computationally efficient and visually clean form.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Smart RSI Concepts Pro [MarkitTick] 💡 The Smart RSI Concepts Pro is a comprehensive, multi-dimensional momentum and structural analysis suite. Rather than relying on a standard single-line oscillator, this tool reimagines the Relative Strength Index (RSI) by transforming it into a fully mapped environment complete with candlesticks, dynamic regression channels, order blocks, and divergence tracking. It is designed to bridge the gap between price action and momentum, displaying advanced metrics natively on the oscillator panel while simultaneously projecting critical structural data directly onto your main price chart.
This is the professional version of the free indicator Smart RSI Candles
✨ Originality and Utility
● Bridging Price and Momentum
Standard oscillators often fail to provide structural context, leaving traders to guess where true support and resistance lie within momentum. This tool's originality stems from applying price-action concepts—specifically Order Blocks and Statistical Regression—directly to the RSI data series. By doing so, it creates a unified analytical framework where momentum has its own distinct market structure.
● Advanced Confluence
The utility of this indicator lies in its ability to synthesize multiple data points into a single "Regression Compass" dashboard. It eliminates the need for traders to manually cross-reference different indicators by computationally comparing the slope, trajectory, and statistical quality (R-Squared) of the price trend against the momentum trend in real-time.
🔬 Methodology and Concepts
● Algorithmic Core and Statistical Modeling
Due to the proprietary nature of this tool, the internal calculations are abstracted. At its foundation, the indicator utilizes a dynamic statistical engine that continuously evaluates an array of data points to form structural regression channels. Instead of static lookbacks, the algorithm identifies structural pivots in both price and momentum, anchoring its calculations to these significant turning points.
● Relative Strength Scaling
The script employs an internal scaling mechanism that intelligently maps price wicks and bodies to the constrained 0-100 RSI environment. This allows for the plotting of true "RSI Candlesticks," representing not just the close of momentum, but the intra-bar volatility of momentum relative to price.
● Structural Order Blocks
Order block logic is applied by scanning for specific volatility thresholds and structural shifts. When a significant momentum pivot is confirmed, the system projects a defensive zone (the Order Block) forward in time. This logic runs concurrently on both the price data and the RSI data, offering dual-layer support and resistance analysis.
🎨 Visual Guide
● RSI Candlesticks and Heatmap
Candles: The traditional RSI line is replaced (or accompanied) by full candlesticks, illustrating open, high, low, and close momentum values.
Heatmap Colors: The candles change color dynamically based on extreme readings. Cool colors (teals/blues) represent oversold or cold zones, neutral greys represent the midline, and warm/hot colors (reds/crimson) represent overbought conditions.
● Order Blocks (OB)
Bullish OB: Displayed as green-tinted boxes extending to the right from structural lows, acting as momentum or price support.
Bearish OB: Displayed as red-tinted boxes extending from structural highs, acting as overhead resistance.
"A structural momentum lead is identified: The RSI has successfully mitigated the 'Bullish Order Block' zone, establishing it as a firm support level. Conversely, the Price Action remains in a 'Premium' state relative to its own primary Order Block, failing to reach the equivalent structural support. This lead-lag disparity suggests a preemptive accumulation phase within the RSI oscillator ahead of a potential price reversal."
"Confirmed Accumulation Phase: The RSI successfully mitigated the Bullish Order Block (OB) ahead of Price Action, serving as a leading indicator for the current reversal. This structural disparity proves that momentum found support while Price remained in a premium discount zone, validating the strength of the move."
● Regression Channels
● Regression Channels
Trend Lines: Solid or dashed median lines with upper and lower boundary bands. Green indicates an upward trajectory, red indicates downward, and grey denotes a sideways or statistically insignificant trend.
Fills: Translucent shading between the upper and lower bounds to visually enclose the volatility range.
● Divergence Markers
"R" Labels: Solid shapes indicating Regular Divergence (trend reversal signals).
"H" Labels: Dashed lines and shapes indicating Hidden Divergence (trend continuation signals).
● Regression Compass (Dashboard)
Table Metrics: A sophisticated table that tracks the mathematical Angle, Slope per bar, R² (trend quality), and Z-Score (standard deviation extreme) for both Price and RSI.
Strength Score & Alignment: A composite score out of 100 rating the current setup, along with an alignment badge confirming if price and momentum agree.
📖 How to Use
● Identifying Trend Exhaustion
Monitor the RSI candlesticks as they approach the upper or lower regression bands. If a candlestick enters a "Hot" or "Cold" heatmap state while simultaneously touching an Order Block and the outer edge of the regression channel, it presents a high-probability mean-reversion setup.
● Trading Divergences
Use the automated divergence tags to spot hidden shifts. A Regular Bullish Divergence ("R" label) appearing at the lower boundary of an upward-sloping regression channel provides a strong foundation for a long position, as it indicates underlying strength despite price weakness.
● Slope Confluence
Consult the Regression Compass table before entering a trade. Ensure the "Alignment" badge reads "ALIGNED," meaning both the Price Channel and the RSI Channel are moving in the same mathematical direction. A divergent state warns of potential chop or an impending reversal.
⚙️ Inputs and Settings
• RSI and Benchmark Settings
Adjust the core RSI length (default is often 14). You can also toggle "Relative RSI," allowing you to compare the current asset's momentum against a macroeconomic benchmark (like the DJI).
• Regression Sensitivities
Modify the "Structural Sensitivity" and "Deviation Factor" to dictate how tightly the regression channels hug the data. A higher deviation factor creates wider bands, capturing more volatility before signaling a breakout.
• Display Toggles
The indicator is highly modular. You can independently toggle the visibility of Price Order Blocks, RSI Order Blocks, Divergence lines, and the Regression Compass dashboard to keep your workspace clean.
• Alert Conditions
Set up custom notifications for when price or momentum breaks a channel, retests a midline, forms a new structural channel, or flashes a severe slope divergence.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Momentum Oscillator Theory
The foundation of the script rests on J. Welles Wilder's Relative Strength Index, which measures the velocity and magnitude of directional price movements. However, this tool expands on classical theory by treating the 0-100 bound range not just as a gauge, but as a spatial environment subject to its own laws of supply and demand (visualized via Order Blocks).
● Linear Regression and Ordinary Least Squares (OLS)
To determine trajectory, the algorithm utilizes a proprietary adaptation of OLS regression. This statistical method calculates the line of best fit through a series of data points by minimizing the sum of the squares of the vertical deviations. The script constantly recalculates this fit based on dynamic structural anchors rather than arbitrary time periods.
● Coefficient of Determination (R²) and Z-Scoring
The tool evaluates the reliability of its own channels using R-Squared metrics, ensuring that traders are only presented with statistically significant trends. Furthermore, Z-Scoring is applied to measure exactly how many standard deviations the current data point is from the statistical mean, providing an empirical measurement of "overbought" or "oversold" rather than relying on static 70/30 thresholds.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Support and Resistance Breakout Signals Pro [MarkitTick] 💡 An advanced, all-in-one technical analysis suite engineered to identify high-probability breakout opportunities. By mapping dynamic market structures across multiple timeframes, this tool provides actionable insights through predictive analytics, intelligent gap detection, and institutional-grade breakout confirmations.
This is the professional version of the free indicator Support and Resistance Breakout Signals
✨ Originality and Utility
Traditional support and resistance tools often clutter the chart with static lines that become irrelevant as market conditions evolve.
This script distinguishes itself by dynamically managing active price levels, intelligently merging nearby zones to reduce noise, and implementing strict quality filters to ignore false breakouts.
Furthermore, it introduces a proprietary predictive analytics engine that scores the strength and probability of every breakout.
It analyzes momentum, volume anomalies, and multi-timeframe confluence to give you a definitive edge.
Whether you are a discretionary trader seeking confluence or an algorithmic systematic trader utilizing JSON webhooks, this indicator streamlines your workflow with extreme precision.
Unlike basic visual aids, this suite acts as a complete trading ecosystem that tracks its own win rate and profitability metrics internally.
🔬 Methodology and Concepts
The core mechanics rely on adaptive market structure mapping. The engine continuously scans for significant pivot formations to establish valid structural boundaries.
● Dynamic Breakout Detection
Instead of acting on mere wicks, the engine validates true breakouts using strict internal criteria.
It evaluates candle body closure percentages, true range expansion metrics, and volume surges.
This effectively filters out market noise and identifies genuine directional intent driven by large market participants.
● Multi-Timeframe Confluence
The system operates concurrently on both the current chart timeframe and a selected higher timeframe.
Signals can be explicitly filtered to only trigger when aligned with the overarching directional bias.
This macro-to-micro alignment significantly improves the statistical reliability of the generated setups.
● Smart Gap Mapping
The indicator systematically maps unfilled price voids across the chart.
These voids are categorized dynamically based on trend duration and relative volume spikes.
By identifying whether a gap is a breakaway, runaway, or exhaustion gap, traders are provided with key targets or hidden reversal zones.
● Garbage Collection and Data Optimization
To ensure optimal performance, the script utilizes an internal state-management system that cleans up expired zones, trims historical data points, and automatically removes signals that no longer hold structural significance.
🎨 Visual Guide
● Visualizing Support & Resistance: Box vs. Line Styles
Based on the provided script, the indicator offers traders two distinct visual modes to plot Support and Resistance (S/R) levels on the chart:
• Box Style (Zone Representation)
When the "Draw Style" input is set to "Box", the indicator plots S/R levels as shaded rectangular zones. These zones highlight a range of price activity rather than a single point, visually representing areas where buying or selling pressure is concentrated. This is useful for identifying broader rejection areas or congestion zones.
• Line Style (Fixed Level Representation)
When the "Draw Style" input is set to "Line", the indicator displays S/R levels as clear horizontal lines at specific price points. This style is ideal for traders looking for precise levels for entry, exit, or stop-loss orders, offering a cleaner chart layout focused on key inflection points.
The chart outputs are meticulously designed for clarity and rapid interpretation without overwhelming the user.
● Price Zones and Lines
Resistance Zones are highlighted with a translucent red background, visually representing supply areas.
Support Zones feature a translucent green background, representing demand areas.
Higher Timeframe levels utilize distinct colors, such as Fuchsia for Resistance and Aqua for Support.
Thicker border lines are applied to higher timeframe zones to instantly differentiate them from local levels.
Dashed mid-lines run through active zones to pinpoint the exact median of the active price structure.
● Breakout Labels
Bullish Breakouts: Displayed as an upward-pointing triangle below the price action.
Bearish Breakouts: Displayed as a downward-pointing triangle above the price action.
Dynamic Transparency: The visual opacity of these icons dynamically adjusts based on the calculated strength of the breakout.
Interactive Tooltips: Hovering over any breakout label reveals a detailed breakdown of the signal.
Tooltip Data: Includes the number of broken levels, multi-break multipliers (indicated by a lightning bolt symbol), and the calculated probability score.
● Gap Boxes
Extended visual boxes represent detected gaps in price action.
Blue Boxes: Indicate Breakaway gaps, signaling the initiation of a new momentum phase.
Orange Boxes: Indicate Runaway gaps, suggesting continuation and trend strength.
Red Boxes: Indicate Exhaustion gaps, warning of potential trend fatigue and impending reversals.
📖 How to Use
● S/R & Gap Confluence Logic
• "High-Probability Reversal Zones"
When a Price Gap occurs in alignment with a pre-identified Support or Resistance level, it creates a high-probability "Magnetic Zone." According to the indicator’s logic:
Gap-Level Confluence: If a gap opens or remains unfilled exactly at a key S/R level, the probability of the price returning to "fill the gap" or retest that specific level is significantly increased.
Market Magnetism: These areas act as liquidity pools. When a breakout level coincides with a gap, the market often treats it as a primary target for a mean-reversion move before continuing the trend.
• Strategy Tip
Watch for price action signals when the market returns to these dual-confluence zones, as they often provide the most reliable entry points for institutional-grade setups.
Incorporating this tool into your daily routine is straightforward and highly effective.
● Trend Alignment
Utilize the Higher Timeframe levels to establish your daily or weekly directional bias.
Look for trade setups only when the current timeframe confirms a breakout in the direction of the larger trend.
● Signal Filtering
Pay close attention to the visual breakout labels.
A fully opaque label indicates a high-strength signal confirmed by volume and momentum.
Lighter, more transparent labels suggest lower conviction and may warrant tighter risk management or reduced position sizing.
● Target and Stop Placement
The indicator's dynamically drawn zones serve as highly logical areas for take-profits and stop-losses.
Anticipate price reactions when entering these shaded regions, and use historical gap boxes as secondary targets.
● Strategy Details and Risk Management
Never take every signal blindly. Use the built-in win-rate tracker to evaluate the asset's current behavior.
If the internal dashboard shows a low profit factor, wait for the market to transition from a ranging state to a trending state.
Ensure your stop-loss is placed beyond the nearest structural support or resistance to avoid premature stop-outs.
● Automated Execution
For algorithmic traders, configure the JSON webhook alerts to broadcast to your preferred execution platform, allowing you to trade these confirmed signals autonomously.
Note on Repainting: Due to the utilization of multi-timeframe historical data integration, higher timeframe structural levels may shift dynamically during intrabar formation until the higher timeframe candle achieves a definitive close.
●Practical trading example based on S/R analytics
• HTF HH | 5602.225
• HTF HH
Represents a Higher Timeframe Higher High, indicating a structural pivot point where the current high is greater than the previous high on the daily (or selected HTF) interval.
• 5602.225
Denotes the Precise Price Level of the identified resistance or support zone, formatted to the asset's minimum tick precision.
•
Indicates a Confluence Signal where multiple support or resistance levels from different timeframes or calculations overlap within the same price zone.
•
A Predictive Analytics Score calculated based on HTF alignment, distance from current price (ATR), and historical win rate to estimate the probability of the level holding or breaking.
● Resistance Level Analysis
When price approaches a identified resistance level, the 74% probability indicates a high statistical likelihood of rejection.
● Strategic Execution
For Long Positions: Secure partial profits (Take Profit) as price nears the level to mitigate reversal risk.
For Short Entries: Monitor for a confirmed rejection signal at the level before execution.
Breakout Scenario: A strong move above this level suggests a high-conviction breakout rather than a "fakeout," confirming momentum shift.
⚙️ Inputs and Settings
The suite is highly customizable to fit any asset class or trading style.
● 1. Core Swing Logic
Define the specific lookback periods for both left and right bars to establish strict or loose pivot points based on your volatility preferences.
Control the maximum number of stored levels to keep the chart clean.
● 2. Higher Timeframe (HTF)
Enable HTF mapping, select the desired macro timeframe, and toggle the strict Confluence Filter to suppress counter-trend signals.
● 3. Breakout & Quality Filters
Toggle core constraints such as minimum body break percentages.
Require True Range expansion for signal validation.
Enable volume moving average confirmation and set time decay limits for aging levels.
● 4. Predictive Analytics
Individually toggle the internal scoring components.
Options include momentum strength, close positioning, volume anomalies, and historical win rate probability mapping.
● 5. Display & UI Controls
Customize how many active zones are displayed simultaneously.
Adjust zone transparency, line merging thresholds, and HTF visual thickness.
● 6. JSON Webhook Alerts
Enable webhooks and configure custom JSON payloads for long, short, close long, and close short commands.
Define specific True Range multipliers for automated dynamic stop-loss calculations.
● 7. Smart Gap Concepts
Enable current or higher timeframe gap mapping.
Adjust the minimum dimensional size for gap detection and set custom volume multipliers to accurately spot institutional involvement.
Set the trend maturity threshold to properly classify exhaustion gaps.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
At a fundamental level, the indicator is constructed upon the principles of auction market theory, price discovery mechanisms, and statistical volatility dynamics.
● Auction Market Theory and Liquidity
The tool dynamically maps out historical liquidity pools by recognizing extreme pivot nodes.
When price approaches these established nodes, the auction process either finds equilibrium resulting in a rejection, or aggressively seeks new liquidity resulting in a valid breakout.
The internal engine abstracts the raw price data to assess this critical transition from balance to imbalance without relying on arbitrary moving averages.
● Volatility Expansion Dynamics
Built directly into the breakout logic is the mathematical concept of volatility cycles.
By integrating dynamically calculated true range parameters, the script differentiates between low-volatility baseline drift and high-volatility structural shifts.
This ensures signals are generated strictly during periods of statistical anomaly, capturing the true expansion phase of the asset.
● Heuristic Probability Scoring
The predictive analytics engine utilizes heuristic modeling to evaluate signal confidence.
By aggregating multiple independent market variables—such as relative volume surges, internal momentum metrics, and structural alignment—it computes a unified composite score.
This robust approach borrows heavily from multivariate analysis, substantially reducing the statistical weight of any single false positive variable.
● Adaptive Thresholding
Rather than relying on static percentages, the indicator measures breakout severity relative to the asset's immediate historical volatility.
This fluid thresholding means the tool naturally adapts to high-beta crypto markets as easily as it does to low-beta traditional forex pairs, maintaining mathematical integrity across environments.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Smart Fear & Greed Index Pro [MarkitTick] 💡 The Smart Fear & Greed Index Pro is an advanced, multi-dimensional oscillator designed to quantify market sentiment by dynamically analyzing ten distinct pillars of price action, volume, and volatility. Unlike static sentiment indicators, this tool employs an adaptive weighting algorithm that adjusts the influence of each metric in real-time based on its statistical stability and correlation with price movements.
This is the professional version of the free indicator Smart Fear & Greed Index
✨ Originality and Utility
Standard sentiment oscillators often rely on fixed lookback periods and static weights, causing them to lag or generate false signals during regime changes. This indicator solves that problem through a highly original "Adaptive Weighting" mechanism. By continuously measuring how well each underlying metric correlates with the current price action, the script promotes the most relevant data points while suppressing noisy or lagging indicators.
Furthermore, the script features a built-in Auto-Inversion protocol. If a typically counter-cyclical metric begins to exhibit persistent negative correlation beyond a specific threshold, the indicator automatically inverts its output to maintain alignment with the broader cyclical trend. This makes it an exceptionally robust tool for traders who need a responsive, context-aware gauge of market extremes across different timeframes.
🔬 Methodology and Concepts
The core of this indicator is built upon a robust statistical framework that processes ten individual market metrics before synthesizing them into a single index.
● Normalization and Outlier Management
Raw data from disparate sources (like volume imbalances and log returns) cannot be simply added together. The script utilizes Winsorization to cap extreme outliers (three standard deviations from the mean) and applies a Percentile Rank function alongside Z-Scores to normalize all data points into a standardized 0 to 100 scale.
● The Ten Pillars of Analysis
Volatility: Combines Average True Range (ATR) and standard deviations of logarithmic returns.
Momentum: Measures the velocity of price changes using a Relative Strength Index (RSI) foundation.
Volume Spikes: Compares current volume against a smoothed average, weighted by the direction of the candle.
Volume Imbalance: Analyzes the ratio of cumulative up-volume versus down-volume.
Range Expansion: Evaluates the current high-low range against its historical average.
Price Position: A Donchian-style calculation determining where the current close sits within a historical high-low range.
Accumulation/Distribution: Tracks directional volume flow.
Velocity: Calculates the absolute percentage rate of price change.
Distance From Mean: Measures the percentage deviation of the current price from a Simple Moving Average.
Elliott Wave Oscillator (EWO): Measures the distance between a fast and slow moving average to detect wave structure momentum.
🎨 Visual Guide
The indicator is plotted on a separate pane below the main chart and consists of several highly intuitive visual components.
● The Fear & Greed Line
The primary index is plotted as a thick, color-changing line that oscillates between 0 and 100.
Deep Red: Extreme Greed (Values 70 and above).
Orange: High Greed (Values between 60 and 69).
Yellow/Gold: Neutral to Mild Sentiment (Values between 40 and 59).
Dark Green: High Fear (Values between 30 and 39).
Bright Lime Green: Extreme Fear (Values below 30).
● The Signal Line
A solid white line serves as a smoothed signal line (configurable as SMA, EMA, or WMA). This line helps identify shifts in momentum when the main FGI line crosses over or under it.
● Background Zones and Thresholds
Dashed/Dotted Lines: A gray dashed line marks the neutral 50 level. Red and green dotted lines mark the user-defined Extreme Greed and Extreme Fear thresholds.
Dynamic Backgrounds: When the index enters Extreme Greed, the background of the indicator pane tints red. When it enters Extreme Fear, it tints green.
📖 How to Use
Traders can utilize this indicator to identify potential exhaustion points and cyclical reversals.
● Identifying Extremes
When the indicator reaches Extreme Greed (red zone), it suggests the market may be overextended and due for a correction or consolidation. Conversely, readings in Extreme Fear (green zone) often indicate capitulation and potential accumulation zones.
● Crossover Signals
Watch for the primary color-coded line crossing the white signal line. A cross downward from the Extreme Greed zone suggests fading momentum, while a cross upward from the Extreme Fear zone suggests buying pressure is returning.
● Divergences
Look for discrepancies between price action and the indicator. If the price makes a higher high, but the Fear & Greed index makes a lower high, it signals waning participation in the trend.
● Market Signal Dynamics
A crossover between the main indicator line and the signal line acts as an early warning that the market momentum might be shifting. However, the true direction of the overall trend is determined by the centerline (the 50-level). The trend is considered bullish as long as the indicator remains above the centerline, and bearish when it stays below it.
⚙️ Inputs and Settings
The script is highly customizable, catering to both novice and advanced users.
● Timeframe Configuration
Enable Automatic Timeframe Configuration: When active, the script automatically adjusts all lookback periods (e.g., changing from 21 periods to 52 periods) based on whether you are viewing a Daily or Weekly chart.
● Manual Overrides
Users can manually adjust the periods for every single metric, including Volatility, Momentum, Volume Spikes, and Range Expansion.
● Adaptive & Smoothing Settings
Adaptation Method: Choose between Volatility-Based, Correlation-Based, or a Hybrid approach for how the script assigns weights to its internal metrics.
Z-Score Factor: Adjust the sensitivity of the statistical normalization.
Smoothing Type: Change the moving average type (EMA, SMA, WMA) used for the final index output and the signal line.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
This indicator is heavily rooted in quantitative behavioral finance and robust statistical modeling. By utilizing Winsorization , the mathematical model actively limits the influence of spurious market anomalies (such as flash crashes or fat-finger errors) that typically skew standard deviation calculations.
The normalization process employs a Sigmoid-like transformation via Z-Scores, ensuring that the disparate units of the underlying metrics (e.g., absolute volume vs. percentage returns) are mapped to a uniform distribution curve. Furthermore, the "Adaptive Weighting" incorporates principles of dynamic factor modeling. By measuring the Pearson correlation coefficient between the rate of change of the individual metrics and the underlying asset's price, the algorithm dynamically penalizes metrics that exhibit high variance or zero correlation (noise) while rewarding those that exhibit stable, predictive variance (signal).
🔓 vs 🔒 Smart Fear & Greed Index (Pro vs. Free)
The technical breakdown of the differences between the Standard and Pro versions of the Smart Fear & Greed Index scripts.
The Pro version is a heavily advanced, statistically normalized algorithmic tool, whereas the Standard version acts as a lightweight, object-oriented foundational gauge.
● Metric Depth & Calculation Engine
• Pro Version Analyzes the market using 10 advanced independent metrics. These include Volatility, Momentum, Volume Spikes, Volume Imbalance, Range Expansion, Price Position, Accumulation/Distribution, Velocity, Distance From Mean, and the Elliott Wave Oscillator (EWO).
• Standard Version Relies on a simplified core of 4 foundational metrics: Momentum (RSI), Volatility (ATR), Volume (Relative SMA), and Price Position (Stochastic).
● Weighting & Adaptation Logic
• Pro Version Features a highly sophisticated Adaptive Weighting System. Instead of equal weighting, it dynamically adjusts the importance of each metric in real-time based on Volatility, Correlation, or a Hybrid of both. It also includes an "Auto-Invert" mechanism that flips counter-cyclical metrics if their correlation shifts heavily.
• Standard Version Uses a static, Equal-Weighting System, where all 4 metrics contribute exactly 25% to the final composite score.
● Timeframe Auto-Configuration
• Pro Version Includes an intelligent Timeframe Detection engine. If enabled, it automatically reads the chart's timeframe (e.g., Daily or Weekly) and dynamically assigns optimized lookback periods for every single metric to prevent lagging or false signals.
• Standard Version Operates strictly on manual inputs. The user sets a single global lookback period that governs all internal metrics uniformly.
● Mathematical Normalization
• Pro Version Utilizes advanced institutional mathematics, including Winsorization (to remove extreme outliers) and Z-Score based Percentile Ranking. This ensures the data is flawlessly smoothed and normalized between 0 to 100 regardless of extreme market conditions.
• Standard Version Uses a standard Minimum/Maximum normalization formula ((src - l) / div * 100) to keep the metrics constrained within the 0 to 100 range.
● Code Architecture
• Pro Version Employs an optimized procedural structure using persistent variables (var) and deep custom helper functions to handle the massive calculation load and arrays efficiently.
• Standard Version Built with a modern, modular Object-Oriented Programming (OOP) approach, utilizing Pine Script v6 User-Defined Types (UDTs) and stateful Methods (QuantEngine).
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Vertical Volume Pro [MarkitTick] 💡 Vertical Volume Pro reimagines how traders read participation across a trend by rendering volume not as a single horizontal profile hugging the edge of the screen, but as a series of upright volume columns planted directly beneath the price bars that produced them. Instead of asking where the most volume traded across an entire session, it asks a sharper and more actionable question: within the current structural leg of the market, when did conviction arrive, who was behind it, and where did participation thin out into vacuum? The tool anchors itself to live market structure, self-selecting the origin of every measurement to the swing that began the current move, and then it dissects the volume that flowed from that origin into a rich map of dominant zones, exhaustion gaps, estimated large-participant footprints, and an anchored fair-value reference weighted toward outsized activity. The result is a single overlay that fuses market-structure awareness, granular volume anatomy, and participation-quality estimation into one continuously updating picture, giving traders a way to see the texture of a move rather than just its price path.
✨ Originality and Utility
● A Structural Anchor Instead of a Static Window
Most volume tools begin measuring from an arbitrary fixed point — a session open, a rolling lookback, or a manually dragged handle that goes stale the moment the market moves on. Vertical Volume Pro instead ties its measurement origin to the market's own structure. It continuously watches for shifts in trend character and, when a meaningful break occurs, it re-anchors its entire measurement window to the swing that launched the new leg. This means the volume anatomy you see always describes the move currently in play, not a leftover window from a regime that has already ended. The anchor is not a decoration; it is the spine of the entire tool, and every metric downstream inherits its relevance from it.
● Vertical Columns as a New Visual Grammar
By standing volume upright beneath the bars that generated it, the tool preserves the one dimension a traditional sideways profile discards: time. A horizontal profile tells you a price level was heavily traded but hides when that trading happened. Vertical columns keep the temporal order intact, so a trader can see whether heavy participation clustered at the start of a leg, punctuated its middle, or arrived only at exhaustion near the end. This temporal fidelity is what makes the downstream concepts — consolidation groups, exhaustion gaps, and density clustering — possible in the first place.
● Participation-Quality Estimation, Honestly Framed
The tool goes beyond raw volume to estimate the character of who was trading. It surfaces an estimate of outsized single prints versus ordinary flow, flags absorption and repeated-refill footprints, and weights a fair-value line toward the heaviest activity. Crucially, it frames every one of these as a statistical estimate derived from candle volume behavior, never as confirmed order-origin data. This honesty is itself a differentiator: it delivers the interpretive power traders want from participation analysis while refusing to overpromise a certainty that no chart-based tool can legitimately provide.
● One Overlay, Many Lenses
Rather than forcing a trader to stack four or five separate scripts, the tool consolidates structural anchoring, volume grouping, gap detection, large-print flagging, absorption sensing, iceberg-run recognition, a whale-weighted rating system, an anchored fair-value line, and a live metrics panel into a single coherent overlay. Each lens can be toggled independently, so the same tool serves a fast scalper wanting only the dominant zone and a methodical swing trader wanting the full anatomy.
🔬 Methodology and Concepts
● Structural Anchoring and Trend State
The foundation of the tool is its reading of market structure. It tracks the most recent meaningful swing high and swing low and monitors whether price decisively reclaims or breaks them. When price closes beyond a governing swing, the tool interprets this as a change in the prevailing direction and re-anchors the active measurement range to the swing point that seeded the new move. This produces a clear trend state — bullish when the market has broken structure to the upside, bearish when it has broken to the downside — and the age of the current anchor, expressed in bars, tells you how mature the present leg has become. A trader can choose a Micro sensitivity that reacts to minor swings for scalping, or a Macro sensitivity that responds only to larger cycle turns for position-oriented work. A manual anchor mode is also available for those who prefer to pin the measurement to a specific date rather than let structure decide.
● Vertical Volume Distribution
Within the active range, the tool captures fine-grained volume from a lower timeframe and stands it upright beneath the price bars. Each column reflects the participation that occurred at that point in the leg. A trader reads tall columns as moments of conviction and short columns as moments of hesitation. Because time is preserved, the sequence of columns reveals the rhythm of the move — whether it was front-loaded with commitment, evenly participated, or driven late by a burst of activity.
● Consolidation Groups
Rather than leaving the eye to interpret dozens of individual columns, the tool identifies stretches where participation clusters into a coherent block and presents them as grouped zones. Each group reflects a region of the leg where meaningful volume accumulated together. Groups let a trader instantly perceive where the market spent its energy, and the single heaviest group is highlighted as the dominant zone — the region that anchored the most participation across the entire move and therefore the most consequential area to watch on any retest.
● Exhaustion Gaps
Just as important as where volume concentrates is where it evaporates. The tool exposes low-participation stretches at the edges of the volume body and interprets them directionally: thin regions above the concentrated activity are read as overhead vacuum that can act as resistance, while thin regions below are read as underlying vacuum that can act as support. These gaps mark the price territory the market crossed with little commitment, which is often where price moves quickly when revisited.
● Temporal Density Clustering
Two groups can hold identical volume yet mean very different things depending on how tightly that volume was packed in time. The tool quantifies the degree to which a group's participation is concentrated into a narrow window of active bars versus spread thinly across a wide span. Groups whose activity is tightly compressed can be flagged as temporal clusters, distinguishing a sudden concentrated burst from a slow, diffuse accumulation — a distinction that carries real interpretive weight for anticipating follow-through.
● Estimated Large-Participant Split
The tool separates the estimated footprint of outsized single prints from the estimated footprint of ordinary flow within each group. It does this by referencing a rolling percentile of recent activity, so the definition of an outsized print adapts to whether the market is currently quiet or volatile rather than being fixed to a single range. Each group can then reveal what share of its volume came from these outsized prints, and a group whose outsized share crosses a chosen dominance level is colored to reflect that large-participant character. This is explicitly an estimate drawn from volume behavior, not a confirmed identification of institutional trades.
● Absorption Footprint
Absorption describes the classic tell of disguised accumulation or distribution: a large slug of volume enters while price barely moves, as if an unseen participant is quietly soaking up everything offered. The tool flags prints that combine disproportionately large volume with a disproportionately small price range, surfacing moments where heavy activity failed to move price and thereby hinting at a hidden actor absorbing flow.
● Iceberg Refill Runs
An iceberg footprint appears as a sequence of adjacent prints with near-identical volume clustered at the same price level, the signature of a hidden order being repeatedly refilled as it is filled. The tool recognizes these runs, marks their completion, and can bracket the full span of the refill sequence with a count of how many prints participated. It can further read the net directional lean of the run — net-buying runs are interpreted as estimated accumulation and placed below the sequence, net-selling runs as estimated distribution and placed above, while balanced runs remain neutral. A tolerance for what counts as neutral prevents marginal imbalances from being over-interpreted.
● Whale Weight Rating
To help a trader rank groups at a glance, the tool assigns a one-to-three-star rating to each group based on its absolute large-participant weight — the outsized share multiplied by the group's total volume — measured against the strongest such group in the range. This deliberately rewards true weight over mere percentage: a group with a moderate outsized share of an enormous column can outrank a group with a high outsized share of a tiny one, so the stars reflect real participation heft rather than a misleading ratio.
● Anchored Institutional Fair Value
The tool exposes an anchored volume-weighted fair-value line built exclusively from the prints it estimates to be outsized, anchored to the active range origin. This line approximates the average price at which estimated large-participant volume engaged with the market. When price trades above this line, the market sits at a premium to that estimated fair value — a potential distribution zone; when price trades below it, the market sits at a discount — a potential accumulation zone. The live distance between price and this line, expressed as a percentage, gives a running read on how stretched the market has become relative to where the heavy money is estimated to have participated.
● Net Delta and Range Statistics
Alongside the visual anatomy, the tool maintains running statistics for the active range: the net directional balance of volume expressed as a percentage of total participation, the total volume captured, the price span of the range, the average participation per print, and the duration of the leg in bars. These give a trader a compact quantitative summary to complement the visual read.
🎨 Visual Guide
● The Vertical Columns and Groups
The core of the display is a field of upright volume elements planted beneath price. In grouped mode, coherent blocks of participation appear as shaded boxes spanning the bars that formed them, with the single heaviest group standing out in its dominant color. In raw mode, each unit of participation appears as its own vertical line, with the tallest drawn thicker and in the dominant hue. Labels sit atop each element showing either its share of total range volume or its raw traded volume, and adjacent labels can be staggered in height so they never collide when columns crowd together. Very small columns can keep their bar while hiding their label to keep the chart clean.
● The Dominant Zone
The heaviest group is framed by a pair of dashed boundary lines with a soft fill between them, marking the price-time region that anchored the most participation in the entire leg. This is the visual centerpiece — the area a trader most wants to see defended or broken on a retest.
● Exhaustion Gap Shading
Thin-participation regions at the edges of the volume body are shaded in two directional colors: one hue marks overhead vacuum read as resistance, the other marks underlying vacuum read as support, each carrying its own labeled share of range volume and its own text color so the two are never confused.
● Participation-Split Coloring
When the large-participant split is active, group boxes and their labels take on distinct colors depending on whether estimated outsized activity or ordinary flow dominates that group, and the label appends a compact whale-share readout. Temporal clusters receive their own accent border and marker color so a concentrated burst is immediately distinguishable from a diffuse group.
● Footprint Markers
Distinct emoji-led markers flag the specialized footprints: one marks prints exceeding an independent absolute activity threshold, one marks absorption prints, and one marks completed iceberg runs. Iceberg runs can additionally be wrapped in a span bracket with end ticks and a central print-count label, and their marker color shifts to signal estimated accumulation, distribution, or a neutral balance. Each marker carries a tooltip with the underlying figures for a closer look.
● Whale Star Ratings
Beneath qualifying groups, a vertical stack of one to three stars renders the group's relative large-participant weight, with earned stars filled and unearned positions shown at reduced opacity, plus a tooltip stating the exact weighting.
● The Anchored Fair-Value Line and Label
The anchored institutional fair-value line runs horizontally from the range origin to just beyond the latest bar, terminating in a label that states the line's value, whether price sits at a premium or discount, and the exact percentage distance. The label's color reflects the premium or discount state at a glance.
● The Metrics Panel
A compact monospace panel, positionable in any chart corner, presents a live readout of the tool's state: the structural trend, the anchor mode and age, the price range and total volume, an activity-buffer gauge, the dominance share, the render mode, the estimated whale dominance, net delta, absorption and iceberg counts, the outsized-print threshold, the dominant-zone span, the structural timeframe, average participation per print, the range duration, the anchored fair-value figure, and the current premium-or-discount status. Several rows include block-style gauges whose fill and color scale with the underlying reading, turning numbers into an at-a-glance strength meter.
📖 How to Use
● Step One — Choose Your Anchoring
Decide whether the tool should follow structure automatically or pin to a date you choose. For most workflows, leave it in automatic mode and select Micro sensitivity for intraday and scalping work or Macro sensitivity for swing and position work. If you are studying a specific historical episode, enable the manual anchor and set your start and, optionally, end dates.
● Step Two — Read the Structural State
Glance at the panel to confirm the prevailing trend and how mature the current leg is. A young anchor age means the move is fresh and the volume anatomy is still forming; a large anchor age means the leg is well developed and its dominant zone is well established.
● Step Three — Locate the Dominant Zone
Find the framed dominant zone — the region that anchored the most participation. Treat it as the leg's center of gravity: on a pullback, watch whether price stabilizes there or slices through it, as that behavior often distinguishes continuation from reversal.
● Step Four — Map the Gaps
Note the exhaustion gaps above and below the concentrated activity. These vacuum regions are where price tends to travel quickly when revisited, and they frame natural areas where support or resistance is thin.
● Step Five — Weigh Participation Quality
Consult the whale-share readouts, the star ratings, and the footprint markers. A dominant zone that is also whale-dominant and highly rated carries more interpretive weight than one built on ordinary flow. Absorption and iceberg markers highlight moments where hidden activity may have been at work.
● Step Six — Reference the Fair-Value Line
Use the anchored fair-value line as an equilibrium reference. Price at a premium suggests the market is extended above where heavy activity engaged; price at a discount suggests it is trading below that level. Combine this with the dominant zone and gaps to frame entries, targets, and invalidations.
● Step Seven — Automate with Alerts
Attach alerts so the tool notifies you when a new dominant zone forms, when absorption is detected, or when price flips to a premium or discount relative to the fair-value line, letting you monitor multiple markets without watching each chart.
⚙️ Inputs and Settings
● Core Settings
Enable Manual Anchor — bypasses automatic structural anchoring and starts the range from a date you choose.
Manual Start Date — the origin of the range when manual anchoring is active.
Manual End Date — the end of the manual range; ignored when the range is extended to the present.
Extend Range to Present — keeps the manual range running up to the latest bar rather than stopping at the manual end date.
● Filters
Anchor Mode — chooses Micro sensitivity for immediate structure and scalping, or Macro sensitivity for larger cycles and swing trading.
Structure Timeframe — the timeframe used to read highs, lows, and structural breaks; leave empty to use the chart timeframe.
Micro Swing Length — the sensitivity length for minor swing detection.
Macro Swing Length — the sensitivity length for major swing detection.
● Vertical Volume Settings
Use Custom Timeframe — enables a chosen lower timeframe for the underlying volume detail instead of an automatically selected one.
Custom Timeframe — the lower timeframe used to gather granular volume.
Show VV Groups & Gaps — renders consolidation groups and exhaustion gaps; when on, individual volume lines are hidden for clarity.
Flag Temporal Clusters — highlights groups whose participation is concentrated in a narrow time window.
Cluster Density Threshold % — the minimum bar-fill ratio required for a group to be flagged as a tight temporal cluster.
Show Raw Volume (not %) — displays actual traded volume in labels instead of a percentage of range volume.
Stagger Labels — alternates the height of adjacent group labels to prevent overlap.
Hide Labels Below % — hides labels for groups whose share of range volume falls below the set percentage.
Height % of Range — controls how tall the volume elements appear relative to the price range.
Enable Whale/Retail Split — separates estimated outsized activity from ordinary flow within each group using a percentile heuristic.
Whale Percentile — the volume percentile above which prints are classified as outsized.
Whale Rolling Window (Prints) — the number of recent prints used to set the outsized threshold, adapting it to current conditions.
Whale Dominance Threshold % — the minimum outsized share required for a group to be colored as large-participant-dominant.
Hide 0% Whale Columns — hides any group whose estimated outsized share is exactly zero.
Use Absolute LTF Avg Threshold — an independent reference that flags prints exceeding a multiple of recent average activity.
Absolute Avg Lookback (N) — the number of recent lower-timeframe candles used for that independent average.
Absolute Avg Multiplier — the multiple of average activity a print must exceed to be flagged.
Enable Absorption Filter — flags prints combining large volume with disproportionately small price movement.
Absorption Volume Multiplier — how far a print's volume must exceed the recent average to qualify as large.
Absorption Max Range % — the maximum relative price range a print may have and still qualify as absorption.
Enable Iceberg Detection — recognizes sequences of near-identical prints at one level; off by default to protect performance.
Iceberg Volume Tolerance % — the maximum volume deviation between consecutive prints for them to count as one run.
Iceberg Price Tolerance % — the maximum step-to-step price deviation for a run to continue at the same level.
Iceberg Min Repeats — the minimum consecutive matching prints required to flag a run.
Iceberg Scan Cap (Prints) — a hard limit on how many recent prints are scanned, protecting performance on large ranges.
Show Iceberg Span Bracket — draws a bracket spanning the full refill sequence with a print count.
Directional Iceberg Placement — places the marker below net-buying runs and above net-selling runs.
Iceberg Neutral Delta % — the delta band within which a run is treated as balanced.
● Whale Rating
Show Whale Star Rating — rates each group one to three stars by its absolute large-participant weight.
3-Star Threshold % — the relative weight at which a group earns three stars.
2-Star Threshold % — the relative weight at which a group earns two stars, below which it earns one.
● Institutional AVWAP
Show Institutional AVWAP (AIC) — displays the anchored fair-value line weighted only by estimated outsized prints.
Show AIC Label — toggles the line's value-and-status label.
AIC Line Width — sets the thickness of the fair-value line.
● Dashboard
Position — places the metrics panel in any chart corner.
● Alerts
Dominant Zone Action — the action label embedded in the dominant-zone alert payload.
Absorption Action — the action label embedded in the absorption alert payload.
AIC Premium Action — the action label embedded in the premium-flip alert payload.
AIC Discount Action — the action label embedded in the discount-flip alert payload.
● Colors
A full palette lets you set the bar color, dominant bar color, label backgrounds and text, dominant-zone fill, whale and retail colors, temporal-cluster accent, absolute-threshold and absorption markers, iceberg neutral, accumulation, distribution, bracket and text colors, star color, fair-value line and premium and discount colors, support and resistance gap colors and their text, and the full set of dashboard background, header, row, border, frame, bullish, bearish, neutral, mode, age, metric, and score colors.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Volume as the Language of Conviction
The tool sits in the lineage of volume-based market analysis that traces back to the tape-reading tradition and to the foundational work of Richard Wyckoff, whose framework of accumulation and distribution phases treated volume as the primary evidence of intent behind price. The distinction the tool draws between concentrated participation and thin vacuum echoes Wyckoff's insistence that effort, measured in volume, must be weighed against result, measured in price movement — the very comparison that underpins the absorption concept, where large effort producing little result signals a hidden actor at work.
● Volume Distribution and Value Theory
The idea of mapping where participation concentrates draws on the volume-distribution thinking popularized by market-profile theory, associated with the work of J. Peter Steidlmayer, which frames the market as constantly searching for areas of accepted value defined by where trade concentrates versus where it is rejected. Vertical Volume Pro inherits this value-search premise but re-expresses it along the time axis rather than the price axis, so that the dominant zone functions as a temporally aware analogue to a high-participation value area, and the exhaustion gaps function as analogues to the low-participation extremes the market moves through quickly.
● Anchored Volume-Weighted Fair Value
The anchored fair-value reference is grounded in the theory of the volume-weighted average price, a benchmark long used to define the participation-weighted centroid of trading over a defined window. By anchoring this benchmark to a structural origin and weighting it toward estimated outsized activity, the tool extends the standard VWAP concept in the spirit of anchored-VWAP methodologies, producing a reference that estimates the fair value seen by the heaviest participants rather than by the average of all flow. The premium-and-discount interpretation of price relative to this reference reflects the mean-reversion intuition embedded in benchmark-execution theory, where trading materially away from the participation-weighted centroid is treated as a stretched condition.
● Order Concealment and Microstructure
The absorption and iceberg concepts are rooted in market-microstructure research on how large participants conceal intent to minimize their market impact — the study of hidden and iceberg orders that reveal themselves only through their footprint in the trade record. The recognition of repeated near-identical prints at a stable price level as evidence of a refilled hidden order reflects the microstructure understanding that a large resting interest, when broken into slices, leaves a statistically distinctive signature even when the full order is never visible on the book. Framing these as estimates rather than certainties respects the core limitation of the field: from aggregated candle data one can infer a footprint but never confirm the order behind it.
● Regime Awareness and Structural Breaks
The tool's habit of re-anchoring to structural breaks connects to the broader literature on regime change and structural breaks in financial time series, where the recognition that a series' governing behavior has shifted is treated as essential to any measurement that follows. By resetting its measurement window at each break, the tool avoids the well-documented error of averaging across regimes and instead keeps every statistic conditioned on the currently prevailing state.
● Adaptive Thresholding
The choice to define outsized activity through a rolling percentile rather than a fixed cutoff reflects the statistical principle that a meaningful threshold must adapt to the local distribution of the data. By continually recomputing what counts as outsized against a moving window of recent activity, the tool guards against both the false positives that a fixed threshold produces in quiet conditions and the false negatives it produces in volatile ones — an application of adaptive, distribution-relative reasoning that keeps the classification honest across changing conditions.
⚠️ Disclaimer
This tool is provided for educational and informational purposes only and does not constitute financial, investment, or trading advice, nor a recommendation to buy or sell any security or instrument. All participation-quality readings, including large-participant estimates, absorption and iceberg footprints, and the anchored fair-value reference, are statistical estimates derived from aggregated volume behavior and are not confirmations of actual order origin or trade intent. Markets involve substantial risk, and past behavior does not guarantee future results. Any decisions made using this tool are taken solely at your own discretion and risk, and we accept no liability whatsoever for any loss or damage arising directly or indirectly from its use. Always conduct your own analysis and consider consulting a qualified professional before making any trading decision.
Integrated Financial Analysis Pro [MarkitTick] 💡 Institutional-grade financial analysis engine that transforms any TradingView chart into a professional-level quantitative research terminal. Rather than offering a single isolated metric, this tool orchestrates a full spectrum of return, risk, efficiency, and distributional statistics — simultaneously evaluated across five independently configurable time horizons — and renders them through a precision-crafted multi-period analytical dashboard. Designed to the exacting standards of portfolio management desks and quantitative research divisions, it delivers the analytical depth of a dedicated risk management platform directly on the chart, without requiring external software or data exports.
✨ Originality and Utility
● A Unified Quantitative Research Terminal on TradingView
The financial analysis landscape on TradingView is dominated by single-purpose indicators: one tool for Sharpe ratio, another for drawdown, yet another for beta. The Integrated Financial Analysis indicator abandons this fragmented paradigm entirely. It is engineered as a self-contained institutional research engine — one deployment that computes, renders, and cross-references the complete taxonomy of quantitative finance metrics in a single, coherent analytical environment. From raw return attribution through tail-risk quantification to efficiency ratio synthesis, every metric is evaluated in relation to every other, across every configured period, simultaneously.
● Five-Period Comparative Architecture
The defining architectural feature of this indicator is its five-dimensional temporal grid. Users configure five independent lookback periods — expressed in Days, Weeks, Months, or Years — and the engine produces a full metric profile for each without overlap or contamination between windows. This non-overlapping, sequential window design is intentional: it allows a portfolio analyst to observe, in a single glance, how a security's risk-adjusted profile evolves from short-term to long-term horizons, identifying whether outperformance is structurally persistent or episodic. No other publicly available TradingView indicator offers this degree of temporal granularity across such a broad metric set.
● Dual-Benchmark Architecture with Optional Secondary Index
The engine supports a configurable primary benchmark and an optional secondary index, giving institutional users the flexibility to evaluate a security's performance against multiple reference points — such as a broad market index and a sector-specific sub-index — without modifying the script. The active benchmark drives all relative metrics simultaneously: excess return, beta, alpha, tracking error, information ratio, upside and downside capture ratios, and active return are all anchored to the same user-selected reference universe.
● Adaptive Timeframe Intelligence
The indicator detects the active chart timeframe — daily, weekly, or monthly — and automatically calibrates all annualization denominators, period multipliers, and observation thresholds accordingly. The correct number of trading periods per year is derived at runtime, not hardcoded, ensuring that every ratio produced is internally consistent regardless of whether the chart is displaying daily bars, weekly candles, or monthly closes.
🔬 Methodology and Concepts
● Category I — Return and Performance Attribution
Stock Performance & Index Performance
Measures the cumulative percentage gain or loss of both the target security and the benchmark index over each configured period. These are the baseline reference values against which all relative metrics are computed.
Excess Return
Quantifies the differential between the security's total return and the benchmark's total return over the same window. A persistently positive excess return — especially across multiple time horizons simultaneously — is the primary indicator of alpha-generative capability rather than mere beta exposure.
Compound Annual Growth Rate (CAGR)
The geometrically annualized return over each period, normalized to a per-year basis regardless of the actual window length. CAGR eliminates the distortion caused by the arithmetic mean's inability to account for compounding, providing the most accurate measure of the security's long-run growth trajectory.
Regression Alpha (Jensen's Alpha)
The intercept term extracted from the proprietary multivariate regression engine embedded in the indicator's computation library. Alpha represents the portion of the security's return that is attributable neither to broad market exposure (beta) nor to the risk-free rate — it is the pure measure of manager skill or structural edge. The computation enforces a minimum observation threshold (configurable, defaulting to three months of trading periods) to prevent statistically invalid alpha estimates from appearing in the dashboard.
Upside Capture Ratio
Measures how much of the benchmark's positive return periods the security captures on average. A value above 1.0 signifies that the security amplifies bullish benchmark performance, which is desirable when combined with a low Downside Capture Ratio.
Downside Capture Ratio
The complement to Upside Capture — measures the security's average participation in the benchmark's negative return periods. A value below 1.0 signifies meaningful downside protection: the security loses less than the benchmark during market stress.
Composite Capture Ratio
The ratio of Upside Capture to Downside Capture. This single composite statistic encapsulates the asymmetry of the security's return profile: values substantially above 1.0 indicate favorable convexity — the security captures more upside than downside — which is the defining characteristic of superior risk-adjusted performance.
Hit Ratio
The proportion of periods within the selected window in which the security generated a positive return. Unlike CAGR or Sharpe Ratio, the Hit Ratio measures consistency of directionality rather than magnitude-weighted performance. A high Hit Ratio combined with strong Profit Factor identifies securities with both reliable return frequency and favorable win/loss magnitude distribution.
● Category II — Risk and Volatility Metrics
Annualized Standard Deviation
The annualized measure of the dispersion of the security's periodic returns around their mean. This is the denominator in the Sharpe and Treynor ratios and the primary measure of total realized volatility. All annualization is performed using the timeframe-calibrated period count.
Beta (Market Sensitivity)
The slope coefficient from the proprietary regression engine, measuring the sensitivity of the security's excess returns to movements in the benchmark's excess returns. A beta above 1.0 denotes an aggressive security amplifying market moves; below 1.0 denotes defensive behavior.
Downside Beta
A refined version of conventional beta that restricts the regression sample exclusively to periods in which the benchmark registered a negative return. Downside Beta isolates the security's co-movement with the market specifically during adverse conditions — an asymmetric risk measure that conventional beta obscures by averaging across all market regimes.
R-Squared (Coefficient of Determination)
The proportion of the security's return variance explained by the benchmark's movements. A high R-squared validates the interpretive relevance of the regression-derived Beta and Alpha: in a low R-squared environment, beta becomes a poor predictor and Alpha loses much of its statistical meaning.
Tracking Error
The annualized standard deviation of the active return series — the period-by-period difference between the security and the benchmark. Tracking Error is the primary measure of active management deviation and is directly used as the denominator of the Information Ratio.
Average Active Return
The arithmetic mean of the period-by-period excess return of the security over the benchmark, annualized to the configured period basis. Together with Tracking Error, this forms the numerator and denominator of the Information Ratio, and independently signals the consistency of outperformance relative to benchmark.
Value at Risk (VaR)
A statistical threshold measure that estimates the maximum loss the security would be expected to incur over the selected period under normal market conditions, at a specific confidence level. The computation requires a minimum observation threshold (configurable, defaulting to one year of trading periods) to ensure statistical significance of the distributional estimate. Displayed as a percentage of the security's current value. Note that VaR measures expected losses within the normal distribution of market conditions and does not capture tail events.
Conditional Value at Risk (CVaR / Expected Shortfall)
The expected value of losses beyond the VaR threshold — the average loss in worst-case scenarios. CVaR is a coherent risk measure that VaR is not: it satisfies the sub-additivity property required for proper portfolio aggregation. The same minimum observation threshold applied to VaR governs CVaR to maintain distributional reliability.
Downside Deviation
The annualized standard deviation of returns that fall below the user-configured Minimum Acceptable Return (MAR). Unlike total standard deviation, Downside Deviation ignores periods of outperformance relative to the MAR threshold, recognizing that upside volatility is not risk in the economically meaningful sense. This is the denominator of the Sortino Ratio.
Skewness
The third standardized moment of the return distribution, measuring directional asymmetry. Positive skewness indicates a distribution with a longer right tail — infrequent large gains — while negative skewness (common in equity strategies) indicates a distribution with a longer left tail — infrequent but large losses. The computation requires a minimum observation threshold of six months by default to achieve sufficient distributional stability.
Kurtosis
The fourth standardized moment, measuring tail heaviness relative to a normal distribution. Excess kurtosis above 3 (leptokurtosis) indicates fatter tails than assumed by Gaussian models, which implies that extreme events — both gains and losses — occur more frequently than standard risk models predict. This is a critical input for tail risk assessment beyond what VaR and CVaR alone capture.
Maximum Drawdown (MDD)
The largest peak-to-trough decline observed within the selected period. Maximum Drawdown measures the worst historical loss that a fully committed investor would have endured. It is the denominator of the Calmar Ratio and the primary measure of catastrophic risk tolerance.
Drawdown Duration
The length (in trading days) of the longest drawdown episode within the selected window — from the peak at which the drawdown began to the point of maximum loss. A long Drawdown Duration, even if the MDD percentage is moderate, signals persistent capital impairment risk.
Time to Recovery
The number of trading days required to fully recover from the Maximum Drawdown back to the prior peak. An asymmetry between MDD Percentage and Time to Recovery reveals the speed of mean reversion in the security's price discovery process. Prolonged recovery periods reduce the effective compounded return and are particularly destructive to capital allocation efficiency.
● Category III — Efficiency Ratios and Risk-Adjusted Returns
Sharpe Ratio
The excess return per unit of total volatility, annualized. The Sharpe Ratio is the most widely referenced risk-adjusted performance metric in institutional finance. The excess return is computed relative to the user-configured risk-free rate, and the denominator is the total annualized standard deviation of the security's returns. Values above 1.0 are generally considered acceptable; above 2.0, exceptional.
Sortino Ratio
The excess return per unit of downside deviation, computed against the user-configured Minimum Acceptable Return (MAR) threshold. By penalizing only harmful volatility — returns below the MAR — the Sortino Ratio provides a more economically rational measure of risk-adjusted performance for strategies that exhibit positive skewness or controlled drawdown profiles. The Sortino Ratio consistently produces higher values than Sharpe for strategies with right-skewed return distributions.
Calmar Ratio
The annualized return relative to the Maximum Drawdown. The Calmar Ratio bridges the performance domain and the catastrophic risk domain: it asks, in essence, how much return is generated per unit of worst-case loss endured. It is particularly valued in absolute return and alternative investment contexts where drawdown constraints are binding.
Treynor Ratio
The excess return per unit of systematic risk (beta) rather than total risk. The Treynor Ratio is appropriate for evaluating a security's contribution to a well-diversified portfolio, where idiosyncratic risk is assumed to be diversified away. It is computed from the same regression engine that produces Beta and Alpha.
Information Ratio
The average active return divided by the tracking error. The Information Ratio quantifies the consistency of outperformance relative to the benchmark: a high Information Ratio indicates not merely that the security has outperformed, but that it has done so with predictable, reliable regularity. Values above 0.5 are considered strong; above 1.0, exceptional, in institutional active management benchmarks.
Profit Factor
The ratio of the sum of all positive returns to the absolute sum of all negative returns within the selected period. A Profit Factor above 1.0 indicates that gross gains exceed gross losses; above 2.0 is generally considered robust. Unlike Sharpe Ratio, Profit Factor makes no distributional assumptions and is therefore insensitive to the non-normality that characterizes most financial return series.
🎨 Visual Guide
● Transposed Multi-Period Analytics Table
The on-chart table is rendered in transposed format: metrics are organized as rows along the left column, while the five configured time periods occupy the five data columns to the right. This layout is deliberately chosen for its analytical efficiency — the eye traverses the table horizontally across time horizons for a single metric, and vertically across metrics for a single period, enabling both temporal comparison and cross-metric synthesis without reorganizing the mental model.
Color coding is applied to each cell based on the metric's directional interpretation:
Green cells indicate values reflecting favorable conditions for that metric (e.g., positive Excess Return, Sortino above zero, Capture Ratio above 1.0).
Red cells indicate unfavorable values.
White cells indicate metrics that are directionally neutral (e.g., raw Drawdown Duration, Standard Deviation, Tracking Error) where color coding would impose a misleading directional judgment.
Header rows are color-differentiated by category: Performance and Ratio metrics use a blue header scheme; Risk and Volatility metrics use a purple header scheme, enabling rapid visual triage of the table by analytical domain.
The table is conditional: it renders only when the user has enabled at least one metric in the configuration, and suppresses entirely when Table Display Mode is set to "Hide All."
● Single Active Metric Plot with Dynamic Gradient Cloud
The plotting architecture enforces a single-active-metric principle: only one metric is visualized as the primary oscillator line at any given time, determined by the user's Plot Period configuration and metric selection. This design eliminates chart noise from overlapping oscillator lines and focuses analytical attention on the chosen metric's historical trajectory.
The active metric line is colored dynamically:
Bull color (configurable, default cyan-blue) for positive values — indicating favorable performance, efficiency, or positive excess return depending on the active metric.
Bear color (configurable, default red) for negative values.
A gradient fill cloud occupies the space between the metric line and the zero axis:
Bull cloud: A gradient from vivid at the peak to transparent at zero, rendering the magnitude of positive performance as a visual intensity gradient.
Bear cloud: A symmetric gradient below zero, signaling the depth of underperformance or negative efficiency.
A secondary envelope fill between the metric line and its moving average further highlights divergences between the current metric value and its trend baseline.
● Candle Coloring via Normalized Gradient Signal
When candle coloring is enabled and a plot metric is active, the chart's candles are recolored on the overlay pane according to a normalized gradient derived from the active metric's value relative to its own recent bull/bear force range. Candles are mapped on a smooth gradient spectrum from the Bear color (at the extreme negative end) through neutral to the Bull color (at the extreme positive end). This transforms the price candles into a visual heatmap of the current metric's quantitative state, allowing instantaneous assessment of whether the security's risk-adjusted posture is improving or deteriorating on a bar-by-bar basis.
● Moving Average Overlay
A configurable moving average is plotted alongside the active metric. In Auto mode, the MA length is automatically set to the timeframe-calibrated annual period count — one full year of trading bars — providing a natural long-run baseline for any metric. In Manual mode, the user specifies an explicit length. The MA can be applied to any of the 30 available metrics, enabling visual identification of trend inflections in Sortino Ratio, Information Ratio, Excess Return, or any other selected series.
● Zero Reference Line
A zero-axis reference line is rendered with automatic color adaptation based on the chart's background luminosity: dark on light themes, light on dark themes. This ensures legibility across all TradingView chart color schemes without manual adjustment.
📖 How to Use
● Establishing the Analytical Framework
Begin by configuring the Primary Market Index to the most relevant benchmark for the security under analysis. For equities, this is typically the broad market index (e.g., S&P 500, NASDAQ-100) or a sector-specific benchmark. For alternative or cross-asset analysis, the Secondary Index input can be activated to substitute a more precise reference universe. All relative metrics — Alpha, Beta, Tracking Error, Information Ratio, Capture Ratios, and Active Return — will immediately recalibrate to the selected benchmark.
● Configuring the Five Analytical Periods
Set the five period lengths and their unit type (Days, Weeks, Months, or Years) to reflect your investment horizon stack. A typical institutional setup might configure 1Y, 2Y, 3Y, 4Y, and 5Y to assess long-term statistical persistence, or a tactical setup might use shorter windows such as 3M, 6M, 1Y, 2Y, and 3Y to monitor both short-cycle tactical performance and strategic-cycle persistence simultaneously.
● Interpreting the Dashboard Table
Scan horizontally across a single metric row to identify whether performance characteristics are strengthening or weakening across time horizons. A Sortino Ratio that is strong at 1Y but weak at 3Y and 5Y suggests recent tactical outperformance that is not structurally persistent. Conversely, a consistently high Sharpe Ratio across all five periods indicates structurally superior risk-adjusted performance.
Scan vertically down a single period column to assess the holistic risk-adjusted profile for that specific window. A high CAGR with a poor Sortino and a large Maximum Drawdown reveals a volatile, drawdown-prone return stream that misleads when evaluated by raw return alone.
● Using the Plot Period for Temporal Forensics
The Plot Period is independent of the five table periods and can be set to any value within the supported range. Use this to select a specific analytical window for dynamic visualization. Plotting the Sortino Ratio with a 1-year Plot Period while the table displays 1Y through 5Y periods provides simultaneous static (tabular) and dynamic (oscillator) analysis of risk-adjusted efficiency across different temporal regimes.
● Identifying Risk-Adjusted Regime Shifts
The moving average on the active metric plot is the primary tool for regime detection. When the Sortino Ratio oscillator crosses below its annual moving average, it signals a deterioration in downside-adjusted performance relative to the recent trend — a potential early warning of risk regime transition. Combine this with the gradient candle coloring to identify whether the deterioration is occurring gradually or abruptly.
● Setting Academic Observation Thresholds
The three minimum observation settings — for regression-based metrics (Beta, Alpha, R-Squared), for distributional tail risk (VaR, CVaR), and for higher moments (Skewness, Kurtosis) — enforce statistical validity standards. When fewer bars than the configured threshold are available, the corresponding cells display "N/A" rather than producing numerically unreliable estimates. These thresholds should be calibrated to your statistical confidence requirements: increase them for higher-stakes decisions, reduce them for exploratory analysis on shorter datasets.
🎯Performance Metrics Reference Guide
─────────────────────────────────────────
01 — PERFORMANCE METRICS
─────────────────────────────────────────
▸ STOCK PERFORMANCE (Holding-Period Return)
Total price return of the instrument over the selected period.
Threshold: <0% | 0–10% | 10–20% | >20%
Recommendation: Meaningless without benchmark context — always read alongside Index Performance.
▸ INDEX PERFORMANCE (Benchmark Holding-Period Return)
Total return of the selected market index over the equivalent period.
Threshold: Serves as the passive baseline — the minimum return justifying active exposure.
Recommendation: Persistent underperformance vs. the index disqualifies the active approach on a risk-adjusted basis.
▸ EXCESS RETURN (Stock Perf − Index Perf)
Arithmetic difference between instrument return and benchmark return over the same period.
Threshold: <0% | 0–3% | 3–5% | >5%
Recommendation: Positive, consistent excess return across multiple periods is the primary empirical evidence of skill over passive indexing.
▸ CAGR (Compound Annual Growth Rate)
Geometric mean annualized return, smoothing compounding effects across multi-year periods.
Threshold: <7% | 7–12% | 12–20% | >20%
Recommendation: Must exceed risk-free rate + benchmark CAGR + inflation premium to justify active risk capital deployment.
▸ HIT RATIO (Win Rate)
Percentage of periods or trades generating a positive return.
Threshold: <45% | 45–55% | 55–65% | >65%
Recommendation: Never interpret in isolation — a 45% Hit Ratio with 2.5:1 reward/risk outperforms 65% with 0.8:1; always pair with Profit Factor.
▸ ALPHA (Regression-Based, Annualized)
Intercept of the OLS regression of excess stock returns on excess benchmark returns, annualized via CAPM.
Threshold: <0% | 0–2% | 2–5% | >5%
Recommendation: Valid only with ≥60 observations and R² >40% — low-R² Alpha is statistical noise, not skill.
▸ UPSIDE CAPTURE RATIO
Ratio of strategy mean return to benchmark mean return during positive benchmark periods.
Threshold: <80% | 80–100% | 100–120% | >120%
Recommendation: Must materially exceed 100% to justify the active risk premium — evaluate asymmetrically against Downside Capture.
▸ DOWNSIDE CAPTURE RATIO
Ratio of strategy mean return to benchmark mean return during negative benchmark periods.
Threshold: >100% | 80–100% | 60–80% | <60%
Recommendation: Institutional capital preservation mandates typically require Downside Capture <70% as a hard ceiling.
▸ CAPTURE RATIO (Upside ÷ Downside)
Composite measure of asymmetric market participation.
Threshold: <1.0 | 1.0–1.25 | 1.25–1.5 | >1.5
Recommendation: The single most direct quantitative measure of asymmetric skill — target >1.3 as the minimum viable institutional threshold.
─────────────────────────────────────────
02 — RISK METRICS
─────────────────────────────────────────
▸ ANNUALIZED STANDARD DEVIATION (Volatility)
Annualized standard deviation of log returns — the canonical measure of total portfolio risk.
Threshold: <10% | 10–20% | 20–30% | >30%
Recommendation: Any strategy exceeding 25% volatility must generate proportionately superior Sharpe and Sortino ratios to remain institutionally viable.
▸ BETA (Market Sensitivity)
OLS regression slope of excess stock returns on excess benchmark returns.
Threshold: <0 | 0–0.8 | 0.8–1.2 | >1.2
Recommendation: Align Beta with mandate — defensive portfolios target β <0.8; growth mandates accept β >1.2 only when Alpha is simultaneously positive.
▸ DOWNSIDE BETA
Beta estimated exclusively during periods when the benchmark posted negative returns.
Threshold: <0.7 | 0.7–1.0 | 1.0–1.2 | >1.2
Recommendation: Downside Beta must be materially lower than standard Beta — this divergence is the quantitative signature of genuine asymmetric risk management.
▸ R-SQUARED (Coefficient of Determination)
Proportion of the strategy's return variance explained by benchmark movements.
Threshold: <40% | 40–70% | 70–85% | >85%
Recommendation: Active managers should maintain R² <70% to justify fees above a passive ETF; index-replicating vehicles target R² >95%.
▸ TRACKING ERROR
Annualized standard deviation of active returns (strategy minus benchmark).
Threshold: <2% | 2–6% | 6–12% | >12%
Recommendation: Tracking Error above 10% demands an Information Ratio above 0.75 to remain institutionally defensible.
▸ AVERAGE ACTIVE RETURN (Avg Absolute Active Return)
Mean absolute magnitude of the strategy's deviation from the benchmark each period.
Threshold: Lower = more consistent tracking | Higher = greater active divergence from benchmark.
Recommendation: Its ratio to Tracking Error approximates the Information Ratio — the core efficiency measure of active management.
▸ VAR (Value at Risk — Annualized, 95% Confidence)
Maximum expected loss at a 95% confidence level over the observation period, scaled to annual.
Threshold: <10% | 10–20% | 20–30% | >30%
Recommendation: |VaR| must not exceed 50–60% of expected CAGR — when |VaR| > CAGR, the risk/return structure is broken.
▸ CVAR (Conditional Value at Risk / Expected Shortfall)
Mean of all losses exceeding the VaR threshold — the true cost of tail events.
Threshold: CVaR/VaR <1.3 | 1.3–1.6 | >1.6
Recommendation: Sharp CVaR/VaR divergence invalidates normal-distribution assumptions — mandatory switch to stress-testing frameworks at that point.
▸ DOWNSIDE DEVIATION
Annualized standard deviation of returns falling below the Minimum Acceptable Return (MAR).
Threshold: <5% | 5–10% | 10–15% | >15%
Recommendation: Reducing Downside Deviation requires eliminating large negative outliers — not suppressing all volatility; it is the Sortino denominator and directly determines ratio quality.
▸ SKEWNESS
Third standardized moment; measures asymmetry of the return distribution.
Threshold: < −1.0 | −1.0 to −0.5 | −0.5 to +0.5 | >+0.5
Recommendation: Negative skew combined with excess kurtosis is the defining statistical signature of blow-up risk — the profile of failed short-volatility and carry strategies.
▸ KURTOSIS
Fourth standardized moment; measures tail weight relative to a normal distribution (baseline = 3).
Threshold: ≈3 | 3–5 | 5–8 | >8
Recommendation: Kurtosis >6 invalidates standard VaR models — fat-tail hedging is mandatory and Gaussian risk estimates must be abandoned entirely.
▸ MAXIMUM DRAWDOWN (MDD)
Largest peak-to-trough percentage decline in the equity curve over the observation period.
Threshold: <10% | 10–20% | 20–35% | >35%
Recommendation: Institutional mandates cap MDD at 15–20%; always evaluate alongside Time to Recovery — depth alone is an incomplete risk picture.
▸ DRAWDOWN DURATION
Maximum consecutive number of periods the equity curve remained below its prior peak.
Threshold: <3 months | 3–12 months | 1–3 years | >3 years
Recommendation: Duration >12 months combined with MDD >20% is a composite red flag signaling strategy breakdown — not a temporary adverse cycle.
▸ TIME TO RECOVERY (Average)
Mean number of periods required to return to the prior equity peak following a drawdown.
Threshold: <3 months | 3–6 months | 6–12 months | >12 months
Recommendation: Average TTR >6 months paired with high MDD signals compounding destruction — capital locked in recovery generates zero excess return.
─────────────────────────────────────────
03 — ADVANCED RATIOS & EFFICIENCY
─────────────────────────────────────────
▸ SHARPE RATIO
Annualized excess return above the risk-free rate per unit of total standard deviation.
Threshold: <0 | 0–1.0 | 1.0–1.5 | 1.5–2.0 | >2.0
Recommendation: Minimum viable institutional threshold is >1.0 sustained; hedge funds typically mandate Sharpe >1.5 for capital allocation approval.
▸ SORTINO RATIO
Annualized excess return per unit of downside deviation below MAR.
Threshold: <0 | 0–1.0 | 1.0–2.0 | 2.0–3.0 | >3.0
Recommendation: A well-managed strategy's Sortino should run 30–60% above its own Sharpe — if Sortino ≈ Sharpe, no protective asymmetry exists in the return distribution.
▸ CALMAR RATIO
Annualized CAGR divided by Maximum Drawdown — return per unit of worst-case loss.
Threshold: <0.5 | 0.5–1.0 | 1.0–2.0 | >2.0
Recommendation: Minimum viable institutional threshold is 0.5; top systematic funds sustain 1.5–3.0 — particularly decisive for CTA and trend-following mandate compliance.
▸ TREYNOR RATIO
Annualized excess return per unit of systematic risk (Beta).
Threshold: <0 | >0 — benchmark against the market's own Treynor for meaningful comparison.
Recommendation: Use exclusively for cross-portfolio Beta-exposure comparison — invalid in isolation and unreliable for strategies with R² <40%.
▸ INFORMATION RATIO
Annualized active return divided by Tracking Error — the definitive efficiency measure of active management.
Threshold: <0.25 | 0.25–0.5 | 0.5–0.75 | >0.75
Recommendation: IR >0.5 sustained over 36+ months is the gold standard for institutional manager retention — always validate across multiple time horizons.
▸ PROFIT FACTOR
Ratio of total gross profit to total gross loss across all periods.
Threshold: <1.0 | 1.0–1.5 | 1.5–2.0 | 2.0–3.0 | >3.0
Recommendation: Minimum viable threshold for live capital deployment is >1.5; Profit Factor >3.0 in backtests demands rigorous overfitting scrutiny before allocation.
─────────────────────────────────────────
04 — RELATIVE STRENGTH (Plot Only)
─────────────────────────────────────────
▸ RELATIVE STRENGTH
Real-time ratio of instrument price to benchmark price, rebased to 100.
Threshold: >100 Rising | >100 Flat | <100 Declining
Recommendation: Trend slope matters more than absolute level — rising Relative Strength during benchmark weakness is the most constructive institutional confirmation signal.
⚙️ Inputs and Settings
● Market Indices
Primary Market Index: The benchmark symbol used as the reference universe for all relative metrics. Accepts any TradingView-accessible symbol.
Secondary Index (Optional): An alternative benchmark that replaces the primary when "Use Secondary Index" is enabled. Useful for sector-relative or custom benchmark analysis.
Use Secondary Index: Toggles the active benchmark between Primary and Secondary.
● Risk Parameters
Risk-Free Rate (Annual %): The annualized risk-free rate used to compute excess returns over the risk-free asset. Applied in Sharpe, Treynor, Jensen's Alpha, and related ratio computations. Expressed as a percentage (e.g., 5.0 for 5%). Default: 0.
Minimum Acceptable Return (MAR) for Sortino (%): The threshold return below which returns are classified as downside losses for the purposes of Downside Deviation and Sortino Ratio computation. Default: 0.
● Period Selection
Period Type: Unit of the five analytical periods. Options: Days, Weeks, Months, Years.
Period 1 through Period 5: Integer values defining each of the five analytical windows. All five periods are evaluated in parallel and displayed as five independent columns in the dashboard table.
● Plot Period Selection
Plot Period Type: Unit of the plot period, independent from the table period type.
Plot Period Value: Integer value defining the lookback window for the dynamic metric oscillator and its associated moving average.
● Table Columns Visibility
Table Display Mode: Master control with three options — Show All forces all metric columns visible regardless of individual toggles; Hide All suppresses the entire table entirely; Custom respects individual per-metric visibility toggles, enabling a tailored dashboard.
● 01 — Performance Metrics (Table & Plot)
Each metric in this group exposes two independent toggles — one for the table dashboard and one for the plot oscillator — allowing the user to include a metric in the tabular summary without necessarily activating it as the primary oscillator, and vice versa.
Stock Performance, Index Performance, Excess Return, CAGR, Capture Ratio, Hit Ratio, Alpha (Regression), Upside Capture, Downside Capture.
● 02 — Risk Metrics (Table & Plot)
Annualized Standard Deviation, Beta (Regression), Downside Beta, R-Squared, Tracking Error, Average Active Return, VaR, CVaR, Downside Deviation, Skewness, Kurtosis, Max Drawdown, Drawdown Duration, Time to Recovery.
● 03 — Advanced Ratios (Table & Plot)
Sharpe Ratio, Sortino Ratio, Calmar Ratio, Treynor Ratio, Information Ratio, Profit Factor.
● 04 — Misc Controls
Relative Strength (Plot): Activates a ratio-based relative strength oscillator comparing the security's price to the benchmark's price, normalized to a percentage scale. This does not appear in the table; it is a plot-only metric for visual trend comparison.
● Moving Average
Auto-Show MA for Visible Plots: When enabled, automatically renders the annual moving average for whichever metric is currently active in the oscillator pane.
Show Moving Average: Master toggle for the MA line.
MA Source: In manual mode, specifies which of the 30 available metrics the MA is computed over. Supports all metrics from both table and plot categories.
Auto MA Length / Manual Length: Toggles between the timeframe-calibrated annual period count (auto) and a user-specified integer length (manual).
● Color Settings
Bull Color: The color applied to positive metric values, the bull-side gradient cloud, and candles during positive signal regimes. Default: cyan-blue.
Bear Color: The color applied to negative metric values, the bear-side gradient cloud, and candles during negative signal regimes. Default: red.
MA Line Color: The color of the moving average line and its envelope fill. Default: amber.
● Hide or Show
Show Zero Line: Toggles the zero-axis reference line on the oscillator pane.
Show Analysis Table: Master toggle for the entire on-chart metric dashboard.
Show Gradient Cloud: Toggles the graduated fill between the metric line and zero, and the MA envelope fill.
Color Candles: Toggles gradient candle coloring on the price overlay pane.
● Academic Standards
Min Obs for Beta/Alpha (3 Months): Minimum bar count required for regression-derived metrics (Beta, Alpha, R-Squared, Treynor) to produce a valid output. Default: 60 bars.
Min Obs for VaR/CVaR (1 Year): Minimum bar count required for tail risk metrics. Default: 252 bars.
Min Obs for Skew/Kurt (6 Months): Minimum bar count required for higher distributional moment metrics. Default: 126 bars.
🔍 Deconstruction of the Underlying Scientific and Academic Framework
● Return Decomposition and Attribution Theory
The foundational architecture of this indicator is grounded in the Brinson-Hood-Beebower return attribution framework and its extensions. Returns are decomposed into systematic components (benchmark-attributable) and idiosyncratic components (security-specific), with the regression engine serving as the primary instrument of decomposition. The excess return series — the foundation of all risk-adjusted ratio computation — is constructed relative to the user-configured risk-free rate, consistent with Capital Market Theory's excess return formulation. All return series are derived from a continuous compounding framework, which provides additivity across periods and eliminates the geometric-vs-arithmetic mean distortion inherent in simple return aggregation across multi-period windows.
● Modern Portfolio Theory and CAPM Integration
The regression engine is calibrated to the Capital Asset Pricing Model (CAPM) framework: security excess returns are regressed against benchmark excess returns, yielding the systematic risk coefficient (Beta), the idiosyncratic return premium (Alpha), and the explanatory power of the model (R-Squared). Jensen's Alpha, as computed here, is the annualized constant term of this regression — the theoretically risk-adjusted measure of return that cannot be explained by market exposure alone. Downside Beta extends this framework into the Post-Modern Portfolio Theory (PMPT) domain by restricting the regression to the subset of periods where the benchmark's return is negative, isolating the security's co-movement with market stress rather than averaging it with benign periods.
● Downside Risk Paradigm and Post-Modern Portfolio Theory
The Sortino Ratio, Downside Deviation, CVaR, and Maximum Drawdown metrics collectively implement the Post-Modern Portfolio Theory framework developed by Rom and Ferguson (1994) as a systematic critique of the Markowitz mean-variance model. The core principle is that risk is not symmetric: investors do not uniformly penalize upside and downside volatility. By constructing a partial lower-moment framework — measuring only the variance of returns below the MAR threshold — these metrics align the mathematical definition of risk with its behavioral economic reality. The Sortino Ratio's use of semi-deviation rather than total standard deviation as the denominator directly embeds this asymmetric preference structure into the efficiency metric.
● Tail Risk and Extreme Value Theory
The VaR and CVaR computations address the empirically documented inadequacy of Gaussian return models. Financial return distributions exhibit persistent leptokurtosis — fat tails — and negative skewness, a combination that causes Gaussian VaR to systematically underestimate the probability and magnitude of extreme losses. CVaR (also known as Expected Shortfall) is a coherent risk measure in the sense defined by Artzner, Delbaen, Eber, and Heath (1999): it satisfies monotonicity, sub-additivity, homogeneity, and translational invariance. The sub-additivity property is particularly critical: it ensures that the combined CVaR of a portfolio is always less than or equal to the sum of the individual CVaRs, making CVaR compatible with portfolio aggregation arithmetic that VaR violates. The minimum observation thresholds enforced for these metrics reflect their well-known sensitivity to sample size: both VaR and CVaR require sufficient distributional sampling to produce statistically stable confidence interval estimates.
● Information Ratio and Active Management Efficiency
The Information Ratio, as deployed here, follows the Grinold and Kahn formulation from "Active Portfolio Management" (2000): annualized active return divided by annualized tracking error. This ratio encapsulates the fundamental law of active management in a single statistic. Grinold's Fundamental Law states that the Information Ratio of a strategy is approximately equal to the information coefficient (IC — the per-period predictive skill) multiplied by the square root of the breadth (number of independent bets). A strategy with broad diversification but modest per-bet skill can achieve the same Information Ratio as a concentrated strategy with high per-bet skill. The indicator exposes both the numerator (Average Active Return) and denominator (Tracking Error) as independent metrics, enabling the user to decompose the IR into its constituent drivers.
● Capture Ratio Asymmetry and Convexity Measurement
The Upside and Downside Capture Ratios implement a conditional performance attribution that partitions the benchmark's return history into two exclusive regimes: periods of positive benchmark return and periods of negative benchmark return. The security's average return in each regime, normalized by the benchmark's average return in the same regime, produces the two capture statistics. Their ratio — the Composite Capture Ratio — is a direct measure of the convexity of the return relationship between the security and the benchmark. A ratio substantially above 1.0 indicates that the payoff profile is convex — the security behaves like a long option on the benchmark — which is the behavioral signature of strategies that exhibit positive tail dependency in bull markets and negative tail dependency in bear markets.
● Profit Factor and Distribution-Free Performance Assessment
The Profit Factor is the sole metric in the indicator's suite that makes no parametric distributional assumption. It is computed directly from the empirical return series as the ratio of gross positive returns to the absolute value of gross negative returns. This distribution-free characteristic is particularly valuable when Kurtosis is elevated: in leptokurtic environments, parametric measures like Sharpe Ratio are biased by the fat-tail contamination of the standard deviation estimate. The Profit Factor remains unaffected by distributional shape, making it a robust complement to parametric ratio metrics in any fat-tailed return environment.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion.
