Multi-Metric Market Regime Detector - [KK]This indicator identifies current market behavioral regimes by synthesizing six complementary analytical methodologies. Rather than generating trading signals, it provides contextual analysis to help traders understand market conditions and adapt their strategies accordingly.
Markets cycle through distinct behavioral states - trending efficiently, consolidating in ranges, compressing before breakouts, or transitioning between states. This tool quantifies these conditions using only price action data (OHLC), enabling traders to filter strategies based on current market structure.
Core Methodology
The indicator combines six independent metrics into a weighted composite classification system:
Efficiency Ratio (30% weight)
Measures the signal-to-noise ratio of price movement by comparing net price displacement to total path traveled. High efficiency indicates clean directional movement; low efficiency indicates choppy, noisy conditions.
Choppiness Index (25% weight)
Quantifies whether the market is trending or consolidating by comparing cumulative True Range to actual price range. Values below 38.2 suggest trending behavior; values above 61.8 suggest range-bound consolidation.
Volatility Analysis (20% weight)
Detects compression and expansion cycles using the relationship between Bollinger Bands and Keltner Channels. Compression phases (squeeze conditions) often precede significant directional moves.
Fractal Efficiency Proxy (10% weight)
Analyzes path complexity by comparing net displacement to cumulative range, providing insight into the smoothness versus randomness of price action.
Market Structure (15% weight)
Examines pivot point sequences to identify structural trends. Higher Highs and Higher Lows indicate bullish structure; Lower Lows and Lower Highs indicate bearish structure.
Wick-to-Body Ratio Analysis (qualitative)
Identifies rejection and indecision patterns by measuring the proportion of candle wicks to bodies, highlighting potential reversal zones or liquidity events.
Regime Classifications
The composite scoring system produces four distinct regime states:
TRENDING : High efficiency, low choppiness, clear directional structure. Favorable conditions for momentum and trend-following strategies.
CHOPPY/RANGE : Low efficiency, high choppiness, mean-reverting behavior. Favorable conditions for range trading and counter-trend setups.
COMPRESSION : Volatility squeeze detected, market coiling. Anticipate expansion; reduce position size until breakout confirmation.
TRANSITION : Mixed signals, conflicting metrics, unclear direction. Recommended to reduce exposure and wait for regime clarity.
Visual Features
Regime-Colored Candles (enabled by default)
Candles are colored according to the current regime state for immediate visual identification. Green indicates trending, gray indicates choppy, orange indicates compression, and yellow indicates transition.
Comprehensive Metrics Table (top right)
Displays real-time values for all six metrics along with individual regime assessments and the final composite classification with score.
Regime Guide Table (middle right)
Quick reference guide showing recommended strategies and actions to avoid for each regime state.
Chart Label ( optional)
Summary label displaying current regime and key metric values.
Background Coloring (optional)
Alternative visualization using background colors instead of candle coloring.
Indicator Plots (optional)
Displays Efficiency Ratio and Choppiness Index with threshold reference lines.
Customization Options
All calculation parameters are adjustable:
- Efficiency Ratio lookback period and thresholds
- Choppiness Index length and classification thresholds
- Volatility analysis parameters (BB/KC multipliers and lengths)
- Pivot detection sensitivity (left/right bars)
- Text size controls for both tables (Tiny to Huge)
- Visual element toggles (candles, background, label, tables, plots)
The indicator automatically detects chart theme (dark/light) and adjusts text colors for optimal readability.
Practical Application
This is a context tool, not a signal generator. Use it to:
- Filter trend-following strategies to trending regimes only
- Identify range-bound conditions for mean-reversion setups
- Anticipate breakout opportunities during compression phases
- Reduce exposure during transitional periods with mixed signals
- Improve risk management by matching position size to regime clarity
The indicator works on all timeframes and instruments using only OHLC data. Higher timeframes generally provide more stable regime classifications.
Alert Conditions
Four alert types are available:
- Efficiency Ratio crosses trend threshold
- Choppiness Index enters range territory
- Volatility squeeze released
- Regime state change detected
Technical Notes
Built with Pine Script v5. Uses up to 500 bars of historical data for stable calculations. All metrics are calculated in real-time with no repainting on confirmed pivots. Compatible with all chart themes through adaptive text coloring.
Disclaimer
This indicator is provided for educational and informational purposes only. It does not constitute financial advice or trading recommendations. Past performance and theoretical analysis do not guarantee future results. Always conduct independent research and implement appropriate risk management. Trading financial instruments involves substantial risk of loss.
Usage Philosophy
The goal is not to trade more frequently, but to think more clearly about market conditions. Use this tool to develop deeper intuition about market structure and to enforce discipline by avoiding low-probability setups during unfavorable regime conditions.
אינדיקטור Pine Script®






















