📖 Guida — Chart v2 (Z-Score OLS)

Spiegazione degli indici, funzioni dell'app e workflow di pair trading

📊 Indici

⚙️ Funzioni

🚦 Segnali

🔄 Workflow

📊 Indici Statistici Calcolati

Z-Score

Principale

Z = (Spread_t − μ_spread) / σ_spread

Misura di quante deviazioni standard il log-spread si discosta dalla sua media mobile. È il cuore dell'app: indica se la coppia è momentaneamente "cara" o "economica" rispetto alla propria storia recente. Il lookback usato per μ e σ è il parametro Periodo.

Z ≥ +2 → SELL A / BUY B Z ≤ −2 → BUY A / SELL B |Z| < 2 → WAIT

Beta (β)

OLS Regression

log(A) = α + β · log(B) + ε

Coefficiente della regressione OLS tra i log-prezzi di A e B. Indica quanto capitale di B serve per coprire 1 unità di A. Usato dall'Hedge Calculator per bilanciare le due gambe della posizione. Un β instabile (fuori range 0.5–2.5) segnala che la coppia non è robusta.

0.5 ≤ β ≤ 2.5 → OK β < 0.5 o > 2.5 → Attenzione

Correlazione (Pearson)

Qualità Coppia

r = cov(rA, rB) / (σ_rA · σ_rB)

Correlazione di Pearson sui ritorni percentuali dei due asset calcolata sulla finestra Periodo. Misura quanto i due asset si muovono insieme. Una correlazione alta riduce il rischio direzionale netto della strategia.

r ≥ 0.70 → Ottima coppia 0.50 ≤ r < 0.70 → Accettabile r < 0.50 → Coppia debole

Half-Life (Ornstein-Uhlenbeck)

Mean Reversion

HL = −ln(2) / ln(φ) | dS = κ(μ−S)dt + σdW

Tempo stimato (in barre) affinché lo spread percorra metà strada verso la sua media. Derivato dal modello Ornstein-Uhlenbeck: viene stimato il parametro φ dalla regressione ΔSpread_t = φ·Spread_{t-1} + ε. Un Half-Life troppo alto rispetto al Periodo significa che la mean-reversion è lenta e il trade rimarrebbe aperto troppo a lungo.

HL < Periodo/2 → Buona reversion HL ≥ Periodo/2 → Reversion lenta HL = NaN → Spread non stazionario

💡 Come si calcola il Log Spread?
Spread = log(chiusura_A) − β · log(chiusura_B). Il logaritmo rende lo spread stazionario anche se i prezzi assoluti divergono nel tempo.

⚙️ Funzioni e Pannelli dell'App

🚀

CALCOLA

Scarica le candele dalla API dell'exchange selezionato, esegue la regressione OLS, calcola Z-Score, correlazione, Half-Life e aggiorna tutti i grafici.

🤖

AUTO (Ottimizzatore)

Esegue un grid search sul parametro Periodo (da 20 a 200 barre) e seleziona quello che massimizza l'equity finale del backtest con almeno 2 trade completati.

🔄

Auto-Refresh 15s

Aggiorna silenziosamente i dati ogni 15 secondi senza ricaricare la pagina. Ideale per scalping o monitoraggio continuo. Un punto verde lampeggiante indica che è attivo.

🔔

Alert Sonoro

Emette un suono quando il segnale Z-Score attraversa le soglie ±2. Usa Web Audio API. Attivare prima di accendere il refresh automatico per non perdersi i segnali.

🧮

Hedge Calculator

Inserisci il capitale allocato su Asset A. L'app moltiplica per il Beta corrente e ti mostra quanti dollari devi allocare su Asset B per un hedge neutro al mercato.

⏱️

Backtest (1000 barre)

Simula la strategia su 1000 barre storiche: entra quando |Z| ≥ 2, esce a Z = 0. Mostra numero di trade, ROI netto % e tempo medio di chiusura per valutare se la coppia è storicamente valida.

✨

Lista Personale

Salva le tue coppie preferite con nome, descrizione e categoria. Persistenza server-side (chart26.json). Supporta importazione/esportazione JSON, preferiti (⭐) e caricamento rapido (▶️).

🎨

Personalizza Tema

6 temi predefiniti (Default, Nord, Dim, Forest, OLED, FinTech) + editor colore completo variabile per variabile. Tema salvato in localStorage per persistere tra sessioni.

📈 Grafici Interattivi

Z-Score Divergence — grafico principale. La linea cambia colore: blu = neutro, rosso = sopra +2 (sell), verde = sotto −2 (buy). I punti scatter mostrano il momento esatto del crossover.
Log Spread — la traiettoria grezza dello spread tra i due asset.
Performance Comparata (%) — mostra il ritorno % di A (blu) e B (giallo) dalla prima candela del periodo. Aiuta a vedere chi sta guidando la divergenza.

🔍 Zoom/Pan: scroll del mouse per zoomare, drag per navigare su tutti i grafici.

🚦 Interpretazione Segnali e Color Coding

