CashFlow v1.0.0 — Bot di Trading DCA per cTrader

Un bot di trading DCA basato su un'idea semplice: gestisci il flusso di cassa, non prevedere il mercato. Due modalità di recupero ti permettono di scegliere tra aspettare una nuova barra o attivare in base a una distanza fissa della griglia.

🔍 Cosa Fa Questo Bot (In Termini Semplici)

CashFlow apre un primo ordine, aspetta e aggiunge altri ordini quando il prezzo si muove contro di esso. Quando il profitto combinato diventa positivo, chiude tutto e inizia un nuovo ciclo. Questo è il ciclo principale — nessuna previsione di indicatori, nessuna supposizione di tendenza.

Le scelte che fai riguardano quando aggiungere e quanto rischiare.

⚙️ Guida ai Parametri

1. CashFlow (Principale)

• Modalità di Trading — Scegli la direzione: BuyOnly (DCA solo acquisto), SellOnly (solo vendita), o Both (esegue entrambi i lati indipendentemente, ciascuno con la propria memoria).

2. RISCHIO

• Posizioni Massime per Lato — Numero massimo di ordini simultanei per direzione. Quando si raggiunge il limite, il bot chiude l'ordine più vecchio per fare spazio a uno nuovo (rotazione, mantiene il bot attivo invece di bloccarlo).
• Spread Massimo (pips) — Se lo spread supera questo valore, il bot mette in pausa gli ordini. Quando lo spread torna normale, gli ordini pendenti vengono eseguiti immediatamente (controllato ad ogni tick, non ad ogni barra).
• Registra Perdita FIFO — Quando l'ordine più vecchio viene chiuso in perdita per la rotazione, la perdita viene memorizzata e aggiunta all'obiettivo di profitto del ciclo successivo. Questo previene "vittorie false" che lasciano il capitale complessivo inferiore a quello iniziale.
• Mostra Stato Attesa Spread — Mostra uno stato sul grafico quando gli ordini stanno aspettando che lo spread si normalizzi.

3. GESTIONE LOTTI

• Moltiplicatore Martingale — Moltiplicatore del lotto per livello (default 2.0). Impostare a 1.0 disabilita completamente il martingale.
• Dimensione Passo Lotto Martingale — Numero di ordini per livello. Esempio: con passo 10, ordini da 1 a 10 usano il lotto base, ordini da 11 a 20 usano base × moltiplicatore, ordini da 21 a 30 usano base × moltiplicatore², ecc.
• Sempre Apri Recupero (modalità Nuova Barra) — In modalità NewBar, se abilitato, il bot aggiunge un ordine ad ogni nuova barra indipendentemente dalla direzione del prezzo. Se disabilitato, aggiunge solo quando il prezzo si muove contro l'ultimo ordine.

4. RECUPERO (Attivazione Aggiunta Ordine)

Questa è la scelta principale che definisce il carattere del bot.

• Modalità di Recupero
• • NewBar — Aggiunge un ordine all'inizio di una nuova barra se il prezzo si è mosso contro l'ultimo ordine. Dipendente dal timeframe — un grafico giornaliero valuta una volta al giorno.
  • FixGrid — Aggiunge un ordine non appena il prezzo si muove di una distanza fissa dall'ultimo ordine, indipendentemente dalla barra. Indipendente dal timeframe — reagisce al movimento del prezzo in tempo reale.
• Distanza Griglia (Pips) — Usata solo in modalità FixGrid. La distanza che il prezzo deve muovere contro l'ultimo ordine prima che venga aggiunto un nuovo ordine.

5. STRATEGIA

• Lotto Iniziale (Base) — Dimensione del lotto base per il primo ordine di ogni ciclo.
• Lotto Massimo — Limite massimo sulla dimensione del lotto per ordine, indipendentemente da quanto alto salga il livello martingale. Un tetto di sicurezza.

🧠 Le Due Modalità di Recupero — Quando Usare Quale

Modalità NewBar

• Aggiunge ordini all'apertura di una nuova barra quando il prezzo è contro l'ultimo ordine.
• Adatta a timeframe più alti (H4, D1) dove ogni barra porta informazioni significative.
• Ritmo più lento, meno ordini, più adatto alla conservazione del capitale.

