OPEN-SOURCE SCRIPT

Daily Return Z-Score / Outlier

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

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.
Return calculation: Either simple percentage returns (close − close[1]) / close[1] or log returns ln(close / close[1]).
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.
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.
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

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.
Return-Berechnung: Wahlweise einfache prozentuale Returns (close − close[1]) / close[1] oder Log-Returns ln(close / close[1]).
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.
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.
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.

Script de código aberto

Em verdadeiro espírito do TradingView, o criador deste script o tornou de código aberto, para que os traders possam revisar e verificar sua funcionalidade. Parabéns ao autor! Embora você possa usá-lo gratuitamente, lembre-se de que a republicação do código está sujeita às nossas Regras da Casa.

Tools-for-Trader

Também em:

Aviso legal

As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.

Script de código aberto

Tools-for-Trader

Também em: