PineForge backtesta Pine Script senza TradingView, offline in un’unica immagine Docker: stessi dati, stessi trade.
Perché offline?
Il backtest nel browser è ottimo per iterare sul grafico. Il backtest offline, invece, è quello a cui ricorri quando il passo successivo è mettere soldi sulla strategia: quando ti serve un audit trail, quando ogni commit deve superare i controlli in CI, quando un risultato di due mesi fa deve riprodursi oggi, trade per trade.
Eseguire i backtest offline ti dà ciò che i tester in browser non possono dare: i risultati sono deterministico: stesso script, stessi dati e stessa versione dell’immagine danno gli stessi trade. Fissi la versione dell’immagine, fai il commit dei report in un repository, confronti le liste di trade tra un commit e l’altro ed esegui tutto in modalità headless in CI. Il CSV in ingresso è tuo, l’engine gira in locale e il report registra un’impronta di ciò che l’ha prodotto.
In pratica: versioni dell'immagine fissate, così un commit di due mesi fa dà oggi la stessa lista di trade; i tuoi dati, dalle candele di un exchange alle barre che costruisci tu a partire dai tick, purché siano OHLCV; controlli in CI che fanno fallire la build in caso di regressione; e una strategia che è un file, non legata a una piattaforma.
Se hai mai dovuto condividere un risultato di backtest con un collega e ti sei reso conto che l’unico modo per «condividerlo» era uno screenshot del chart, quello che ti manca è l’esecuzione offline.
Come fare il backtest di Pine Script offline
PineForge transpila PineScript v6 in C++ nativo e lo esegue sulla tua macchina in un'unica immagine Docker.
Tre passi. L’immagine si scarica una volta sola; da lì in poi, tutto gira offline.
Passo 1: scarica il runtime
Un'unica immagine, ghcr.io/pineforge-4pass/pineforge-release. Niente pip, nessuna chiave, nessuna registrazione: transpile, compilazione e backtest girano tutti al suo interno, offline. L'engine contenuto nell'immagine è Apache-2.0; il transpiler incluso è gratuito per il trading personale.
Passo 2: transpila il tuo Pine in C++
Esegui l'immagine in modalità solo transpile: trasformerà il tuo PineScript v6 in un file sorgente C++ completo, in locale. Durante il backtest non gira nessun interprete Pine: l'immagine compila il C++ in codice nativo.
docker run --rm --network=none \
-e PINEFORGE_TRANSPILE_ONLY=1 \
-v "$(pwd)/my_strategy.pine":/in/strategy.pine:ro \
ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > strategy.cppPasso 3: esegui il backtest
Monta il tuo CSV OHLCV accanto al C++ generato ed esegui l'immagine. Il CSV deve avere l'intestazione timestamp,open,high,low,close,volume, con i timestamp in millisecondi UNIX. L'engine esegue la strategia barra per barra e scrive un report JSON su stdout. Puoi anche saltare il passo 2: monta invece strategy.pine e l'immagine lo transpila prima.
docker run --rm --network=none \
-v "$(pwd)/strategy.cpp":/in/strategy.cpp:ro \
-v "$(pwd)/ohlcv.csv":/in/ohlcv.csv:ro \
ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > report.jsonIl report JSON contiene un blocco di riepilogo (numero totale di trade, trade vincenti e perdenti, percentuale di trade vincenti, P&L netto, max drawdown), la lista completa dei trade (orari di entrata e di uscita, prezzi, quantità, P&L e indici di barra), metriche come fattore di profitto, Sharpe e Sortino, la curva di equity e un'impronta di engine, transpiler, input e dati alla base dell'esecuzione (null se non è stato possibile calcolarla).
Questo è l'intero workflow. Niente GUI, nessuna ri-autenticazione di account, nessun caricamento di chart. Se sai far girare Docker, sai far girare i backtest PineForge offline.
Cosa puoi backtestare
La risposta breve: qualunque cosa tu possa serializzare come OHLCV. PineForge non è connesso a nessun fornitore di market data. I dati li porti tu; l'engine esegue la strategia.
- Crypto dal tuo exchange. Scarica i trade raw da Binance, Bybit, Kraken o qualunque exchange con API REST o WebSocket. Aggrega al timeframe usato dalla tua strategia. Dai in pasto direttamente il CSV. Testa sull'esatta combinazione coppia-and-venue su cui tradderai.
- Barre costruite dai tick. Se costruisci le barre da dati tick o di order book, passale come OHLCV. All'engine non importa da dove arrivino le barre.
- Altre serie. L'engine legge solo timestamp, open, high, low, close e volume; le colonne in più vengono ignorate. Puoi usare nel backtest un punteggio di sentiment o una metrica on-chain solo se li codifichi in quelle colonne.
Le strategie della galleria, 312 in tutto, vengono dal corpus aperto, ciascuna valutata rispetto all’export originale di TradingView. Sul main dell’engine, il controllo del corpus ne fissa 311 a eccellente: stesso numero di trade, prezzi entro 0,01% e P&L entro 1% al 90° percentile, con limiti più ampi su prezzo di uscita e P&L per le strategie le cui uscite trail_* sono valutate con il profilo di produzione (7). La restante è un’anomalia dichiarata. Per il livello eccellente, quando TradingView mostra due o più Signals di entrata distinti nello stesso istante esatto, allo stesso prezzo e nella stessa direzione, l’engine mostra altrettante entrate distinte in quel punto (identità delle entrate distinte).