01Architettura

Il bot gira in locale sul tuo PC (porta 9100 per dashboard e MT5, porta 80 per MT4) e parla con i terminali via HTTP: ogni EA interroga il bot ogni secondo per ricevere ordini, comandi e conferme.

02Ciclo di vita di un segnale

03Conti e impostazioni (pagina Conti)

Ogni conto è indipendente: puoi decidere per ciascuno cosa riceve, con che lotti e con quale comportamento. Apri l'editor con il pulsante ⚙️ Editor.

Impostazione	Cosa fa	Come funziona
Abilitato	Accende/spegne l'intero conto	Se disattivato, l'EA del conto non riceve né segnali né copie né comandi. Utile per mettere in pausa un conto senza toccare gli altri.
Riceve segnali	Esegue i segnali Telegram	Il bot consegna il segnale corrente all'EA di questo conto, che apre l'ordine. Attivo per Axi e Equiti.
Riceve copie	Replica i trade del VPS	Quando il terminale VPS apre/modifica/chiude un trade, il bot invia un ordine identico a questo conto. Attivo solo per Equiti (vedi sezione 4).
Moltiplicatore lotto	Scala il lotto dei segnali	Es. segnale da 0.10 lotti con moltiplicatore 2 → apre 0.20. Le copie dei trade del VPS usano il volume originale.
Breakeven	Protegge il profitto	Quando il prezzo va a favore, l'EA sposta lo SL a entrata (no-loss) automaticamente.
Suffisso simboli	Adegua i nomi dei simboli	Se il broker usa suffissi (es. .pro), il suffisso viene aggiunto al nome del simbolo prima di aprire l'ordine.
Override lotti per simbolo	Lotto specifico per quel conto	Es. XAUUSD → 0.05 su questo conto, ignorando il lotto globale (vedi sezione 7).
Override mapping simboli	Mapping solo per quel conto	Precede il mapping globale: se il conto usa nomi diversi dal resto, lo definisci qui.

04Copy trading — "Riceve copie" in dettaglio

A cosa serve: replicare in automatico su conti che NON stanno su questa VPS ma su altre VPS le operazioni fatte qui. Su quelle VPS serve solo ESEGUE_SEGNALI attaccato al grafico (con WebRequest verso questo bot e stessi magic/poll): niente exporter, niente bot, niente Telegram. È il modo per avere la stessa esposizione ovunque senza gestire più piattaforme.

05Decisioni in attesa

Quando il bot rileva un caso che richiede una scelta (es. un messaggio che suggerisce di chiudere o spostare lo SL), crea una decisione e la mostra qui e nella dashboard. Le risposte possibili:

Risposta	Effetto
Chiudi ora	Il bot emette un comando di chiusura per tutte le posizioni su quel simbolo (su tutti i conti).
SL a entrata	Il bot sposta lo SL a entrata (breakeven) sulle posizioni aperte di quel simbolo.
Lascia correre	Nessuna azione: la posizione continua con SL/TP originali.

Ogni decisione risolta resta visibile nella tabella "Storico decisioni" con risposta e orari.

06Comandi EA

Comando	Cosa fa	Attenzione
Force close	Chiude tutte le posizioni su un simbolo specifico (es. XAUUSD) su tutti i conti.	Serve un simbolo valido; il campo ha l'elenco dei simboli conosciuti.
Chiudi tutto	Chiude tutte le posizioni su tutti i conti, oppure su un singolo conto (pulsanti per login).	Richiede conferma esplicita.
Slippage massimo	Definisce in punti lo scostamento massimo accettato all'apertura.	Se il mercato slitta oltre, l'ordine non viene aperto (stato failed).

La tabella "Comandi inviati agli EA" mostra la coda: ogni comando nasce pending, l'EA lo preleva e conferma con ack, poi done a esecuzione avvenuta.