Modalità FixGrid

• Aggiunge ordini a distanze fisse di pip, controllate ad ogni tick.
• Indipendente dal timeframe — stesso comportamento su M1 o D1.
• Meglio per simboli volatili (Oro, indici) dove vuoi una spaziatura prevedibile degli ordini.
• Ritmo più veloce, più ordini per movimento, maggiore disciplina della griglia.

Guida pratica: Se sei nuovo, inizia con NewBar su H4 o Daily. Quando ti senti a tuo agio con il comportamento del bot, prova FixGrid con una distanza intorno a 1× l'ATR giornaliero del simbolo.

📊 Come Vengono Gestite le Posizioni

Apertura del primo ordine — Quando non ci sono ordini aperti da quel lato, il bot apre immediatamente il lotto base (una volta che lo spread è accettabile).

Aggiunta di ordini — A seconda della modalità, gli ordini aggiuntivi arrivano a nuove barre (NewBar) o a distanze fisse (FixGrid). La dimensione del lotto segue la formula del livello.

Chiusura — Quando il profitto netto combinato di tutti gli ordini aperti (più eventuali perdite FIFO registrate) diventa positivo all'inizio di una nuova barra, o quando più di una posizione è aperta e il profitto combinato è positivo in qualsiasi momento, tutto si chiude e il ciclo si resetta.

Rotazione — Quando si raggiunge il numero massimo di posizioni e un nuovo ordine è previsto, l'ordine più vecchio viene chiuso per primo per fare spazio. Se Registra Perdita FIFO è abilitato, quella perdita diventa parte dell'obiettivo del ciclo successivo.

🛡️ Sicurezza Integrata

• Filtro spread ad ogni tick — Gli ordini non vengono eseguiti durante momenti di spread ampio (eventi di notizie, aperture di sessione). Una volta che lo spread si normalizza, gli ordini pendenti vengono eseguiti.
• Lotto base fisso — Il moltiplicatore predefinito è 2.0, ma impostandolo a 1.0 il bot diventa un DCA a lotto fisso puro. Controlli il livello di aggressività.
• Tetto massimo lotto — Un limite rigido sulla dimensione del lotto, indipendentemente da quanti livelli martingale si salgono.
• Memoria FIFO — Le perdite dalla rotazione sono tracciate e compensate nell'obiettivo del ciclo successivo, così sai sempre dove ti trovi.

⚠️ Cosa Capire Prima di Usare

• Il DCA comporta rischio di drawdown. In forti tendenze unidirezionali, gli ordini si accumulano. Imposta Posizioni Massime a un livello che il tuo conto può sostenere durante tendenze lunghe.
• Il Martingale aumenta rapidamente il rischio. Con moltiplicatore 2.0 e passo 10, l'ordine 30 usa 4× il lotto base. Comprendi la matematica prima di usare valori superiori a 1.0.
• Fai prima un backtest. Testa sul simbolo e timeframe target attraverso periodi di trend e di range prima di andare live.
• Adatta la dimensione del lotto al conto. Un punto di partenza generale: lotto base ≤ 0.01 per ogni $500 di capitale, aggiustato per la volatilità del simbolo.

Il bot segue le regole senza emozioni — ma le regole funzionano solo se le impostazioni corrispondono alla dimensione del tuo conto e alla tua tolleranza al rischio.

🚀 Avvio Rapido

1. Collega a un grafico del simbolo che vuoi tradare.
2. Imposta Modalità di Trading in base al tuo bias (o Both per due vie).
3. Scegli Modalità di Recupero — inizia con NewBar se non sei sicuro.
4. Imposta Lotto Iniziale in modo conservativo (0.01 è un punto di partenza ragionevole sulla maggior parte dei conti).
5. Imposta Posizioni Massime per Lato in base a quanto drawdown puoi accettare.
6. Fai un backtest su almeno 6 mesi di dati prima di andare live.
7. Inizia su un conto demo finché non capisci come si comporta il bot nelle tue condizioni di mercato.

CashFlow è uno strumento, non una garanzia. Segue le regole in modo coerente, ma il comportamento del mercato determina il risultato. Usa una gestione del rischio appropriata per il tuo conto.