Yang-zhang

Volatility Drag Oscillator Volatility Drag Oscillator — what is holding exposure costing you, and what does leverage do to it? Compound growth is g = μ − σ²/2; under leverage, g(L) = L·μ − L²·σ²/2. Return scales with L, drag scales with L² — which is the whole reason leverage does not raise your probability of success. Volatility is estimable in hundreds of bars; drift needs decades. So this tool measures only the knowable half: - DRAG = σ²/2 annualised (Yang-Zhang by default; Close-to-close / Parkinson / Garman-Klass / Rogers-Satchell selectable to see estimator disagreement = gap-risk information), EWMA-smoothed and ranked into a percentile so you know if today is a cheap or expensive time to hold. - DRAG DECOMPOSITION — realised drag split into its exact cumulant pieces: variance (σ²/2) + skew + excess-kurtosis, shown as "σ² · skw · tail" in %/yr. A fat-tail warning tells you HOW MUCH of your drag is tails, not just that they exist — and it compares realised drag to its own Gaussian part, so it can't be fooled by estimator choice. - LEVERAGE CURVE — drag at 1×/2×/3×, plus break-even L_be = 2μ/σ² and Kelly = μ/σ², shown ONLY as conditionals on an edge YOU enter. The script never estimates drift, and says why. READ IT how you like: a familiar 0-100 percentile OSCILLATOR in the pane (cheap<20, expensive>80, midline 50, like an RSI of holding-cost), or the absolute drag %/yr line. On price, a heat-RIBBON and green/red regime triangles show cheap→expensive to hold — VOLATILITY regime, direction-agnostic. A red marker means "expensive, size down", never "go short". No directional claim and no backtest — there is nothing here to fit. Descriptive risk context, not advice. Leverage magnifies losses; this shows one cost of it, not all risks.

Indicator

by Market_Logic_India

