"""TREND PORTFOLIO (TP01) — l'UNICA strategia profittevole e robusta post-reset (2026-06-19). Vincitrice della ricerca su dati certificati BTC/ETH (Deribit mainnet). TSMOM multi-orizzonte (1-3-6 mesi) vol-targeted, portafoglio 50/50 BTC+ETH. Validata onestamente (no look-ahead, fee 0.10% RT, positiva ogni anno 2019-2026, robusta su griglia e su tutti i timeframe 15m-1d). Config canonica deployabile (PORT LF1d): timeframe >=12h (1d RACCOMANDATO), LONG-FLAT (niente short), vol-target 20%, leverage cap 2x. -> FULL Sharpe ~1.30, maxDD ~14%, HOLD-OUT 2025-26 Sharpe ~0.31 (calcolo per-TF leak-free). NB LOOK-AHEAD (2026-06-19): un ffill MIXED-TIMEFRAME su barre open-labeled (label="left") gonfiava il 4h (~1.60 -> reale ~1.1). Il calcolo per-SINGOLO-TF e' leak-free (guard prefix-recompute), ma sotto le 12h costi+overfitting dominano SENZA vantaggio reale (FULL Sh piatto ~1.3 da 12h a 4h; hold-out MIGLIORE a 1d). -> NON scendere sotto le 12h; deploy a 1d. TP01 e' DIFENSIVA (taglia il DD ~6x vs buy&hold), NON alpha. Vedi docs/diary/2026-06-19-tp01-lookahead-fix-lf.md e scripts/analysis/tp01_lowfreq.py. API (tutto causale, decide con dati <= close[i]): from src.strategies.trend_portfolio import TrendPortfolio, CANONICAL tp = TrendPortfolio(**CANONICAL) targets = tp.target_series(df_4h) # array posizioni-bersaglio (frazione di equity, +/-) w = tp.current_target(df_4h) # ultima posizione-bersaglio (per il live) res = tp.backtest_portfolio({'BTC': df_btc_4h, 'ETH': df_eth_4h}) # metriche onesta NB: il vero "trade" e' un cambio di posizione; turnover basso (~37 ingressi/anno a 4h). """ from __future__ import annotations from dataclasses import dataclass import numpy as np import pandas as pd # config canonica raccomandata per il deploy CANONICAL = dict( target_vol=0.20, leverage=2.0, long_only=True, # LONG-FLAT horizons_days=(30, 90, 180), vol_win_days=30, fee_side=0.0005, # 0.05%/lato = 0.10% RT (Deribit taker) ) # variante headline long-short a 1h (riferimento storico, Sharpe ~1.0) HEADLINE_LS_1H = dict( target_vol=0.20, leverage=2.0, long_only=False, horizons_days=(30, 90, 180), vol_win_days=30, fee_side=0.0005, ) BARS_PER_DAY = {"5m": 288, "15m": 96, "1h": 24, "4h": 6, "1d": 1} def simple_returns(c: np.ndarray) -> np.ndarray: r = np.zeros(len(c)) r[1:] = c[1:] / c[:-1] - 1.0 return r def realized_vol(r: np.ndarray, win: int, bars_per_year: float) -> np.ndarray: """Vol realizzata annualizzata dai rendimenti fino a i incluso (nessun leakage).""" return pd.Series(r).rolling(win, min_periods=win // 2).std().values * np.sqrt(bars_per_year) def tsmom_blend(c: np.ndarray, horizons: tuple[int, ...]) -> np.ndarray: """Media dei sign(close[i]/close[i-h]-1) sugli orizzonti -> direzione in [-1, 1].""" n = len(c) acc = np.zeros(n) cnt = np.zeros(n) for h in horizons: s = np.full(n, np.nan) s[h:] = np.sign(c[h:] / c[:-h] - 1.0) valid = np.isfinite(s) acc[valid] += s[valid] cnt[valid] += 1 out = np.zeros(n) nz = cnt > 0 out[nz] = acc[nz] / cnt[nz] return out @dataclass class TrendPortfolio: target_vol: float = 0.20 leverage: float = 2.0 long_only: bool = True horizons_days: tuple[int, ...] = (30, 90, 180) vol_win_days: int = 30 fee_side: float = 0.0005 def _bpd(self, df: pd.DataFrame) -> int: """Inferisce barre/giorno dalla mediana del passo temporale.""" dt = pd.to_datetime(df["datetime"]).diff().dt.total_seconds().median() return max(1, round(86400 / dt)) def target_series(self, df: pd.DataFrame) -> np.ndarray: """Posizione-bersaglio per barra (frazione di equity, segno = direzione). target[i] usa SOLO dati <= close[i] -> va TENUTA durante la barra i+1.""" c = df["close"].values.astype(float) bpd = self._bpd(df) bpy = bpd * 365.25 r = simple_returns(c) vol = realized_vol(r, self.vol_win_days * bpd, bpy) horizons = tuple(d * bpd for d in self.horizons_days) direction = tsmom_blend(c, horizons) if self.long_only: direction = np.clip(direction, 0, None) scal = np.where((vol > 0) & np.isfinite(vol), self.target_vol / vol, 0.0) tgt = np.clip(direction * scal, -self.leverage, self.leverage) tgt[~np.isfinite(tgt)] = 0.0 return tgt def current_target(self, df: pd.DataFrame) -> float: """Posizione-bersaglio decisa all'ultima barra CHIUSA (per il paper/live).""" return float(self.target_series(df)[-1]) def net_returns(self, df: pd.DataFrame) -> tuple[np.ndarray, pd.Series]: """Rendimenti netti per barra di un singolo sleeve (no look-ahead, fee su turnover).""" c = df["close"].values.astype(float) r = simple_returns(c) tgt = self.target_series(df) pos_held = np.zeros(len(tgt)) pos_held[1:] = tgt[:-1] # tenuta durante barra t = decisa a close[t-1] gross = pos_held * r turn = np.abs(np.diff(pos_held, prepend=0.0)) net = gross - self.fee_side * turn net[0] = 0.0 net = np.clip(net, -0.99, None) return net, pd.to_datetime(df["datetime"]) def backtest_portfolio(self, dfs: dict[str, pd.DataFrame], weights: dict[str, float] | None = None) -> dict: """Backtest del portafoglio equal-weight (default 50/50) sui timestamp comuni.""" weights = weights or {a: 1.0 / len(dfs) for a in dfs} series = {} for a, df in dfs.items(): net, ts = self.net_returns(df) series[a] = pd.Series(net, index=pd.to_datetime(ts.values)) J = pd.concat(series, axis=1, join="inner").fillna(0.0) combo = sum(weights[a] * J[a].values for a in dfs) idx = J.index equity = np.cumprod(1.0 + np.clip(combo, -0.99, None)) return _metrics(equity, combo, idx) def _metrics(equity: np.ndarray, combo: np.ndarray, idx: pd.DatetimeIndex) -> dict: bpy = _bars_per_year(idx) rr = combo[np.isfinite(combo)] sharpe = float(np.mean(rr) / np.std(rr) * np.sqrt(bpy)) if np.std(rr) > 0 else 0.0 peak = np.maximum.accumulate(equity) dd = float(np.max((peak - equity) / peak)) span_days = (idx[-1] - idx[0]).total_seconds() / 86400 years = span_days / 365.25 if span_days > 0 else 1.0 total = equity[-1] / equity[0] cagr = total ** (1 / years) - 1 if years > 0 and total > 0 else -1.0 eq = pd.Series(equity, index=idx) yearly = {} for y, g in eq.groupby(eq.index.year): if len(g) > 1 and g.iloc[0] > 0: v = g.values pk = np.maximum.accumulate(v) yearly[int(y)] = dict(pnl=float(g.iloc[-1] / g.iloc[0] - 1), dd=float(np.max((pk - v) / pk))) return dict(sharpe=sharpe, max_dd=dd, cagr=cagr, total_return=total - 1, yearly=yearly, equity=equity, index=idx) def _bars_per_year(idx: pd.DatetimeIndex) -> float: if len(idx) < 2: return 365.25 dt = pd.Series(idx).diff().dt.total_seconds().median() return 86400 * 365.25 / dt if dt and dt > 0 else 365.25 def resample_tf(df_1h: pd.DataFrame, rule: str) -> pd.DataFrame: """Resample 1h -> rule (confini 00:00 UTC). Schema con 'datetime'. NB: usare SOLO per-singolo-TF (qui leak-free); MAI ffill/combine mixed-TF su questi timestamp open-labeled (label='left') -> look-ahead. Deploy a >=12h (vedi docstring modulo).""" g = df_1h.copy() idx = pd.to_datetime(g["timestamp"], unit="ms", utc=True) idx.name = "dt" g.index = idx out = g.resample(rule, label="left", closed="left").agg( {"open": "first", "high": "max", "low": "min", "close": "last", "volume": "sum"}) out = out.dropna(subset=["open"]) out["datetime"] = out.index epoch = pd.Timestamp("1970-01-01", tz="UTC") out["timestamp"] = ((out.index - epoch) // pd.Timedelta(milliseconds=1)).astype("int64") return out.reset_index(drop=True)[["timestamp", "open", "high", "low", "close", "volume", "datetime"]] def resample_1d(df_1h: pd.DataFrame) -> pd.DataFrame: """TF canonico di deploy (>=12h). Resample 1h -> 1d.""" return resample_tf(df_1h, "1D") def resample_4h(df_1h: pd.DataFrame) -> pd.DataFrame: """DEPRECATO per il deploy (sotto le 12h: costi+overfit dominano). Retro-compat ricerca.""" return resample_tf(df_1h, "4h")