Sopra i comandi trovi lo Stato EA live: per ogni conto mostra versione EA, balance, equity, posizioni e l'ultimo ping (aggiornato ogni secondo). Il punto verde indica che l'EA è online.

07Simboli & lotti

Lotti per simbolo (globali): se definisci un lotto per un simbolo, vale per tutti i conti che non hanno un override. Es. XAUUSD → 0.10.

Mapping broker (globali): converte il nome del simbolo come scritto dal provider in quello accettato dal broker. Es. XAUUSD → XAUUSD.pro, USOIL → WTI.

Controllo rischio (max perdita per trade): se attivo, il bot calcola la perdita stimata = distanza SL × € per 1.0 lotto per 1.0 di prezzo × lotti. Se supera il max perdita € del simbolo, riduce il lotto (arrotondato in giù al passo del lotto minimo); se anche il lotto minimo eccede il limite, avvicina lo SL all'entrata per rispettarlo. Es. XAUUSD (100 € per 1.0 lotto per 1.0 di prezzo), SL a 20 € di distanza, max 10 € → lotto 0.005 → sotto il minimo 0.01 → lotto 0.01 e SL a 10 €. I valori si impostano nella pagina Simboli.

Breakeven smart: il profitto NON è limitato: la soglia di attivazione (default 2 €) indica solo quando il BE parte. Da lì l'EA blocca il 70% del profitto massimo raggiunto (95% se il prezzo stalla da 10 minuti) spostando lo SL sempre più su, con protezione minima garantita di 1 € — quindi una volta attivo il trade non può più andare in perdita e il profitto può crescere all'infinito. Il TP del segnale resta attivo e chiude la vincita. Parametri per conto in Conti → Editor, applicati al segnale successivo senza ricompilare l'EA.

08Telegram

Funzione	Cosa fa
Stato connessione	Mostra se il client Telegram è connesso, con quale account, quanti gruppi sono monitorati e quanti client live (SSE) sono collegati alla dashboard.
Aggiungi gruppo	Aggiunge un gruppo al monitoraggio inserendo link invito, @username o ID numerico. Funziona a runtime: nessun riavvio del bot.
Rimuovi gruppo	Toglie un gruppo dal monitoraggio (pulsante cestino). Anche questo immediato.
Test notifiche	Invia un messaggio di prova a DM, Saved Messages e gruppo notifiche per verificare che le notifiche funzionino.
Invia messaggio	Invia un messaggio arbitrario a un gruppo o utente usando l'account del bot.

09Storico & statistiche

Lo storico registra ogni segnale ed evento con i suoi stati. Clicca su una riga per il dettaglio completo (ID e ticket cliccabili per copiarli, testo originale incluso).

Stato	Significato
pending	Segnale ricevuto e registrato, in attesa di esecuzione da parte degli EA.
executing	L'EA ha prelevato il segnale e sta aprendo l'ordine.
executed	Ordine aperto; ticket dell'operazione registrato.
failed	Apertura fallita (es. slippage superato, simbolo non disponibile, risorse insufficienti).
sl_hit	Stop loss colpito: posizione chiusa in perdita.
tp_hit	Take profit colpito: posizione chiusa in profitto.
closed	Posizione chiusa manualmente o per comando.

I filtri (testo, stato, direzione) aiutano a trovare i record; CSV esporta tutto lo storico in un file con valori separati da virgola, utile per Excel. Le statistiche calcolano win rate (TP vs SL), performance per simbolo e per direzione, e i totali per stato.

10Sistema e porte

Elemento	Spiegazione
Pausa bot	Congela l'elaborazione dei segnali: il bot continua a girare ma non consegna più segnali/copie ai conti. Riavvialo per riprendere.
Client SSE	Numero di dashboard aperte collegate in tempo reale (il bot le aggiorna via SSE a ogni evento: nuovo segnale, ack, SL/TP, decisioni, comandi).
Porta 9100	Dashboard, API e polling degli EA MT5. Accessibile da telefono nella stessa rete WiFi con l'IP mostrato nei log.
Porta 80	Polling degli EA MT4: MQL4 WebRequest accetta solo le porte 80/443, per questo il bot ascolta anche sulla porta 80.
Whitelist MT4	La lista URL in Tools → Options → Expert Advisors deve contenere http://127.0.0.1: non modificarla, altrimenti l'EA MT4 smette di comunicare.

