INVITE-ONLY SCRIPT
Volume Oracle - Regime Detection
Volume Oracle - Regime Detection
Volume Oracle transforms raw volume data into a regime-based flow analysis framework. The indicator is designed to help traders identify periods of accumulation and distribution through five integrated analytical layers: regime detection, market structure validation, volume footprint analysis, quality scoring, and multi-timeframe confluence.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗢𝗩𝗘𝗥𝗩𝗜𝗘𝗪
Volume analysis has long been considered a window into market participant activity. Large players cannot move size without leaving footprints in the volume record. Traditional volume indicators show raw numbers, but interpreting whether elevated volume represents accumulation or distribution requires additional context.
Volume Oracle builds on this foundation by adding five analytical layers:
• Regime Detection: Classifies the current market state as Accumulation (buying pressure), Distribution (selling pressure), or Neutral (no clear direction) using a composite scoring system that weighs price velocity, trend alignment, and volume-weighted flow.
• Market Structure Validation: Tracks swing highs and lows to determine if price structure (higher highs/higher lows vs lower highs/lower lows) agrees with the detected regime.
• Volume Footprint Analysis: Classifies volume spikes as either Momentum bars (large body, small wicks indicating directional conviction) or Absorption bars (small body, large wicks indicating supply/demand absorption).
• Quality Scoring System: Rates each signal from 0-100% based on multiple confluence factors, displayed as star ratings for quick visual assessment.
• Multi-Timeframe Confluence: Optional higher timeframe filters that require regime alignment across multiple timeframes before generating signals.
The indicator adapts all parameters automatically based on the chart timeframe, with different settings optimized for scalping, intraday, swing, and position trading styles.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗛𝗢𝗪 𝗜𝗧 𝗪𝗢𝗥𝗞𝗦
The indicator is built around one core principle: market participant activity may reveal itself through the relationship between volume, price movement, and market structure.
𝗥𝗲𝗴𝗶𝗺𝗲 𝗗𝗲𝘁𝗲𝗰𝘁𝗶𝗼𝗻 𝗦𝘆𝘀𝘁𝗲𝗺
What it does: The regime engine calculates a composite score using four weighted components: recent price velocity (where price is heading now versus recent history), trend alignment (EMA stacking and price position relative to moving averages), volume-weighted flow (proportion of volume occurring on up-closes versus down-closes), and volume confirmation (whether current volume exceeds average). The score passes through an EMA smoothing filter and must exceed configurable thresholds for multiple consecutive bars before a regime change is confirmed.
How to interpret it: When the indicator shows Accumulation, this suggests buying pressure currently dominates. Distribution suggests selling pressure dominates. Neutral indicates no clear directional bias. The regime state colors the volume bars: green tints during accumulation, red tints during distribution, gray during neutral periods. A subtle background shade reinforces the current regime.
𝗠𝗮𝗿𝗸𝗲𝘁 𝗦𝘁𝗿𝘂𝗰𝘁𝘂𝗿𝗲 𝗩𝗮𝗹𝗶𝗱𝗮𝘁𝗶𝗼𝗻
What it does: The indicator tracks recent swing highs and swing lows using pivot detection. It compares the most recent swing points to previous ones to determine if price is making higher highs and higher lows (bullish structure), lower highs and lower lows (bearish structure), or mixed patterns.
How to interpret it: When structure aligns with regime (bullish structure during accumulation, bearish structure during distribution), the regime table displays a checkmark. When structure conflicts with regime, this may suggest the regime is losing conviction. Structure validation appears in the regime table and factors into signal quality scores.
𝗩𝗼𝗹𝘂𝗺𝗲 𝗙𝗼𝗼𝘁𝗽𝗿𝗶𝗻𝘁 𝗔𝗻𝗮𝗹𝘆𝘀𝗶𝘀
What it does: On volume spike bars, the indicator analyzes the candle structure. Momentum bars have large bodies relative to their range (directional conviction). Absorption bars have small bodies with large wicks (supply or demand being absorbed without moving price significantly).
How to interpret it: Momentum bars during a trend may suggest strong directional conviction pushing price. Absorption bars may suggest supply or demand being absorbed at support or resistance without significant price movement. Footprint type factors into signal quality and triggers dedicated alerts.
𝗤𝘂𝗮𝗹𝗶𝘁𝘆 𝗦𝗰𝗼𝗿𝗶𝗻𝗴 𝗦𝘆𝘀𝘁𝗲𝗺
What it does: Each signal receives a quality score from 0-100% based on multiple factors: volume spike strength, flow direction conviction, trend alignment, regime strength, regime freshness, squeeze proximity, HTF alignment (if enabled), momentum acceleration, structure agreement, footprint type, market character (trending vs choppy), and confluence count. High signal density (many signals in a short period) reduces quality scores.
How to interpret it: Signals display star ratings: three stars for scores above 85%, two stars for 75-84%, one star for 65-74%, and no stars below 65%. A target emoji appears when five or more confluence factors align. Higher quality scores suggest more factors agreeing, though this does not guarantee outcomes.
𝗠𝘂𝗹𝘁𝗶-𝗧𝗶𝗺𝗲𝗳𝗿𝗮𝗺𝗲 𝗖𝗼𝗻𝗳𝗹𝘂𝗲𝗻𝗰𝗲
What it does: When enabled, the indicator fetches data from one or two higher timeframes and calculates simplified regime scores for each. It checks whether HTF regimes match the current timeframe regime, whether HTF strength exceeds a minimum threshold, and whether HTF regimes are strengthening rather than weakening.
How to interpret it: When all HTF conditions align, signals display an additional emoji indicator. In strict mode, signals only appear when HTF agrees. The HTF table shows regime state, strength percentage, trend direction, and alignment status for each configured timeframe.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗪𝗛𝗬 𝗧𝗛𝗘𝗦𝗘 𝗖𝗢𝗠𝗣𝗢𝗡𝗘𝗡𝗧𝗦 𝗪𝗢𝗥𝗞 𝗧𝗢𝗚𝗘𝗧𝗛𝗘𝗥
Each layer addresses a different aspect of market analysis:
1. Regime Detection: Establishes the directional bias using volume-weighted evidence.
2. Structure Validation: Confirms whether price action supports the detected regime.
3. Footprint Analysis: Characterizes the nature of volume activity on spikes.
4. Quality Scoring: Synthesizes all factors into a single actionable metric.
5. Multi-Timeframe Filter: Reduces noise by requiring agreement across timeframes.
When multiple factors align (strong regime, confirming structure, momentum footprint, high quality score, HTF agreement), this represents maximum confluence. Such conditions may warrant closer examination, though they do not guarantee any particular outcome.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗛𝗢𝗪 𝗧𝗢 𝗨𝗦𝗘
This section provides step-by-step guidance for interpreting the indicator's visual elements.
𝗦𝘁𝗲𝗽 𝟭: 𝗜𝗱𝗲𝗻𝘁𝗶𝗳𝘆 𝘁𝗵𝗲 𝗖𝘂𝗿𝗿𝗲𝗻𝘁 𝗥𝗲𝗴𝗶𝗺𝗲
Look at the regime table in the corner of the chart. The top row shows the current regime state: ACCUMULATION, DISTRIBUTION, or NEUTRAL. The color matches the regime (green, red, or gray).
• Volume bars tinted green suggest accumulation regime
• Volume bars tinted red suggest distribution regime
• Volume bars gray indicate neutral regime
The regime provides context for all other readings. Trading with the regime (buying during accumulation, selling during distribution) aligns with the detected flow direction.
𝗦𝘁𝗲𝗽 𝟮: 𝗔𝘀𝘀𝗲𝘀𝘀 𝗥𝗲𝗴𝗶𝗺𝗲 𝗛𝗲𝗮𝗹𝘁𝗵
The regime table displays multiple health indicators:
• Strength percentage: Higher values suggest stronger conviction
• Status: STRONG, FADING, WEAKENING, or CRITICAL
• Health: Composite warning indicator (HEALTHY, WATCH, CAUTION, DANGER)
• Structure: Whether price structure agrees with regime
• Market: Whether conditions are TRENDING, NORMAL, or CHOPPY
• Flip: Whether a regime change is building
When status shows FADING or worse, the regime may be losing conviction. Yellow-tinted volume bars appear after three consecutive bars of weakening status, providing early warning of potential regime changes.
𝗦𝘁𝗲𝗽 𝟯: 𝗪𝗮𝘁𝗰𝗵 𝗳𝗼𝗿 𝗦𝗶𝗴𝗻𝗮𝗹𝘀
Bullish signals appear as green labels with an up arrow above volume spikes during accumulation. Bearish signals appear as red labels with a down arrow during distribution. Labels include:
• Star ratings indicating quality (more stars suggest more confluence)
• Target emoji when five or more factors align
• HTF emoji when higher timeframe agrees
Hover over any signal label to see detailed tooltip information including quality percentage, risk levels, position sizing suggestions, and specific confluence factors present.
𝗦𝘁𝗲𝗽 𝟰: 𝗖𝗵𝗲𝗰𝗸 𝗛𝗧𝗙 𝗔𝗹𝗶𝗴𝗻𝗺𝗲𝗻𝘁 (𝗜𝗳 𝗘𝗻𝗮𝗯𝗹𝗲𝗱)
When multi-timeframe filtering is enabled, a second table appears showing HTF regime states. Green checkmarks indicate alignment, red X marks indicate disagreement. For maximum confluence, all timeframes should agree on regime direction.
𝗦𝘁𝗲𝗽 𝟱: 𝗠𝗼𝗻𝗶𝘁𝗼𝗿 𝗘𝘅𝗶𝘁 𝗪𝗮𝗿𝗻𝗶𝗻𝗴𝘀
Yellow warning labels appear when exit conditions trigger: regime flips, flow reversals, critical weakness, time-based exits, or target hits. These suggest reviewing open positions. The tooltip explains the specific exit reason.
𝗦𝘁𝗲𝗽 𝟲: 𝗖𝗼𝗺𝗯𝗶𝗻𝗲 𝗠𝘂𝗹𝘁𝗶𝗽𝗹𝗲 𝗙𝗮𝗰𝘁𝗼𝗿𝘀
The indicator provides the most context when multiple elements align:
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘈 (𝘛𝘳𝘦𝘯𝘥 𝘊𝘰𝘯𝘵𝘪𝘯𝘶𝘢𝘵𝘪𝘰𝘯): Regime shows ACCUMULATION at 72% strength with STRONG status. Structure displays checkmark (HH/HL confirmed). Market character shows TRENDING. A volume spike triggers a bullish signal with two stars and HTF alignment. Multiple factors agreeing during an established regime suggests trend may continue, though no outcome is guaranteed.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘉 (𝘔𝘰𝘮𝘦𝘯𝘵𝘶𝘮 𝘍𝘢𝘥𝘪𝘯𝘨): Regime shows DISTRIBUTION but status has shifted to FADING. Strength dropped from 65% to 48% over recent bars. Structure shows conflict (regime bearish but structure making higher lows). Volume bars have turned yellow. This type of internal disagreement often appears before regime changes or consolidation periods.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘊 (𝘌𝘹𝘩𝘢𝘶𝘴𝘵𝘪𝘰𝘯 𝘞𝘢𝘳𝘯𝘪𝘯𝘨): After an extended rally, regime shows ACCUMULATION but status reads CRITICAL. Health indicator shows CAUTION with two warnings active. An absorption bar appears (volume spike with small body and large upper wick). The Flip row shows regime change building. None of this guarantees reversal, but multiple warning signs appearing together suggest caution.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘋 (𝘉𝘳𝘦𝘢𝘬𝘰𝘶𝘵 𝘍𝘳𝘰𝘮 𝘊𝘰𝘯𝘴𝘰𝘭𝘪𝘥𝘢𝘵𝘪𝘰𝘯): Regime has shown NEUTRAL for several sessions with volume bars gray and muted. Market character displays CHOPPY. Then a volume spike triggers with regime flipping to ACCUMULATION, confirmed by structure shift to HH/HL. A three-star signal appears with target emoji. When multiple elements shift together after a quiet period, consolidation may be resolving into a directional move.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗡𝗔𝗩𝗜𝗚𝗔𝗧𝗜𝗡𝗚 𝗗𝗜𝗙𝗙𝗘𝗥𝗘𝗡𝗧 𝗠𝗔𝗥𝗞𝗘𝗧 𝗖𝗢𝗡𝗗𝗜𝗧𝗜𝗢𝗡𝗦
𝗧𝗿𝗲𝗻𝗱𝗶𝗻𝗴 𝗠𝗮𝗿𝗸𝗲𝘁𝘀
During sustained trends, the indicator typically shows persistent regime state (accumulation in uptrends, distribution in downtrends) with STRONG status and TRENDING market character. Structure should confirm with appropriate swing point patterns. Signals receive quality bonuses during trending conditions. Focus on signals that align with the established regime rather than counter-trend setups. The regime strength percentage and status provide ongoing confirmation that the trend remains healthy.
𝗥𝗮𝗻𝗴𝗶𝗻𝗴 𝗠𝗮𝗿𝗸𝗲𝘁𝘀
During consolidation, expect frequent regime shifts between accumulation, distribution, and neutral. Market character will display CHOPPY, and quality scores receive penalties. Structure may show mixed readings. Signal frequency increases but quality decreases. Consider using stricter filtering (higher volume threshold, HTF requirement) or waiting for regime stability before acting. The stability index in the regime table tracks flip frequency to help identify choppy conditions.
𝗛𝗶𝗴𝗵 𝗩𝗼𝗹𝗮𝘁𝗶𝗹𝗶𝘁𝘆 𝗘𝘃𝗲𝗻𝘁𝘀
During news events or volatility spikes, the auto-adapt feature adjusts thresholds based on ATR readings. Higher volatility raises the bar for regime changes, reducing whipsaws. Volume spikes during high volatility require greater statistical significance. The regime table tooltip shows current adaptive settings for transparency. Signals during extreme volatility should be interpreted with additional caution.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗧𝗘𝗖𝗛𝗡𝗜𝗖𝗔𝗟 𝗗𝗘𝗧𝗔𝗜𝗟𝗦
• Volume spike detection uses z-score normalization against a lookback window
• Regime scoring combines velocity, trend, flow, and volume components with configurable weights
• Regime changes require multi-bar confirmation above thresholds
• Structure detection uses pivot-based swing point identification
• Footprint classification analyzes body-to-range ratio and wick proportions
• Quality scoring aggregates multiple factors with caps and multipliers
• HTF data uses request.security with lookahead disabled (non-repainting)
• All signals fire on bar close only (non-repainting architecture)
• Parameters adapt automatically based on timeframe category
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗨𝗡𝗜𝗤𝗨𝗘 𝗙𝗘𝗔𝗧𝗨𝗥𝗘𝗦
• Timeframe Adaptive: All parameters (lookbacks, thresholds, confirmations) automatically scale based on whether the chart shows scalp, intraday, swing, or position timeframes.
• Multi-Layer Warning System: Four warning levels (STRONG, FADING, WEAKENING, CRITICAL) provide graduated alerts as regimes deteriorate, rather than binary flip signals.
• Structure-Regime Validation: Cross-references detected regime against actual price structure (swing highs/lows) to identify potential divergences.
• Volume Footprint Classification: Distinguishes between momentum-driven volume spikes and absorption patterns that may indicate different market participant behavior.
• Quality-Based Position Sizing: Suggested position sizes scale based on signal quality, with higher confluence signals receiving larger size recommendations.
• Non-Repainting Architecture: All calculations use confirmed bar data only. Historical display matches real-time behavior exactly.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗦𝗘𝗧𝗧𝗜𝗡𝗚𝗦 𝗢𝗩𝗘𝗥𝗩𝗜𝗘𝗪
• Detection: Volume spike threshold, signal cooldown, regime sensitivity mode, auto-adapt toggle, warning display toggle
• Risk: Account size, risk percentage, ATR length, stop/target multipliers, partial exit percentage, trailing stop and breakeven settings
• Multi-Timeframe: HTF enable toggles, timeframe selections, strict mode, minimum HTF strength threshold
• Strategy: Trading mode selection (Trend Following, Mean Reversion, or Hybrid), mean reversion threshold
• Display: Toggles for regime table, background colors, exit warnings, quality stars, management labels, tooltips, and HTF table
• Table Style: Layout orientation, table positions, text sizes, border and frame widths
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗔𝗟𝗘𝗥𝗧𝗦
25 alert conditions available:
• Bull Signal / Bear Signal / Any Signal: Core directional signals with quality and position details
• Target 1 Hit / Breakeven: Position management milestones
• Exit Warning: Triggered when exit conditions appear
• Regime to Accumulation / Distribution / Neutral: Individual regime change alerts
• Any Regime Change: Fires on any regime transition
• Regime Weakening: Early warning of deteriorating regime
• Momentum Fading / Flow Deteriorating / Volume Drying: Leading exit indicators
• Multiple Warnings: Fires when two or more warning conditions active
• HTF Aligned / HTF Broke: Multi-timeframe alignment changes
• Structure Bullish / Structure Bearish: Price structure shifts
• Structure Conflict: When structure disagrees with regime
• Momentum Footprint / Absorption Footprint: Volume footprint detection
• Market Trending / Market Choppy: Market character changes
• High Confluence Signal: Signals with five or more factors aligned
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗟𝗜𝗠𝗜𝗧𝗔𝗧𝗜𝗢𝗡𝗦
• Requires Volume Data: Instruments without reliable volume data (some forex pairs, indices) will produce unreliable readings.
• Analysis Tool, Not Signal Generator: This indicator identifies conditions that may warrant attention. It does not provide entry/exit instructions and should not be followed mechanically.
• Lagging Component: Regime detection requires confirmation bars, introducing necessary lag. Fast reversals may not be captured in time.
• No Guarantee of Outcomes: High quality scores and multiple confluence factors improve context but do not predict results. Markets can move against any setup.
• HTF Limitations: Higher timeframe data updates on HTF bar closes, not continuously. Brief alignment windows may be missed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗖𝗢𝗡𝗖𝗟𝗨𝗦𝗜𝗢𝗡
Volume Oracle provides a structured framework for analyzing volume flow through regime detection, structure validation, footprint classification, quality scoring, and multi-timeframe confluence. The indicator is designed to help traders identify accumulation and distribution phases and assess the conviction behind detected regimes. Multiple warning systems provide early indication when regimes may be losing strength.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗗𝗜𝗦𝗖𝗟𝗔𝗜𝗠𝗘𝗥
Trading is risky and most traders lose money. This indicator is provided for informational and educational purposes only. It does not constitute financial advice, and past performance does not guarantee future results. All content, tools, and analysis should not be considered as recommendations to buy or sell any asset. Users are solely responsible for their own trading decisions. Always use proper risk management and consider consulting a qualified financial advisor before making trading decisions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Built with PineScript v6. Non-repainting. All signals confirmed on bar close.
Volume Oracle transforms raw volume data into a regime-based flow analysis framework. The indicator is designed to help traders identify periods of accumulation and distribution through five integrated analytical layers: regime detection, market structure validation, volume footprint analysis, quality scoring, and multi-timeframe confluence.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗢𝗩𝗘𝗥𝗩𝗜𝗘𝗪
Volume analysis has long been considered a window into market participant activity. Large players cannot move size without leaving footprints in the volume record. Traditional volume indicators show raw numbers, but interpreting whether elevated volume represents accumulation or distribution requires additional context.
Volume Oracle builds on this foundation by adding five analytical layers:
• Regime Detection: Classifies the current market state as Accumulation (buying pressure), Distribution (selling pressure), or Neutral (no clear direction) using a composite scoring system that weighs price velocity, trend alignment, and volume-weighted flow.
• Market Structure Validation: Tracks swing highs and lows to determine if price structure (higher highs/higher lows vs lower highs/lower lows) agrees with the detected regime.
• Volume Footprint Analysis: Classifies volume spikes as either Momentum bars (large body, small wicks indicating directional conviction) or Absorption bars (small body, large wicks indicating supply/demand absorption).
• Quality Scoring System: Rates each signal from 0-100% based on multiple confluence factors, displayed as star ratings for quick visual assessment.
• Multi-Timeframe Confluence: Optional higher timeframe filters that require regime alignment across multiple timeframes before generating signals.
The indicator adapts all parameters automatically based on the chart timeframe, with different settings optimized for scalping, intraday, swing, and position trading styles.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗛𝗢𝗪 𝗜𝗧 𝗪𝗢𝗥𝗞𝗦
The indicator is built around one core principle: market participant activity may reveal itself through the relationship between volume, price movement, and market structure.
𝗥𝗲𝗴𝗶𝗺𝗲 𝗗𝗲𝘁𝗲𝗰𝘁𝗶𝗼𝗻 𝗦𝘆𝘀𝘁𝗲𝗺
What it does: The regime engine calculates a composite score using four weighted components: recent price velocity (where price is heading now versus recent history), trend alignment (EMA stacking and price position relative to moving averages), volume-weighted flow (proportion of volume occurring on up-closes versus down-closes), and volume confirmation (whether current volume exceeds average). The score passes through an EMA smoothing filter and must exceed configurable thresholds for multiple consecutive bars before a regime change is confirmed.
How to interpret it: When the indicator shows Accumulation, this suggests buying pressure currently dominates. Distribution suggests selling pressure dominates. Neutral indicates no clear directional bias. The regime state colors the volume bars: green tints during accumulation, red tints during distribution, gray during neutral periods. A subtle background shade reinforces the current regime.
𝗠𝗮𝗿𝗸𝗲𝘁 𝗦𝘁𝗿𝘂𝗰𝘁𝘂𝗿𝗲 𝗩𝗮𝗹𝗶𝗱𝗮𝘁𝗶𝗼𝗻
What it does: The indicator tracks recent swing highs and swing lows using pivot detection. It compares the most recent swing points to previous ones to determine if price is making higher highs and higher lows (bullish structure), lower highs and lower lows (bearish structure), or mixed patterns.
How to interpret it: When structure aligns with regime (bullish structure during accumulation, bearish structure during distribution), the regime table displays a checkmark. When structure conflicts with regime, this may suggest the regime is losing conviction. Structure validation appears in the regime table and factors into signal quality scores.
𝗩𝗼𝗹𝘂𝗺𝗲 𝗙𝗼𝗼𝘁𝗽𝗿𝗶𝗻𝘁 𝗔𝗻𝗮𝗹𝘆𝘀𝗶𝘀
What it does: On volume spike bars, the indicator analyzes the candle structure. Momentum bars have large bodies relative to their range (directional conviction). Absorption bars have small bodies with large wicks (supply or demand being absorbed without moving price significantly).
How to interpret it: Momentum bars during a trend may suggest strong directional conviction pushing price. Absorption bars may suggest supply or demand being absorbed at support or resistance without significant price movement. Footprint type factors into signal quality and triggers dedicated alerts.
𝗤𝘂𝗮𝗹𝗶𝘁𝘆 𝗦𝗰𝗼𝗿𝗶𝗻𝗴 𝗦𝘆𝘀𝘁𝗲𝗺
What it does: Each signal receives a quality score from 0-100% based on multiple factors: volume spike strength, flow direction conviction, trend alignment, regime strength, regime freshness, squeeze proximity, HTF alignment (if enabled), momentum acceleration, structure agreement, footprint type, market character (trending vs choppy), and confluence count. High signal density (many signals in a short period) reduces quality scores.
How to interpret it: Signals display star ratings: three stars for scores above 85%, two stars for 75-84%, one star for 65-74%, and no stars below 65%. A target emoji appears when five or more confluence factors align. Higher quality scores suggest more factors agreeing, though this does not guarantee outcomes.
𝗠𝘂𝗹𝘁𝗶-𝗧𝗶𝗺𝗲𝗳𝗿𝗮𝗺𝗲 𝗖𝗼𝗻𝗳𝗹𝘂𝗲𝗻𝗰𝗲
What it does: When enabled, the indicator fetches data from one or two higher timeframes and calculates simplified regime scores for each. It checks whether HTF regimes match the current timeframe regime, whether HTF strength exceeds a minimum threshold, and whether HTF regimes are strengthening rather than weakening.
How to interpret it: When all HTF conditions align, signals display an additional emoji indicator. In strict mode, signals only appear when HTF agrees. The HTF table shows regime state, strength percentage, trend direction, and alignment status for each configured timeframe.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗪𝗛𝗬 𝗧𝗛𝗘𝗦𝗘 𝗖𝗢𝗠𝗣𝗢𝗡𝗘𝗡𝗧𝗦 𝗪𝗢𝗥𝗞 𝗧𝗢𝗚𝗘𝗧𝗛𝗘𝗥
Each layer addresses a different aspect of market analysis:
1. Regime Detection: Establishes the directional bias using volume-weighted evidence.
2. Structure Validation: Confirms whether price action supports the detected regime.
3. Footprint Analysis: Characterizes the nature of volume activity on spikes.
4. Quality Scoring: Synthesizes all factors into a single actionable metric.
5. Multi-Timeframe Filter: Reduces noise by requiring agreement across timeframes.
When multiple factors align (strong regime, confirming structure, momentum footprint, high quality score, HTF agreement), this represents maximum confluence. Such conditions may warrant closer examination, though they do not guarantee any particular outcome.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗛𝗢𝗪 𝗧𝗢 𝗨𝗦𝗘
This section provides step-by-step guidance for interpreting the indicator's visual elements.
𝗦𝘁𝗲𝗽 𝟭: 𝗜𝗱𝗲𝗻𝘁𝗶𝗳𝘆 𝘁𝗵𝗲 𝗖𝘂𝗿𝗿𝗲𝗻𝘁 𝗥𝗲𝗴𝗶𝗺𝗲
Look at the regime table in the corner of the chart. The top row shows the current regime state: ACCUMULATION, DISTRIBUTION, or NEUTRAL. The color matches the regime (green, red, or gray).
• Volume bars tinted green suggest accumulation regime
• Volume bars tinted red suggest distribution regime
• Volume bars gray indicate neutral regime
The regime provides context for all other readings. Trading with the regime (buying during accumulation, selling during distribution) aligns with the detected flow direction.
𝗦𝘁𝗲𝗽 𝟮: 𝗔𝘀𝘀𝗲𝘀𝘀 𝗥𝗲𝗴𝗶𝗺𝗲 𝗛𝗲𝗮𝗹𝘁𝗵
The regime table displays multiple health indicators:
• Strength percentage: Higher values suggest stronger conviction
• Status: STRONG, FADING, WEAKENING, or CRITICAL
• Health: Composite warning indicator (HEALTHY, WATCH, CAUTION, DANGER)
• Structure: Whether price structure agrees with regime
• Market: Whether conditions are TRENDING, NORMAL, or CHOPPY
• Flip: Whether a regime change is building
When status shows FADING or worse, the regime may be losing conviction. Yellow-tinted volume bars appear after three consecutive bars of weakening status, providing early warning of potential regime changes.
𝗦𝘁𝗲𝗽 𝟯: 𝗪𝗮𝘁𝗰𝗵 𝗳𝗼𝗿 𝗦𝗶𝗴𝗻𝗮𝗹𝘀
Bullish signals appear as green labels with an up arrow above volume spikes during accumulation. Bearish signals appear as red labels with a down arrow during distribution. Labels include:
• Star ratings indicating quality (more stars suggest more confluence)
• Target emoji when five or more factors align
• HTF emoji when higher timeframe agrees
Hover over any signal label to see detailed tooltip information including quality percentage, risk levels, position sizing suggestions, and specific confluence factors present.
𝗦𝘁𝗲𝗽 𝟰: 𝗖𝗵𝗲𝗰𝗸 𝗛𝗧𝗙 𝗔𝗹𝗶𝗴𝗻𝗺𝗲𝗻𝘁 (𝗜𝗳 𝗘𝗻𝗮𝗯𝗹𝗲𝗱)
When multi-timeframe filtering is enabled, a second table appears showing HTF regime states. Green checkmarks indicate alignment, red X marks indicate disagreement. For maximum confluence, all timeframes should agree on regime direction.
𝗦𝘁𝗲𝗽 𝟱: 𝗠𝗼𝗻𝗶𝘁𝗼𝗿 𝗘𝘅𝗶𝘁 𝗪𝗮𝗿𝗻𝗶𝗻𝗴𝘀
Yellow warning labels appear when exit conditions trigger: regime flips, flow reversals, critical weakness, time-based exits, or target hits. These suggest reviewing open positions. The tooltip explains the specific exit reason.
𝗦𝘁𝗲𝗽 𝟲: 𝗖𝗼𝗺𝗯𝗶𝗻𝗲 𝗠𝘂𝗹𝘁𝗶𝗽𝗹𝗲 𝗙𝗮𝗰𝘁𝗼𝗿𝘀
The indicator provides the most context when multiple elements align:
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘈 (𝘛𝘳𝘦𝘯𝘥 𝘊𝘰𝘯𝘵𝘪𝘯𝘶𝘢𝘵𝘪𝘰𝘯): Regime shows ACCUMULATION at 72% strength with STRONG status. Structure displays checkmark (HH/HL confirmed). Market character shows TRENDING. A volume spike triggers a bullish signal with two stars and HTF alignment. Multiple factors agreeing during an established regime suggests trend may continue, though no outcome is guaranteed.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘉 (𝘔𝘰𝘮𝘦𝘯𝘵𝘶𝘮 𝘍𝘢𝘥𝘪𝘯𝘨): Regime shows DISTRIBUTION but status has shifted to FADING. Strength dropped from 65% to 48% over recent bars. Structure shows conflict (regime bearish but structure making higher lows). Volume bars have turned yellow. This type of internal disagreement often appears before regime changes or consolidation periods.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘊 (𝘌𝘹𝘩𝘢𝘶𝘴𝘵𝘪𝘰𝘯 𝘞𝘢𝘳𝘯𝘪𝘯𝘨): After an extended rally, regime shows ACCUMULATION but status reads CRITICAL. Health indicator shows CAUTION with two warnings active. An absorption bar appears (volume spike with small body and large upper wick). The Flip row shows regime change building. None of this guarantees reversal, but multiple warning signs appearing together suggest caution.
𝘌𝘹𝘢𝘮𝘱𝘭𝘦 𝘚𝘤𝘦𝘯𝘢𝘳𝘪𝘰 𝘋 (𝘉𝘳𝘦𝘢𝘬𝘰𝘶𝘵 𝘍𝘳𝘰𝘮 𝘊𝘰𝘯𝘴𝘰𝘭𝘪𝘥𝘢𝘵𝘪𝘰𝘯): Regime has shown NEUTRAL for several sessions with volume bars gray and muted. Market character displays CHOPPY. Then a volume spike triggers with regime flipping to ACCUMULATION, confirmed by structure shift to HH/HL. A three-star signal appears with target emoji. When multiple elements shift together after a quiet period, consolidation may be resolving into a directional move.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗡𝗔𝗩𝗜𝗚𝗔𝗧𝗜𝗡𝗚 𝗗𝗜𝗙𝗙𝗘𝗥𝗘𝗡𝗧 𝗠𝗔𝗥𝗞𝗘𝗧 𝗖𝗢𝗡𝗗𝗜𝗧𝗜𝗢𝗡𝗦
𝗧𝗿𝗲𝗻𝗱𝗶𝗻𝗴 𝗠𝗮𝗿𝗸𝗲𝘁𝘀
During sustained trends, the indicator typically shows persistent regime state (accumulation in uptrends, distribution in downtrends) with STRONG status and TRENDING market character. Structure should confirm with appropriate swing point patterns. Signals receive quality bonuses during trending conditions. Focus on signals that align with the established regime rather than counter-trend setups. The regime strength percentage and status provide ongoing confirmation that the trend remains healthy.
𝗥𝗮𝗻𝗴𝗶𝗻𝗴 𝗠𝗮𝗿𝗸𝗲𝘁𝘀
During consolidation, expect frequent regime shifts between accumulation, distribution, and neutral. Market character will display CHOPPY, and quality scores receive penalties. Structure may show mixed readings. Signal frequency increases but quality decreases. Consider using stricter filtering (higher volume threshold, HTF requirement) or waiting for regime stability before acting. The stability index in the regime table tracks flip frequency to help identify choppy conditions.
𝗛𝗶𝗴𝗵 𝗩𝗼𝗹𝗮𝘁𝗶𝗹𝗶𝘁𝘆 𝗘𝘃𝗲𝗻𝘁𝘀
During news events or volatility spikes, the auto-adapt feature adjusts thresholds based on ATR readings. Higher volatility raises the bar for regime changes, reducing whipsaws. Volume spikes during high volatility require greater statistical significance. The regime table tooltip shows current adaptive settings for transparency. Signals during extreme volatility should be interpreted with additional caution.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗧𝗘𝗖𝗛𝗡𝗜𝗖𝗔𝗟 𝗗𝗘𝗧𝗔𝗜𝗟𝗦
• Volume spike detection uses z-score normalization against a lookback window
• Regime scoring combines velocity, trend, flow, and volume components with configurable weights
• Regime changes require multi-bar confirmation above thresholds
• Structure detection uses pivot-based swing point identification
• Footprint classification analyzes body-to-range ratio and wick proportions
• Quality scoring aggregates multiple factors with caps and multipliers
• HTF data uses request.security with lookahead disabled (non-repainting)
• All signals fire on bar close only (non-repainting architecture)
• Parameters adapt automatically based on timeframe category
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗨𝗡𝗜𝗤𝗨𝗘 𝗙𝗘𝗔𝗧𝗨𝗥𝗘𝗦
• Timeframe Adaptive: All parameters (lookbacks, thresholds, confirmations) automatically scale based on whether the chart shows scalp, intraday, swing, or position timeframes.
• Multi-Layer Warning System: Four warning levels (STRONG, FADING, WEAKENING, CRITICAL) provide graduated alerts as regimes deteriorate, rather than binary flip signals.
• Structure-Regime Validation: Cross-references detected regime against actual price structure (swing highs/lows) to identify potential divergences.
• Volume Footprint Classification: Distinguishes between momentum-driven volume spikes and absorption patterns that may indicate different market participant behavior.
• Quality-Based Position Sizing: Suggested position sizes scale based on signal quality, with higher confluence signals receiving larger size recommendations.
• Non-Repainting Architecture: All calculations use confirmed bar data only. Historical display matches real-time behavior exactly.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗦𝗘𝗧𝗧𝗜𝗡𝗚𝗦 𝗢𝗩𝗘𝗥𝗩𝗜𝗘𝗪
• Detection: Volume spike threshold, signal cooldown, regime sensitivity mode, auto-adapt toggle, warning display toggle
• Risk: Account size, risk percentage, ATR length, stop/target multipliers, partial exit percentage, trailing stop and breakeven settings
• Multi-Timeframe: HTF enable toggles, timeframe selections, strict mode, minimum HTF strength threshold
• Strategy: Trading mode selection (Trend Following, Mean Reversion, or Hybrid), mean reversion threshold
• Display: Toggles for regime table, background colors, exit warnings, quality stars, management labels, tooltips, and HTF table
• Table Style: Layout orientation, table positions, text sizes, border and frame widths
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗔𝗟𝗘𝗥𝗧𝗦
25 alert conditions available:
• Bull Signal / Bear Signal / Any Signal: Core directional signals with quality and position details
• Target 1 Hit / Breakeven: Position management milestones
• Exit Warning: Triggered when exit conditions appear
• Regime to Accumulation / Distribution / Neutral: Individual regime change alerts
• Any Regime Change: Fires on any regime transition
• Regime Weakening: Early warning of deteriorating regime
• Momentum Fading / Flow Deteriorating / Volume Drying: Leading exit indicators
• Multiple Warnings: Fires when two or more warning conditions active
• HTF Aligned / HTF Broke: Multi-timeframe alignment changes
• Structure Bullish / Structure Bearish: Price structure shifts
• Structure Conflict: When structure disagrees with regime
• Momentum Footprint / Absorption Footprint: Volume footprint detection
• Market Trending / Market Choppy: Market character changes
• High Confluence Signal: Signals with five or more factors aligned
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗟𝗜𝗠𝗜𝗧𝗔𝗧𝗜𝗢𝗡𝗦
• Requires Volume Data: Instruments without reliable volume data (some forex pairs, indices) will produce unreliable readings.
• Analysis Tool, Not Signal Generator: This indicator identifies conditions that may warrant attention. It does not provide entry/exit instructions and should not be followed mechanically.
• Lagging Component: Regime detection requires confirmation bars, introducing necessary lag. Fast reversals may not be captured in time.
• No Guarantee of Outcomes: High quality scores and multiple confluence factors improve context but do not predict results. Markets can move against any setup.
• HTF Limitations: Higher timeframe data updates on HTF bar closes, not continuously. Brief alignment windows may be missed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗖𝗢𝗡𝗖𝗟𝗨𝗦𝗜𝗢𝗡
Volume Oracle provides a structured framework for analyzing volume flow through regime detection, structure validation, footprint classification, quality scoring, and multi-timeframe confluence. The indicator is designed to help traders identify accumulation and distribution phases and assess the conviction behind detected regimes. Multiple warning systems provide early indication when regimes may be losing strength.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔶 𝗗𝗜𝗦𝗖𝗟𝗔𝗜𝗠𝗘𝗥
Trading is risky and most traders lose money. This indicator is provided for informational and educational purposes only. It does not constitute financial advice, and past performance does not guarantee future results. All content, tools, and analysis should not be considered as recommendations to buy or sell any asset. Users are solely responsible for their own trading decisions. Always use proper risk management and consider consulting a qualified financial advisor before making trading decisions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Built with PineScript v6. Non-repainting. All signals confirmed on bar close.
Script sur invitation seulement
Seuls les utilisateurs approuvés par l'auteur peuvent accéder à ce script. Vous devrez demander et obtenir l'autorisation pour l'utiliser. Celle-ci est généralement accordée après paiement. Pour plus de détails, suivez les instructions de l'auteur ci-dessous ou contactez directement SignalPilotLabs.
TradingView ne recommande PAS d'acheter ou d'utiliser un script à moins que vous ne fassiez entièrement confiance à son auteur et que vous compreniez son fonctionnement. Vous pouvez également trouver des alternatives gratuites et open source dans nos scripts communautaires.
Instructions de l'auteur
Get instant access here: https://signalpilot.io
Signal Pilot — The edge isn't seeing more. It's seeing what matters. | docs.signalpilot.io | education.signalpilot.io | signalpilot.io/chronicle | support@signalpilot.io
Clause de non-responsabilité
Les informations et publications ne sont pas destinées à être, et ne constituent pas, des conseils ou recommandations financiers, d'investissement, de trading ou autres fournis ou approuvés par TradingView. Pour en savoir plus, consultez les Conditions d'utilisation.
Script sur invitation seulement
Seuls les utilisateurs approuvés par l'auteur peuvent accéder à ce script. Vous devrez demander et obtenir l'autorisation pour l'utiliser. Celle-ci est généralement accordée après paiement. Pour plus de détails, suivez les instructions de l'auteur ci-dessous ou contactez directement SignalPilotLabs.
TradingView ne recommande PAS d'acheter ou d'utiliser un script à moins que vous ne fassiez entièrement confiance à son auteur et que vous compreniez son fonctionnement. Vous pouvez également trouver des alternatives gratuites et open source dans nos scripts communautaires.
Instructions de l'auteur
Get instant access here: https://signalpilot.io
Signal Pilot — The edge isn't seeing more. It's seeing what matters. | docs.signalpilot.io | education.signalpilot.io | signalpilot.io/chronicle | support@signalpilot.io
Clause de non-responsabilité
Les informations et publications ne sont pas destinées à être, et ne constituent pas, des conseils ou recommandations financiers, d'investissement, de trading ou autres fournis ou approuvés par TradingView. Pour en savoir plus, consultez les Conditions d'utilisation.