OPEN-SOURCE SCRIPT

Daily Return Z-Score / Outlier

294
Daily Return Z-Score / Outlier

What this indicator does

Daily Return Z-Score / Outlier measures how unusual today's daily return is relative to the instrument's own historical return distribution. It converts the current return into a Z-Score (standard-deviation scale) and colours the bars according to whether the return sits in the normal range, a warning zone, or an extreme zone (fat-tail event).

The goal is to make statistical outliers visible — days on which the price move is materially larger than the recent history would suggest.

How it works

  1. Data basis (daily context): Daily returns are sampled on the daily timeframe ("D") via request.security, independent of the chart timeframe currently displayed. This keeps the statistical reference consistent.
  2. Return calculation: Either simple percentage returns (close − close[1]) / close[1] or log returns ln(close / close[1]).
  3. Distribution statistics over a rolling window (default: 252 trading days ≈ 1 year). Two methods are available:
    • MAD (robust): Median and median absolute deviation. Insensitive to individual extreme values. The Z-Score is computed as 0.6745 · (return − median) / MAD (scaled to the normal distribution).
    • Classic: Mean and standard deviation. Z = (return − mean) / stdev. More reactive to, and distorted by, extreme values.
  4. Empirical percentiles: In addition to the Z-Score, warning and extreme thresholds are derived directly from the observed percentiles of the return distribution (e.g. 5% / 95% for warning, 1% / 99% for extreme). Bar colour follows these empirical percentiles rather than normality assumptions.
  5. Live return: The running return is computed against yesterday's daily close, so the classification updates intraday as the current day develops.


Display

  • Histogram of the Z-Score on a common sigma scale.
  • Reference lines at 0, ±1, ±2 and ±3 sigma for visual orientation.
  • Live label showing the current Z-Score on the last bar.
  • Values table (optional, bottom-right) with Z-Score, band classification, selected method, today's return, the dispersion measure (MAD or stdev), warning/extreme thresholds, and the effective sample size.


Colour logic

  • Normal — return within the warning percentiles.
  • Warn + / − — return beyond the warning percentile.
  • EXTREME + / − — return beyond the extreme percentile (fat tail).


Settings

  • Method: MAD (robust) or Classic (mean/stdev).
  • Lookback (days): Length of the statistics window (5–1000).
  • Log returns: Log instead of percentage returns.
  • Warning percentile % and Extreme percentile %: Colouring thresholds.
  • Colours for bullish/bearish warning and extreme zones.
  • Show values table.


Alerts

  • Extreme outlier UP — daily return beyond the upper extreme percentile.
  • Extreme outlier DOWN — daily return beyond the lower extreme percentile.
  • Extreme outlier (both directions) — combined condition.


How to use it

The indicator helps highlight days with a statistically notable move — for example to add context to news days, to watch for volatility clustering, or as a filter alongside an existing strategy. The MAD method is recommended when the history contains isolated strong outliers.

Notes

  • A Z-Score measures how unusual a move is, not its direction as a forecast.
  • Significance depends on a sufficiently large sample (see the "Sample" field in the table).
  • This script is an analysis tool and does not constitute financial advice. Past distributions are no guarantee of future behaviour.



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


Daily Return Z-Score / Outlier — Deutsch

Was macht dieser Indikator?

Daily Return Z-Score / Outlier misst, wie ungewöhnlich der heutige Tages-Return im Vergleich zur eigenen historischen Verteilung des Wertpapiers ist. Der Indikator wandelt den aktuellen Return in einen Z-Score (Standardabweichungs-Skala) um und färbt die Balken danach ein, ob sich der Return im normalen Bereich, in einer Warn-Zone oder in einer Extrem-Zone (Fat-Tail-Ereignis) befindet.

Ziel ist es, statistische Ausreisser sichtbar zu machen — also Tage, an denen die Kursbewegung deutlich grösser ausfällt, als es die jüngste Historie nahelegt.