[GYTS-CE] Kinetic Trend Envelope (adaptive trailing stop)Kinetic Trend Envelope (Community Edition) 🌸 Part of GoemonYae Trading System (GYTS) 🌸 🌸 --------- INTRODUCTION --------- 🌸 💮 What is the Kinetic Trend Envelope? The Kinetic Trend Envelope (KTE) is an adaptive directional trailing stop in the lineage of SuperTrend, rebuilt around the premise that volatility is kinetic energy . It measures per-bar motion with five academically grounded volatility estimators, then widens the envelope as energy rises and contracts it as motion settles. In an uptrend, the lower band ratchets higher and never retreats; in a downtrend, the upper band ratchets lower. The direction changes when the active stop is breached, after which the opposite side becomes the new trailing stop. 💮 Why Use This Indicator? Conventional trailing stops typically combine a price anchor with one symmetric ATR-derived width. The KTE extends that model with: Asymmetric volatility profiling — Bullish- and bearish-candle volatility shape the upper and lower bands independently. Three direction-switch methods — High/low, close, or a smoothed estimator controls flip sensitivity without moving the band anchor. Five volatility estimators — ATR plus Parkinson, Garman-Klass, Rogers-Satchell, and Yang-Zhang covers different treatments of gaps, drift, and intrabar range. The outputs are calibrated to a common width basis, so Volatility Factor remains interpretable across estimators and price scales. Fine adjustment may still be useful, but switching estimators should not require re-tuning by orders of magnitude. ↑ The KTE on a trending instrument. The thick line is the active trailing stop; the thin line shows the opposing side of the envelope. Both expand and contract with market energy. ↑ KTE beside PulseWire's built-in SuperTrend, both using ATR with a 10-bar lookback. KTE's asymmetric profile changes how each side responds to directional volatility while the monotonic active band avoids premature loosening. 🌸 --------- HOW IT WORKS --------- 🌸 💮 Core Concept The bands share a smoothed price estimator as their anchor, but use separate volatility profiles: Upper band = estimator + (factor × bullish-candle volatility) Lower band = estimator − (factor × bearish-candle volatility) In a bullish state, the lower band is active and can only rise. In a bearish state, the upper band is active and can only fall. This monotonic constraint prevents a live trailing stop from loosening within the trend. The selected direction-switch method changes only the breach test. It does not change the smoothed estimator anchoring the envelope, so a wick-sensitive trigger cannot drag the bands around with the wick. 💮 The Five Volatility Estimators Each estimator reads a different part of the OHLC bar: ATR (Wilder, 1978) — Familiar baseline that handles gaps through true range. Parkinson (1980) — Uses high-low range; efficient under continuous, low-drift conditions. Garman-Klass (1980) — Adds open-close information; favours continuous sessions without material gaps. Rogers-Satchell (1991) — Drift-independent and well suited to trending, continuously traded instruments. Yang-Zhang (2000) — Combines overnight gaps, open-close movement, and Rogers-Satchell; the gap-aware default. Statistical efficiency does not guarantee a visibly tighter stop. At slow Adaptation Speed settings, long averaging makes the estimators look similar; at fast settings, their different treatments of gaps, drift, and range become more visible. Choose according to the instrument's behaviour rather than expecting one estimator always to produce the narrowest band. ↑ ATR and Yang-Zhang at Adaptation Speed 2. The long profile memory (low speed) smooths away most of the difference, so the two envelopes nearly overlap. ↑ ATR and Yang-Zhang at Adaptation Speed 8. The short profile memory (high speed) exposes their different volatility readings, producing visibly distinct envelope widths. 💮 Asymmetric Volatility Profiling and Adaptation Speed The KTE stores volatility from bullish and bearish candles separately. Bullish samples determine the upper width; bearish samples determine the lower width. This allows the two sides to respond differently when upward and downward motion carry different energy. Adaptation Speed controls the memory of this profile, not the speed of the price estimator and not the distance of the stop by itself. Its 1–10 scale maps logarithmically to an internal window: Speed 3 — approximately 878 bars: stable and slow to re-weight Default 3.5 — approximately 570 bars: general-purpose smoothing Speed 8 — approximately 11 bars: highly responsive to recent volatility Speed 10 — approximately 2 bars: extremely reactive and noisy Faster does not necessarily mean closer to price. During a volatility burst, a fast profile recognises the expansion sooner and may widen the band sharply. Because the active stop cannot loosen, it can then remain flat until the estimator catches up. A slow profile dilutes the same burst across much more history, so its narrower band may appear to follow price faster. This is why two instances matched during a calm period can separate during a shock, especially when they also use different Volatility Factor values. Compare Adaptation Speed with the same factor first; matching lines in one regime does not make two configurations equivalent elsewhere. The profiles are also direction-conditioned: bullish samples are replaced by later bullish candles and bearish samples by later bearish candles. A recent high-volatility sample can therefore persist through a run of opposite-colour candles, producing deliberate step-like plateaux in the relevant band. ↑ Asymmetric profiling in action: the upper and lower widths respond independently to bullish- and bearish-candle volatility. 💮 Direction Switch Methods The breach source sets the balance between responsiveness and false flips: On high/low — Uses the current bar's wick and can switch on the breach bar. Fastest and most sensitive to noise. On close — Uses the previous confirmed close; the switch appears on the following bar. On estimator — Uses the previous smoothed estimator; the most conservative default, also switching on the following bar. ↑ The three switch methods share the same band geometry but change direction at different times. 🌸 --------- KEY FEATURES --------- 🌸 💮 Eight Estimator Filters The configurable price anchor includes: Ultimate Smoother, 2- or 3-pole — Low-noise, near-zero-lag passband response; the 2-pole version is the default. Super Smoother, 2- or 3-pole — Ehlers low-pass filters for progressively stronger smoothing. BiQuad — Second-order low-pass filter with an adjustable Q-factor. ADXvma — Adapts to trend strength and tends to flatten in ranges. MAMA — Cycle-adaptive MESA moving average. A2RMA — Adaptive recursive moving average with adjustable gamma. They are provided by the open-source FiltersToolkit library. 💮 Visual Layering The display separates function from context: Active band — Thick directional trailing-stop line Opposing band — Thin reference for the inactive side Channel fill — Visual separation between the estimator and each band Estimator — Optional smoothed anchor Palette, light/dark mode, widths, and transparencies can be adjusted independently. 🌸 --------- USAGE GUIDE --------- 🌸 💮 Getting Started Start with the defaults, observe several calm and volatile regimes, and change one dimension at a time: Tune Volatility Factor for the preferred stop distance. Tune Adaptation Speed for how quickly width should respond to regime changes. Choose the direction-switch method for the preferred confirmation level. Change the volatility estimator only when its assumptions better fit the instrument. 💮 Choosing a Volatility Estimator Gapped equities — Yang-Zhang accounts for overnight movement. Trending 24/7 markets — Rogers-Satchell is drift-independent without a separate gap component. Continuous, range-led markets — Parkinson or Garman-Klass offers efficient range-based measurement under their assumptions. Familiar baseline — ATR provides conventional true-range behaviour. On continuous instruments, Rogers-Satchell and Yang-Zhang may look very similar because there are few gaps to distinguish them. Use the Volatility Toolkit to compare their raw behaviour on the intended instrument. ↑ Three estimators compared on one instrument, each reading a different combination of OHLC information. 💮 Tuning Width and Responsiveness These controls solve different problems: Volatility Factor — Sets the distance per unit of measured volatility. Adaptation Speed — Sets the memory of the bullish/bearish profile; faster can widen the stop sooner during shocks. Volatility Lookback — Sets how quickly the underlying per-bar volatility estimate changes. Estimator Lookback — Sets the smoothness of the price anchor. Use symptoms to guide adjustment: Frequent flips on minor pullbacks — Increase Volatility Factor or use a more conservative switch method (e.g. "on estimator"). Excessive give-back — Decrease Volatility Factor or use a more responsive switch method (e.g. "on high/low"). Width reacts too slowly to regime changes — Increase Adaptation Speed or reduce Volatility Lookback. Bands become erratic during shocks — Reduce Adaptation Speed or increase Volatility Lookback. ↑ A tight factor follows price more closely and flips more often; a loose factor tolerates larger pullbacks. 💮 Trading Applications Discretionary trailing stop — Move a protective stop with the active band as it tightens. Trend confirmation — Accept long signals only during a bullish KTE state, and short signals only while bearish. Exit timing — Treat a direction change as an exit when the trade thesis is trend-following. 💮 Integration with GYTS Suite The visible bands and estimator can be selected as sources by compatible Pine scripts. Two packed streams are also exposed: 🔗 STREAM KTE 🪜 Trailing Stoploss — Positive lower-band value in a bullish state; negative upper-band value in a bearish state. 🔗 STREAM KTE 🪜 Mechanism — Encodes the switch method and scale-invariant estimator relationship for compatible consumers. The KTE is, first and foremost, a trailing stop, and these streams are built for stop management. The Order Orchestrator strategy consumes the Trailing Stoploss and Mechanism streams together : the first supplies the active stop level and its direction, the second makes the strategy's trailing-exit runner follow whatever switch method and estimator you set here. So the stop is configured once, in the KTE. Beyond that primary role, the signed trailing-stop stream can also serve as a trend signal, since its sign flips with direction: it can be read through sign and magnitude as an entry/exit signal, including by Flux Composer . The KTE can also be paired with Market Regime Detector so flips are acted on only when the broader regime supports trend-following behaviour. 🌸 --------- LIMITATIONS --------- 🌸 Trailing-stop latency — Every trailing stop gives back some of the move between the trend extreme and the eventual breach. Whipsaws in ranges — Low-energy chop can produce repeated flips; a regime filter may help when ranging conditions dominate. Fast adaptation can widen the stop — Higher Adaptation Speed means faster volatility response, not guaranteed proximity to price. Direction-conditioned memory — A bullish or bearish outlier remains in its own profile until enough matching-direction samples replace it, which can create plateaux after shocks. Warm-up and sample size — Long profile windows need sufficient chart history; strongly one-sided markets may leave one side with few recent samples. 🌸 --------- CREDITS --------- 🌸 💮 Academic Sources Wilder, J. W. (1978). New Concepts in Technical Trading Systems . Trend Research. Parkinson, M. (1980). The Extreme Value Method for Estimating the Variance of the Rate of Return. Journal of Business, 53 (1), 61–65. DOI Garman, M. B., & Klass, M. J. (1980). On the Estimation of Security Price Volatilities from Historical Data. Journal of Business, 53 (1), 67–78. DOI Rogers, L. C. G., & Satchell, S. E. (1991). Estimating Variance from High, Low and Closing Prices. Annals of Applied Probability, 1 (4), 504–512. DOI Yang, D., & Zhang, Q. (2000). Drift-Independent Volatility Estimation Based on High, Low, Open, and Close Prices. Journal of Business, 73 (3), 477–491. DOI Ehlers, J. F. (2024). The Ultimate Smoother. Technical Analysis of Stocks & Commodities , 2024-04. TASC Ehlers, J. F. (2004). Cybernetic Analysis for Stocks and Futures . Wiley. Covers SuperSmoother, MAMA and more. 💮 Inspiration Thanks to Trendoscope for inspiring us with the Supertrend - Ladder ATR (2021). It derives long-side stop distance from bearish-candle ATR and short-side distance from bullish-candle ATR, which is one of the mechanisms that we tried to develop further with the KTE. 💮 Libraries Used FiltersToolkit — Ultimate Smoother, Super Smoother, BiQuad, ADXvma, MAMA, and A2RMA VolatilityToolkit — Parkinson, Garman-Klass, Rogers-Satchell, and Yang-Zhang estimators MathTransform — Logarithmic scaling for Adaptation Speed ColourUtilities — Palette management and light/dark-mode colour adjustment