Indicatore	Valore	Colore	Significato
Z-Score	≥ +2.0	Rosso	Spread alto → SELL A / BUY B
Z-Score	≤ −2.0	Verde	Spread basso → BUY A / SELL B
Z-Score	\|Z\| < 2.0	Bianco	Zona neutrale → WAIT
Correlazione	≥ 0.70	Verde	Coppia co-integrata robusta
Correlazione	0.0 – 0.69	Giallo	Correlazione debole, rischio maggiore
Correlazione	< 0.0	Rosso	Correlazione negativa, sconsigliato
Beta	0.5 – 2.5	Bianco	Beta stabile e bilanciato
Beta	< 0.5 o > 2.5	Giallo	Beta estremo, hedge squilibrato
Half-Life	< Periodo/2	Verde	Mean-reversion rapida, trade brevi
Half-Life	≥ Periodo/2	Giallo	Reversion lenta, aumenta draw-down
Half-Life	NaN / negativo	Rosso	Spread non stazionario, coppia invalida
ROI Backtest	> 0%	Verde	Strategia storicamente profittevole
ROI Backtest	< 0%	Rosso	Strategia storicamente in perdita

⚠️ Nota sul Backtest: il backtest usa 1 trade alla volta (no posizioni simultanee) e non tiene conto di slippage, funding rate o fee. È uno strumento di validazione statistica, non una garanzia di performance futura. Usa sempre un ROI netto positivo e almeno 5–10 trade come soglia minima di fiducia.

🔄 Workflow Operativo — Passo a Passo

Scegli la coppia da analizzare

Dalla Lista Personale a destra clicca ▶️ su una coppia esistente, oppure usa ➕ Nuova Coppia per aggiungerne una. In alternativa seleziona direttamente il menù "Coppia Selezionata". Scegli asset dello stesso settore (Layer1 + Layer1, DeFi + DeFi, ecc.) per massimizzare la correlazione.

💡 Coppie buone per iniziare: ETH/BNB, SOL/AVAX, LINK/BAND, UNI/SUSHI

Seleziona Exchange e Timeframe

Scegli Binance Futures o Bybit Futures in base a dove operi. Per il timeframe: usa 1H o 4H per swing trading (posizioni di giorni), 15m per intraday, 1m–5m per scalping (solo con auto-refresh).

💡 Inizia con 1H: meno rumore e segnali più affidabili

Ottimizza il Periodo con AUTO

Premi il bottone 🤖 AUTO. L'app testa tutti i lookback da 20 a 200 barre e seleziona quello con la migliore equity sul backtest. Puoi anche impostare manualmente un valore (tipicamente 80–120 barre su 1H).

Periodo consigliato: 80–120 barre su timeframe 1H

Esegui il calcolo e valida la coppia

Premi 🚀 CALCOLA. Controlla i 4 indici:

✅ Correlazione ≥ 0.70 (verde)
✅ Half-Life < Periodo/2 (verde)
✅ Beta tra 0.5 e 2.5 (bianco)
✅ ROI Backtest > 0% (verde)

⚠️ Se anche uno solo è in rosso, considera un'altra coppia o un altro timeframe

Attendi il segnale di ingresso

Attiva 🔄 Auto 15s + 🔔 Suono e aspetta che il pannello segnale mostri BUY o SELL. Il segnale appare quando Z-Score attraversa la soglia ±2.0.

🟢 BUY A / SELL B → quando Z ≤ −2 (A è relativamente economica)
🔴 SELL A / BUY B → quando Z ≥ +2 (A è relativamente cara)

Dimensiona le posizioni con l'Hedge Calculator

Inserisci il capitale che vuoi allocare su Asset A nel 🧮 Hedge Calculator. L'app ti mostra automaticamente il capitale equivalente da allocare su Asset B moltiplicando per il Beta corrente. Questo garantisce un'esposizione netta quasi delta-neutrale.

Capitale B = Capitale A × Beta_corrente

💡 Usa max 20–30% del capitale disponibile per singola posizione (gestione rischio)

Gestisci la posizione aperta

Con la posizione aperta continua a monitorare lo Z-Score. Il trade è in profit quando lo spread si avvicina alla media. Imposta uno stop-loss mentale se Z supera ±3.0 nella direzione sbagliata (spread che si allarga ulteriormente).

🎯 Target: Z ritorna a 0 (mean reversion completata)
🛑 Stop-loss: |Z| supera 3.0–3.5 dopo l'ingresso

Chiudi la posizione all'uscita

Chiudi entrambe le gambe (A e B) quando il segnale torna a ⚪ WAIT, cioè quando Z-Score ritorna nel range ±0.5. Chiudi sempre entrambe le gambe contemporaneamente: chiudere solo una crea esposizione direzionale non coperta.

💡 Se il Half-Life è 8 barre su 1H, aspettati di tenere il trade aperto ~8 ore in media

Rivalida la coppia periodicamente

Beta e correlazione cambiano nel tempo. Ricalcola la coppia ogni 24–48 ore o dopo eventi di mercato importanti (news, liquidazioni). Se la correlazione scende sotto 0.6, valuta di chiudere eventuali posizioni aperte e rivalutare la coppia.

⚠️ Il Beta cambia: aggiorna il calcolo dell'Hedge prima di ogni nuovo ingresso

✅ Checklist Pre-Trade

☐ Correlazione ≥ 0.70
☐ Half-Life < Periodo / 2
☐ Beta tra 0.5 e 2.5
☐ Backtest ROI > 0% con almeno 5 trade
☐ Z-Score ha appena attraversato ±2 (non è già a ±3)
☐ Capitale B calcolato con Hedge Calculator aggiornato
☐ Stop-loss mentale definito a |Z| = 3.0–3.5