Keltner Rings [Quantum Algo] — Indicator by Quantum-Algo — TradingView

═══════════════════════════════════════════════

🔶 OVERVIEW

Keltner Rings is a complete reading system built on Keltner Channels — volatility bands placed around an exponential moving average, with width set by the Average True Range. Three nested rings form a gradient volatility field around price, a regime classifier determines what kind of market you are actually in, and the dashboard translates it into plain instructions: when riding the upper band is strength, and when the very same touch is fade material.

That distinction is the heart of this tool. The most common way traders lose money with any channel indicator is applying range logic in a trend — shorting an upper-band touch while price is band-walking higher. Keltner Rings classifies the regime first, interprets every touch accordingly, generates three distinct signal families, and scores each family’s historical performance on your exact symbol and timeframe.

═══════════════════════════════════════════════

🔶 WHAT ARE KELTNER CHANNELS?

Keltner Channels are volatility-based bands around a moving average. The concept originates with Chester W. Keltner (1960); the modern formulation — an exponential moving average with bands offset by multiples of the Average True Range — was popularized by Linda Bradford Raschke. Because the Average True Range expands and contracts with real movement, the channel breathes with the market: wide in storms, tight in calm.

This tool extends the classic single channel into three rings — inner, middle and outer — creating a graded map of how far price has traveled from its average in volatility-adjusted terms.

═══════════════════════════════════════════════

🔶 WHAT IS A BAND WALK?

In a genuine trend, price does not oscillate politely around its average — it presses against the channel and rides it, closing beyond the inner ring bar after bar. This is the band walk, and it is the single most misread behavior in channel trading: it looks overbought, and it is actually strength. Keltner Rings detects the walk explicitly (a configurable count of consecutive closes beyond the inner ring), paints the walking bars in full trend color, and marks the walk’s beginning as a continuation signal rather than a fade.

═══════════════════════════════════════════════

🔶 WHY IS THIS ORIGINAL?

1. Regime-aware interpretation. The classifier combines average slope, band-walk state, squeeze condition and the channel’s own width percentile into four regimes — Trend Up, Trend Down, Range, Squeeze — and the dashboard’s “How To Read It” row states, live, how touches should be interpreted right now. The tool teaches its own correct usage.

2. Three signal families, separated on purpose. W marks the start of a band walk with the trend (continuation). R marks a middle-ring rejection in a range regime only (reversion, exactly where reversion belongs). S marks a squeeze release through the inner ring (expansion). One tool, three behaviors, never confused with each other.

3. Per-family statistics on your chart. Every family’s ten-bar outcomes are tracked in first-in-first-out samples, shrunk toward neutral at small sizes, with Wilson lower bounds. Each signal’s tooltip quotes its own family record on the current symbol at the moment it prints — and the dashboard shows all three records side by side.

4. The width cone. Channel width is ranked as a percentile inside its own recent history, so “tight” and “wide” are defined by this symbol’s behavior, never by fixed numbers.

5. The squeeze, credited and integrated. Bollinger Bands closing inside the Keltner ring — the compression concept popularized by John F. Carter — is detected with duration tracking, gold coil markers on the average, and directional release signals.

═══════════════════════════════════════════════

🔶 HOW IT WORKS

— The exponential average and Average True Range build three rings at configurable widths; five gradient fills render the volatility field between them.
— Average slope, walk counters, squeeze state and width percentile feed the regime classifier every bar.
— Signals: W fires when the walk count is reached with the trend; R fires on middle-ring rejections in range regimes; S fires when a mature squeeze releases through the inner ring.
— Each family’s outcomes feed its own statistics; the dashboard and tooltips report them with sample counts.

All signals are evaluated on confirmed bars and do not repaint. All drawings are capped for performance.

═══════════════════════════════════════════════

🔶 HOW TO USE IT

— Read the regime row first, then the guidance row — they tell you which of the three signal families is currently in its natural habitat.
— In trends: treat inner-ring pullbacks as entries in the trend direction, and let the painted band walk carry the position; the walk ending is your first warning.
— In ranges: middle-ring touches with rejection candles target the average — the R family’s record shows how this symbol has respected that logic.
— In squeezes: the coil duration and width percentile tell you how compressed the spring is; the S release gives the direction, and the family record tells you how trustworthy releases have been here.
— Works on all markets and timeframes; every threshold is volatility-adjusted or percentile-based, so nothing needs retuning per symbol.

═══════════════════════════════════════════════

🔶 SETTINGS

— Keltner Channels: exponential average length, Average True Range length, three ring widths.
— Regime & Signals: trend slope threshold, band-walk bar count, width history window, cooldown, squeeze ring width.
— Statistics: sample cap, minimum samples, shrinkage strength, Wilson z-score.
— Visuals and dashboard: full color control, band-walk painting toggle, position and text size.

═══════════════════════════════════════════════

🔶 ALERTS

— Squeeze Started — compression began.
— Squeeze Release Up / Down — compression resolved through the inner ring.
— Band Walk Started — consecutive closes locked beyond the inner ring with the trend.
— Reversion Signal — middle-ring rejection in a range regime.

═══════════════════════════════════════════════

🔶 FAQ

Q: How is this different from standard Keltner Channels?
A: The standard indicator draws one channel and leaves interpretation to you — including the fatal ambiguity of what an upper-band touch means. This tool adds the regime classifier, the three-ring field, the band-walk engine, explicit signal families for continuation, reversion and expansion, and per-family statistics, so every touch arrives with its context and its track record.

Q: Does it repaint?
A: No. All signals are evaluated on confirmed closes; a printed signal never changes.

Q: Keltner Channels or Bollinger Bands?
A: They answer different questions. Bollinger Bands use standard deviation and react sharply to close-to-close variance; Keltner Channels use the Average True Range and breathe more smoothly with the full bar range. This tool uses both — the channel as the structure, and the Bollinger relationship as the squeeze detector.

Q: What do the family percentages mean?
A: The share of past signals in that family after which price had moved favorably ten bars later, on the current symbol and timeframe, shrunk toward fifty percent at small samples. They describe history — they are not predictions.

Q: Which settings matter most?
A: Band Walk Bars (higher = stricter walks, fewer W signals) and the ring widths — the defaults of one, two and three Average True Ranges follow common practice and suit most markets.

═══════════════════════════════════════════════

🔶 CREDITS

The original channel concept is by Chester W. Keltner (1960); the modern exponential-average and Average True Range formulation was popularized by Linda Bradford Raschke. The Average True Range is by J. Welles Wilder Jr. (1978). Bollinger Bands are by John Bollinger, and the band-compression squeeze concept was popularized by John F. Carter. The Wilson score interval is by Edwin B. Wilson (1927). The regime classifier, three-ring field, band-walk engine, signal families, per-symbol statistics and all code in this script are original work — no third-party or open-source script code was reused.

═══════════════════════════════════════════════

🔶 LIMITATIONS

— Regime classification is descriptive, not predictive: regimes are identified as they form, and transitions are only visible once underway.
— Reversion logic is disabled by design outside range regimes; traders who want to fade trends will not find those signals here.
— Statistics describe the current chart’s history only; past frequencies never guarantee future outcomes.

═══════════════════════════════════════════════

🔶 DISCLAIMER

This indicator is a research and charting tool provided for educational purposes. It is not financial advice, and nothing it displays is a recommendation to buy or sell any asset. Trading involves substantial risk of loss. Always do your own analysis and manage risk responsibly.