Indicator

by GoemonYae

Library

by ata_sabanci

[GYTS] Volatility Toolkit Volatility Toolkit 🌸 Part of GoemonYae Trading System (GYTS) 🌸 🌸 --------- INTRODUCTION --------- 🌸 💮 What is Volatility Toolkit? Volatility Toolkit is a comprehensive volatility analysis indicator featuring academically-grounded range-based estimators. Unlike simplistic measures like ATR, these estimators extract maximum information from OHLC data — resulting in estimates that are 5-14× more statistically efficient than traditional close-to-close methods. The indicator provides two configurable estimator slots, weighted aggregation, adaptive threshold detection, and regime identification — all with flexible smoothing options via GYTS FiltersToolkit integration. 💮 Why Use This Indicator? Standard volatility measures (like simple standard deviation) are highly inefficient, requiring large amounts of data to produce stable estimates. Academic research has shown that range-based estimators extract far more information from the same price data: • Statistical Efficiency — Yang-Zhang achieves up to 14× the efficiency of close-to-close variance, meaning you can achieve the same estimation accuracy with far fewer bars • Drift Independence — Rogers-Satchell and Yang-Zhang correctly isolate variance even in strongly trending markets where simpler estimators become biased • Gap Handling — Yang-Zhang properly accounts for overnight gaps, critical for equity markets • Regime Detection — Built-in threshold modes identify when volatility enters elevated or suppressed states ↑ Overview showing Yang-Zhang volatility with dynamic threshold bands and regime background colouring 🌸 --------- HOW IT WORKS --------- 🌸 💮 Core Concept The toolkit groups volatility estimators by their output scale to ensure valid comparisons and aggregations: • Log-Return Scale (σ) — Close-to-Close, Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang. These are comparable and can be aggregated. Annualisable via √(periods_per_year) scaling. • Price Unit Scale ($) — ATR. Measures volatility in absolute price terms, directly usable for stop-loss placement. • Percentage Scale (%) — Chaikin Volatility. Measures the rate of change of the trading range — whether volatility is expanding or contracting. Only estimators with the same scale can be meaningfully compared or aggregated. The indicator enforces this and warns when mixing incompatible scales. 💮 Range-Based Estimator Overview Range-based estimators utilise High, Low, Open, and Close prices to extract significantly more information about the underlying diffusion process than close-only methods: • Parkinson (1980) — Uses High-Low range. ~5× more efficient than close-to-close. Assumes zero drift. • Garman-Klass (1980) — Incorporates Open and Close. ~7.4× more efficient. Assumes zero drift, no gaps. • Rogers-Satchell (1991) — Drift-independent. Superior in trending markets where Parkinson/GK become biased. • Yang-Zhang (2000) — Composite estimator handling both drift and overnight gaps. Up to 14× more efficient. 💮 Theoretical Background • Parkinson, M. (1980). The Extreme Value Method for Estimating the Variance of the Rate of Return. Journal of Business, 53 (1), 61–65. DOI • Garman, M.B. & Klass, M.J. (1980). On the Estimation of Security Price Volatilities from Historical Data. Journal of Business, 53 (1), 67–78. DOI • Rogers, L.C.G. & Satchell, S.E. (1991). Estimating Variance from High, Low and Closing Prices. Annals of Applied Probability, 1 (4), 504–512. DOI • Yang, D. & Zhang, Q. (2000). Drift-Independent Volatility Estimation Based on High, Low, Open, and Close Prices. Journal of Business, 73 (3), 477–491. DOI 🌸 --------- KEY FEATURES --------- 🌸 💮 Feature Reference Estimators (8 options across 3 scale groups): • Close-to-Close — Classical benchmark using closing prices only. Least efficient but useful as baseline. Log-return scale. • Parkinson — Range-based (High-Low), ~5× more efficient than close-to-close. Assumes zero drift. Log-return scale. • Garman-Klass — OHLC-optimised, ~7.4× more efficient. Assumes zero drift, no gaps. Log-return scale. • Rogers-Satchell — Drift-independent, handles trending markets where Parkinson/GK become biased. Log-return scale. • Yang-Zhang — Gap-aware composite, most comprehensive (up to 14× efficient). Uses internal rolling variance (unsmoothed). Log-return scale. • Std Dev — Standard deviation of log returns. Log-return scale. • ATR — Average True Range in absolute price units. Useful for stop-loss placement. Price unit scale. • Chaikin — Rate of change of range. Measures volatility expansion/contraction, not level. Percentage scale. Smoothing Filters (10 options via FiltersToolkit): • SMA / EMA — Classical moving averages • Super Smoother (2-Pole / 3-Pole) — Ehlers IIR filter with excellent noise reduction • Ultimate Smoother (2-Pole / 3-Pole) — Near-zero lag in passband • BiQuad — Second-order IIR with configurable Q factor • ADXvma — Adaptive smoothing, flat during ranging periods • MAMA — MESA Adaptive Moving Average (cycle-adaptive) • A2RMA — Adaptive Autonomous Recursive MA Threshold Modes: • Static — Fixed threshold values you define (e.g., 0.025 annualised) • Dynamic — Adaptive bands: baseline ± (standard deviation × multiplier) • Percentile — Threshold at Nth percentile of recent history (e.g., 80th percentile for high) Visual Features: • Level-based colour gradient — Line colour shifts with percentile rank (warm = high vol, cool = low vol) • Fill to zero — Gradient fill intensity proportional to volatility level • Threshold fills — Intensity-scaled fills when thresholds are breached • Regime background — Chart background indicates HIGH/NORMAL/LOW volatility state • Legend table — Displays estimator names, parameters, current values with percentile ranks (P##) 💮 Dual Estimator Slots Compare two volatility estimators side-by-side. Each slot independently configures: • Estimator type (8 options across three scale groups) • Lookback period and smoothing filter • Colour palette and visual style This enables direct comparison between estimators (e.g., Yang-Zhang vs Rogers-Satchell) or between different parameterisations of the same estimator. ↑ Yang-Zhang (reddish) and Rogers-Satchell (greenish) 💮 Flexible Smoothing via FiltersToolkit All estimators (except Yang-Zhang, which uses internal rolling variance) support configurable smoothing through 10 filter types. Using Infinite Impulse Response (IIR) filters instead of SMA avoids the "drop-off artefact" where volatility readings crash when old spikes exit the window. Example: Same estimator (Parkinson) with different smoothing filters Add two instances of Volatility Toolkit to your chart: • Instance 1: Parkinson with SMA smoothing (lookback 14) • Instance 2: Parkinson with Super Smoother 2-Pole (lookback 14) Notice how SMA creates sharp drops when volatile bars exit the window, while Super Smoother maintains a gradual transition. ↑ Two Parkinson estimators — SMA (red mono-colour, showing drop-off artefacts) vs Super Smoother (turquoise mono colour, with smooth transitions) ↑ Garman-Klass with BiQuad (orangy) and 2-pole SuperSmoother filters (greenish) 💮 Weighted Aggregation Combine multiple estimators into a single weighted average. The indicator automatically: • Validates scale compatibility (only same-scale estimators can be aggregated) • Normalises weights (so 2:1 means 67%:33%) • Displays clear warnings when scales differ Example: Robust volatility estimate Combine Yang-Zhang (handles gaps) with Rogers-Satchell (handles drift) using equal weights: • E1: Yang-Zhang (14) • E2: Rogers-Satchell (14) • Aggregation: Enabled, weights 1:1 The aggregated line (with "fill to zero" enabled) provides a more robust estimate by averaging two complementary methodologies. ↑ Yang-Zhang + Rogers-Satchell with aggregation line (thicker) showing combined estimate (notice how opening gaps are handled differently) Example: Trend-weighted aggregation In strongly trending markets, weight Rogers-Satchell more heavily since it's drift-independent: • Estimator 1: Garman-Klass (faster, higher weight in ranging) • Estimator 2: Rogers-Satchell (drift-independent, higher weight in trends) • Aggregation: weights 1:2 (favours RS during trends) 💮 Adaptive Threshold Detection Three threshold modes for identifying volatility regime shifts. Threshold breaches are visualised with intensity-scaled fills that grow stronger the further volatility exceeds the threshold. Example: Dynamic thresholds for regime detection Configure dynamic thresholds to automatically adapt to market conditions: • High Threshold Mode: Dynamic (baseline + 2× std dev) • Low Threshold Mode: Dynamic (baseline - 2× std dev) • Show threshold fills: Enabled This creates adaptive bands that widen during volatile periods and narrow during calm periods. Example: Percentile-based thresholds Use percentile mode for context-aware regime detection: • High Threshold Mode: Percentile (96th) • Low Threshold Mode: Percentile (4th) • Percentile Lookback: 500 This identifies when volatility enters the top/bottom 4% of its recent distribution. ↑ Different threshold settings, where the dynamic and percentile methods show adaptive bands that widen during volatile periods, with fill intensity varying by breach magnitude. Regime detection (see next) is enabled too. 💮 Regime Background Colouring Optional background colouring indicates the current volatility regime: • High Volatility — Warm/alert background colour • Normal — No background (neutral) • Low Volatility — Cool/calm background colour Select which source (Estimator 1, Estimator 2, or Aggregation) drives the regime display. Example: Regime filtering for trade decisions Use regime background to filter trading signals from other indicators: • Regime Source: Aggregation • Background Transparency: 90 (subtle) When the background shows HIGH volatility (warm), consider tighter stops. When LOW (cool), watch for breakout setups. ↑ Regime background emphasis for breakout strategies. Note the interesting A2RMA smoothing for this case. 🌸 --------- USAGE GUIDE --------- 🌸 💮 Getting Started 1. Add the indicator to your chart 2. Estimator 1 defaults to Yang-Zhang (14) — the most comprehensive estimator for gapped markets 3. Keep "Annualise Volatility" enabled to express values in standard annualised form 4. Observe the legend table for current values and percentile ranks (P##). Hover over the table cells to see a little more info in the tooltip. 💮 Choosing an Estimator • Trending equities with gaps — Yang-Zhang. Handles both drift and overnight gaps optimally. • Crypto (24/7 trading) — Rogers-Satchell. Drift-independent without Yang-Zhang's multi-period lag. • Ranging markets — Garman-Klass or Parkinson. Simpler, no drift adjustment needed. • Price-based stops — ATR. Output in price units, directly usable for stop distances. • Regime detection — Combine any estimator with threshold modes enabled. 💮 Interpreting Output • Value (P##) — The volatility reading with percentile rank. "0.1523 (P75)" means 0.1523 annualised volatility at the 75th percentile of recent history. • Colour gradient — Warmer colours = higher percentile (elevated volatility), cooler colours = lower percentile. • Threshold fills — Intensity indicates how far beyond the threshold the current reading is. • ⚠️ HIGH / 🔻 LOW — Table indicators when thresholds are breached. 🌸 --------- ALERTS --------- 🌸 💮 Direction Change Alerts • Estimator 1/2 direction change — Triggers when volatility inflects (rising to falling or vice versa) 💮 Cross Alerts • E1 crossed E2 — Triggers when the two estimator lines cross 💮 Threshold Alerts • E1/E2/Aggr High Volatility — Triggers when volatility breaches the high threshold • E1/E2/Aggr Low Volatility — Triggers when volatility falls below the low threshold 💮 Regime Change Alerts • E1/E2/Aggr Regime Change — Triggers when the volatility regime transitions (High ↔ Normal ↔ Low) 🌸 --------- LIMITATIONS --------- 🌸 • Drift bias in Parkinson/GK — These estimators overestimate variance in trending conditions. Switch to Rogers-Satchell or Yang-Zhang for trending markets. • Yang-Zhang minimum lookback — Requires at least 2 bars (enforced internally). Cannot produce instantaneous readings like other estimators. • Flat candles — Single-tick bars produce near-zero variance readings. Use higher timeframes for illiquid assets. • Discretisation bias — Estimates degrade when ticks-per-bar is very small. Consider higher timeframes for thinly traded instruments. • Scale mixing — Different scale groups (log-return, price unit, percentage) cannot be meaningfully compared or aggregated. The indicator warns but does not prevent display. 🌸 --------- CREDITS --------- 🌸 💮 Academic Sources • Parkinson, M. (1980). The Extreme Value Method for Estimating the Variance of the Rate of Return. Journal of Business, 53 (1), 61–65. DOI • Garman, M.B. & Klass, M.J. (1980). On the Estimation of Security Price Volatilities from Historical Data. Journal of Business, 53 (1), 67–78. DOI • Rogers, L.C.G. & Satchell, S.E. (1991). Estimating Variance from High, Low and Closing Prices. Annals of Applied Probability, 1 (4), 504–512. DOI • Yang, D. & Zhang, Q. (2000). Drift-Independent Volatility Estimation Based on High, Low, Open, and Close Prices. Journal of Business, 73 (3), 477–491. DOI • Wilder, J.W. (1978). New Concepts in Technical Trading Systems . Trend Research. 💮 Libraries Used • VolatilityToolkit Library — Range-based estimators, smoothing, and aggregation functions • FiltersToolkit Library — Advanced smoothing filters (Super Smoother, Ultimate Smoother, BiQuad, etc.) • ColourUtilities Library — Colour palette management and gradient calculations

Indicator

by GoemonYae

[GYTS] VolatilityToolkit Library VolatilityToolkit Library 🌸 Part of GoemonYae Trading System (GYTS) 🌸 🌸 --------- INTRODUCTION --------- 🌸 💮 What Does This Library Contain? VolatilityToolkit provides a comprehensive suite of volatility estimation functions derived from academic research in financial econometrics. Rather than relying on simplistic measures, this library implements range-based estimators that extract maximum information from OHLC data — delivering estimates that are 5–14× more efficient than traditional close-to-close methods. The library spans the full volatility workflow: estimation, smoothing, and regime detection. 💮 Key Categories • Range-Based Estimators — Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang (academically-grounded variance estimators) • Classical Measures — Close-to-Close, ATR, Chaikin Volatility (baseline and price-unit measures) • Smoothing & Post-Processing — Asymmetric EWMA for differential decay rates • Aggregation & Regime Detection — Multi-horizon blending, MTF aggregation, Volatility Burst Ratio 💮 Originality To the best of our knowledge, no other PulseWire script combines range-based estimators (Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang), classical measures, and regime detection tools in a single package. Unlike typical volatility implementations that offer only a single method, this library: • Implements four academically-grounded range-based estimators with proper mathematical foundations • Handles drift bias and overnight gaps, issues that plague simpler estimators in trending markets • Integrates with GYTS FiltersToolkit for advanced smoothing (10 filter types vs. typical SMA-only) • Provides regime detection tools (Burst Ratio, MTF aggregation) for systematic strategy integration • Standardises output units for seamless estimator comparison and swapping 🌸 --------- ADDED VALUE --------- 🌸 💮 Academic Rigour Each estimator implements peer-reviewed methodologies with proper mathematical foundations. The library handles aspects that are easily missed, e.g. drift independence, overnight gap adjustment, and optimal weighting factors. All functions include guards against edge cases (division by zero, negative variance floors, warmup handling). 💮 Statistical Efficiency Range-based estimators extract more information from the same data. Yang-Zhang achieves up to 14× the efficiency of close-to-close variance, meaning you can achieve the same estimation accuracy with far fewer bars — critical for adapting quickly to changing market conditions. 💮 Flexible Smoothing All estimators support configurable smoothing via the GYTS FiltersToolkit integration. Choose from 10 filter types to balance responsiveness against noise reduction: • Ultimate Smoother (2-Pole / 3-Pole) — Near-zero lag; the 3-pole variant is a GYTS design with tunable overshoot • Super Smoother (2-Pole / 3-Pole) — Excellent noise reduction with minimal lag • BiQuad — Second-order IIR filter with quality factor control • ADXvma — Adaptive smoothing based on directional volatility • MAMA — Cycle-adaptive moving average • A2RMA — Adaptive autonomous recursive moving average • SMA / EMA — Classical averages (SMA is default for most estimators) Using Infinite Impulse Response (IIR) filters (e.g. Super Smoother, Ultimate Smoother) instead of SMA avoids the "drop-off artefact" where volatility readings crash when old spikes exit the window. 💮 Plug-and-Play Integration Standardised output units (per-bar log-return volatility) make it trivial to swap estimators. The annualize() helper converts to yearly volatility with a single call. All functions work seamlessly with other GYTS components. 🌸 --------- RANGE-BASED ESTIMATORS --------- 🌸 These estimators utilise High, Low, Open, and Close prices to extract significantly more information about the underlying diffusion process than close-only methods. 💮 parkinson() The Extreme Value Method -- approximately 5× more efficient than close-to-close, requiring about 80% less data for equivalent accuracy. Uses only the High-Low range, making it simple and robust. • Assumption: Zero drift (random walk). May be biased in strongly trending markets. • Best for: Quick volatility reads when drift is minimal. • Parameters: smoothing_length (default 14), filter_type (default SMA), smoothing_factor (default 0.7) Source: Parkinson, M. (1980). The Extreme Value Method for Estimating the Variance of the Rate of Return. Journal of Business, 53 (1), 61–65. DOI 💮 garman_klass() Extends Parkinson by incorporating Open and Close prices, achieving approximately 7.4× efficiency over close-to-close. Implements the "practical" analytic estimator (σ̂²₅) which avoids cross-product terms whilst maintaining near-optimal efficiency. • Assumption: Zero drift, continuous trading (no gaps). • Best for: Markets with minimal overnight gaps and ranging conditions. • Parameters: smoothing_length (default 14), filter_type (default SMA), smoothing_factor (default 0.7) Source: Garman, M.B. & Klass, M.J. (1980). On the Estimation of Security Price Volatilities from Historical Data. Journal of Business, 53 (1), 67–78. DOI 💮 rogers_satchell() The drift-independent estimator correctly isolates variance even in strongly trending markets where Parkinson and Garman-Klass become significantly biased. Uses the formula: ln(H/C)·ln(H/O) + ln(L/C)·ln(L/O). • Key advantage: Unbiased regardless of trend direction or magnitude. • Best for: Trending markets, crypto (24/7 trading with minimal gaps), general-purpose use. • Parameters: smoothing_length (default 14), filter_type (default SMA), smoothing_factor (default 0.7) Source: Rogers, L.C.G. & Satchell, S.E. (1991). Estimating Variance from High, Low and Closing Prices. Annals of Applied Probability, 1 (4), 504–512. DOI 💮 yang_zhang() The minimum-variance composite estimator — both drift-independent AND gap-aware. Combines overnight returns, open-to-close returns, and the Rogers-Satchell component with optimal weighting to minimise estimator variance. Up to 14× more efficient than close-to-close. • Parameters: lookback (default 14, minimum 2), alpha (default 1.34, optimised for equities). • Best for: Equity markets with significant overnight gaps, highest-quality volatility estimation. • Note: Unlike other estimators, Yang-Zhang does not support custom filter types — it uses rolling sample variance internally. Source: Yang, D. & Zhang, Q. (2000). Drift-Independent Volatility Estimation Based on High, Low, Open, and Close Prices. Journal of Business, 73 (3), 477–491. DOI 🌸 --------- CLASSICAL MEASURES --------- 🌸 💮 close_to_close() Classical sample variance of logarithmic returns. Provided primarily as a baseline benchmark — it is approximately 5–8× less efficient than range-based estimators, requiring proportionally more data for the same accuracy. • Parameters: lookback (default 14), filter_type (default SMA), smoothing_factor (default 0.7) • Use case: Comparison baseline, situations requiring strict methodological consistency with academic literature. 💮 atr() Average True Range -- measures volatility in price units rather than log-returns. Directly interpretable for stop-loss placement (e.g., "2× ATR trailing stop") and handles gaps naturally via the True Range formula. • Output: Price units (not comparable across different price levels). • Parameters: smoothing_length (default 14), filter_type (default SMA), smoothing_factor (default 0.7) • Best for: Position sizing, trailing stops, any application requiring volatility in currency terms. Source: Wilder, J.W. (1978). New Concepts in Technical Trading Systems . Trend Research. 💮 chaikin_volatility() Rate of Change of the smoothed trading range. Unlike level-based measures, Chaikin Volatility shows whether volatility is expanding or contracting relative to recent history. • Output: Percentage change (oscillates around zero). • Parameters: length (default 10), roc_length (default 10), filter_type (default EMA), smoothing_factor (default 0.7) • Interpretation: High values suggest nervous, wide-ranging markets; low values indicate compression. • Best for: Detecting volatility regime shifts, breakout anticipation. 🌸 --------- SMOOTHING & POST-PROCESSING --------- 🌸 💮 asymmetric_ewma() Differential smoothing with separate alphas for rising versus falling volatility. Allows volatility to spike quickly (fast reaction to shocks) whilst decaying slowly (stability). Essential for trailing stops that should widen rapidly during turbulence but narrow gradually. • Parameters: alpha_up (default 0.1), alpha_down (default 0.02). • Note: Stateful function — call exactly once per bar. 💮 annualize() Converts per-bar volatility to annualised volatility using the square-root-of-time rule: σ_annual = σ_bar × √(periods_per_year). • Parameters: vol (series float), periods (default 252 for daily equity bars). • Common values: 365 (crypto), 52 (weekly), 12 (monthly). 🌸 --------- AGGREGATION & REGIME DETECTION --------- 🌸 💮 weighted_horizon_volatility() Blends volatility readings across short, medium, and long lookback horizons. Inspired by the Heterogeneous Autoregressive (HAR-RV) model's recognition that market participants operate on different time scales. • Default horizons: 1-bar (short), 5-bar (medium), 22-bar (long). • Default weights: 0.5, 0.3, 0.2. • Note: This is a weighted trailing average, not a forecasting regression. For true HAR-RV forecasting, it would be required to fit regression coefficients. Inspired by: Corsi, F. (2009). A Simple Approximate Long-Memory Model of Realized Volatility. Journal of Financial Econometrics . 💮 volatility_mtf() Multi-timeframe aggregation for intraday charts. Combines base volatility with higher-timeframe (Daily, Weekly, Monthly) readings, automatically scaling HTF volatilities down to the current timeframe's magnitude using the square-root-of-time rule. • Usage: Calculate HTF volatilities via request.security() externally, then pass to this function. • Behaviour: Returns base volatility unchanged on Daily+ timeframes (MTF aggregation not applicable). 💮 volatility_burst_ratio() Regime shift detector comparing short-term to long-term volatility. • Parameters: short_period (default 8), long_period (default 50), filter_type (default Super Smoother 2-Pole), smoothing_factor (default 0.7) • Interpretation: Ratio > 1.0 indicates expanding volatility; values > 1.5 often precede or accompany explosive breakouts. • Best for: Filtering entries (e.g., "only enter if volatility is expanding"), dynamic risk adjustment, breakout confirmation. 🌸 --------- PRACTICAL USAGE NOTES --------- 🌸 💮 Choosing an Estimator • Trending equities with gaps: yang_zhang() — handles both drift and overnight gaps optimally. • Crypto (24/7 trading): rogers_satchell() — drift-independent without the lag of Yang-Zhang's multi-period window. • Ranging markets: garman_klass() or parkinson() — simpler, no drift adjustment needed. • Price-based stops: atr() — output in price units, directly usable for stop distances. • Regime detection: Combine any estimator with volatility_burst_ratio(). 💮 Output Units All range-based estimators output per-bar volatility in log-return units (standard deviation). To convert to annualised percentage volatility (the convention in options and risk management), use: vol_annual = annualize(yang_zhang(14), 252) // For daily bars vol_percent = vol_annual * 100 // Express as percentage 💮 Smoothing Selection The library integrates with FiltersToolkit for flexible smoothing. General guidance: • SMA: Classical, statistically valid, but suffers from "drop-off" artefacts when spikes exit the window. • Super Smoother / Ultimate Smoother / BiQuad: Natural decay, reduced lag — preferred for trading applications. • MAMA / ADXvma / A2RMA: Adaptive smoothing, sometimes interesting for highly dynamic environments. 💮 Edge Cases and Limitations • Flat candles: Guards prevent log(0) errors, but single-tick bars produce near-zero variance readings. • Illiquid assets: Discretisation bias causes underestimation when ticks-per-bar is small. Use higher timeframes for more reliable estimates. • Yang-Zhang minimum: Requires lookback ≥ 2 (enforced internally). Cannot produce instantaneous readings. • Drift in Parkinson/GK: These estimators overestimate variance in trending conditions — switch to Rogers-Satchell or Yang-Zhang. Note: This library is actively maintained. Suggestions for additional estimators or improvements are welcome.

Library

by GoemonYae

Yang-Zhang Volatility Updated for SD thanks to mpatte15 for writing this originally code was updated to utilize sqrt on Vyangzhang to plot standard deviation vs variance

Indicator

by izzycalderisi