Wie es funktioniert

  1. Datenbasis (Daily-Kontext): Über request.security werden die Tages-Returns auf dem Tages-Timeframe ("D") erhoben, unabhängig vom aktuell angezeigten Chart-Timeframe. So bleibt der statistische Bezug konsistent.
  2. Return-Berechnung: Wahlweise einfache prozentuale Returns (close − close[1]) / close[1] oder Log-Returns ln(close / close[1]).
  3. Verteilungsstatistik über ein rollierendes Fenster (Standard: 252 Handelstage ≈ 1 Jahr). Zwei Methoden stehen zur Wahl:
    • MAD (robust): Median und Median-Absolutabweichung. Unempfindlich gegen einzelne Extremwerte. Der Z-Score wird als 0.6745 · (Return − Median) / MAD berechnet (skaliert auf die Normalverteilung).
    • Klassisch: Mittelwert und Standardabweichung. Z = (Return − Mean) / Stdev. Reagiert stärker auf Extremwerte und wird von diesen verzerrt.
  4. Empirische Perzentile: Zusätzlich zum Z-Score werden Warn- und Extrem-Schwellen direkt aus den beobachteten Perzentilen der Return-Verteilung gebildet (z. B. 5% / 95% für Warnung, 1% / 99% für Extrem). Die Balkenfarbe richtet sich nach diesen empirischen Perzentilen, nicht nach Normalverteilungs-Annahmen.
  5. Live-Return: Der laufende Return wird gegen den gestrigen Tages-Schluss berechnet, sodass die Einordnung schon während des laufenden Tages aktualisiert wird.


Anzeige

  • Histogramm des Z-Scores auf einer gemeinsamen Sigma-Skala.
  • Referenzlinien bei 0, ±1, ±2 und ±3 Sigma zur visuellen Orientierung.
  • Live-Label mit dem aktuellen Z-Score am letzten Balken.
  • Werte-Tabelle (optional, unten rechts) mit Z-Score, Band-Einstufung, gewählter Methode, heutigem Return, Streuungsmass (MAD bzw. Stdev), Warn-/Extrem-Schwellen sowie der effektiven Stichprobengrösse.


Farb-Logik

  • Normal — Return innerhalb der Warn-Perzentile.
  • Warn + / − — Return jenseits des Warn-Perzentils.
  • EXTREM + / − — Return jenseits des Extrem-Perzentils (Fat Tail).


Einstellungen

  • Methode: MAD (robust) oder Klassisch (mean/stdev).
  • Lookback (Tage): Länge des Statistik-Fensters (5–1000).
  • Log-Returns: Log- statt prozentuale Returns.
  • Warn-Perzentil % und Extrem-Perzentil %: Schwellen für die Färbung.
  • Farben für bullische/bärische Warn- und Extrem-Zonen.
  • Werte-Tabelle anzeigen.


Alerts

  • Extrem-Ausreisser HOCH — Tagesreturn jenseits des oberen Extrem-Perzentils.
  • Extrem-Ausreisser RUNTER — Tagesreturn jenseits des unteren Extrem-Perzentils.
  • Extrem-Ausreisser (beide Richtungen) — kombinierte Bedingung.


Verwendung

Der Indikator eignet sich, um Tage mit statistisch auffälliger Bewegung hervorzuheben — etwa zur Kontext-Einordnung von News-Tagen, zur Beobachtung von Volatilitäts-Clustern oder als Filter neben einer bestehenden Strategie. Die MAD-Methode wird empfohlen, wenn die Historie einzelne starke Ausreisser enthält.

Hinweise

  • Ein Z-Score misst die Ungewöhnlichkeit einer Bewegung, nicht deren Richtung im Sinne einer Prognose.
  • Die Aussagekraft hängt von einer ausreichend grossen Stichprobe ab (siehe Feld "Sample" in der Tabelle).
  • Dieses Skript ist ein Analyse-Werkzeug und stellt keine Anlageberatung dar. Vergangene Verteilungen sind keine Garantie für zukünftiges Verhalten.

면책사항

해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.