11FAQ

Perché MT4 usa la porta 80 e non una porta custom?

La funzione WebRequest di MQL4 accetta solo le porte 80 (http) e 443 (https). MT5 non ha questo limite, quindi usa la porta 9100. Il bot ascolta su entrambe: una per MT4, una per tutto il resto.

Un segnale è arrivato ma non vedo l'ordine aperto. Perché?

Controlla nell'ordine: 1) il bot è Online (non in pausa); 2) il conto ha "Abilitato" e "Riceve segnali" attivi; 3) l'EA del terminale è online (Stato EA live, punto verde); 4) il segnale non è scaduto (TTL 180 secondi: se l'EA era offline, il segnale è stato perso apposta per evitare esecuzioni ritardate); 5) lo slippage configurato non è stato superato (in tal caso lo stato è failed).

Come faccio a evitare doppioni se il provider rimanda lo stesso segnale?

Il sistema è progettato per questo: ogni segnale viene servito una sola volta per conto (serve-once), il segnale corrente si azzera solo quando tutti i conti confermano (ack) o scade il TTL, e il copy-trading esclude i magic dell'executer (770077) per non riesportare ciò che è già stato eseguito dai segnali.

Cosa succede se l'EA è offline quando arriva un segnale?

Il segnale resta disponibile fino al TTL di 180 secondi. Se nessun EA lo preleva in tempo, scade e non viene più eseguito: è voluto, per evitare di aprire ordini "vecchi" quando il mercato è già cambiato. Lo stato resta pending nello storico.

Il broker usa simboli diversi da quelli del provider (es. XAUUSD.pro). Cosa devo fare?

Vai su Simboli & Lotti → Mapping broker e aggiungi la coppia (es. XAUUSD → XAUUSD.pro). Se serve solo per un conto, usa l'override nel modal Editor di quel conto: ha priorità sul mapping globale.

Voglio un conto che faccia solo copie (nessun segnale Telegram). È possibile?

Sì: nell'Editor metti "Riceve segnali" OFF e "Riceve copie" ON. Il conto diventa "Sorgente copie" e riceverà solo i trade esportati dal VPS.

Come cambio i lotti di un segnale senza toccare il codice?

Tre livelli: moltiplicatore nel conto (scala tutto), override per simbolo nel conto, o lotto globale per simbolo in Simboli & Lotti. L'ordine di precedenza è: override conto → globale → lotto del segnale → default.

I pulsanti "Chiudi tutto" e "Force close" a cosa servono esattamente?

Force close chiude le posizioni di un solo simbolo su tutti i conti (utile quando un segnale è chiaramente finito in errore). Chiudi tutto chiude tutte le posizioni: su tutti i conti o su un conto specifico. Entrambi richiedono conferma e generano comandi tracciati nella pagina Comandi EA.

La dashboard non si aggiorna da sola. Cosa controllo?

La dashboard si aggiorna da sola via SSE (eventi live) e con un refresh automatico ogni 6 secondi. Se non si aggiorna, ricarica la pagina (F5); se il problema persiste, controlla la pagina Log per errori del bot e che il servizio sia attivo sulle porte 9100/80.

Come aggiungo un nuovo gruppo di segnali?

Pagina Telegram → "Aggiungi gruppo al monitoraggio": incolla il link invito (t.me/+) o l'username o l'ID, premi Aggiungi. Il gruppo viene monitorato subito, senza riavviare il bot. Per rimuoverlo: cestino accanto al gruppo.