Monitoring

Una premessa importante — e il perimetro dell’integrazione broker. QANTHOS è uno strumento di analisi e monitoraggio, non un consulente finanziario né un sistema di trading automatico. In particolare, l’integrazione con Interactive Brokers (IB/TWS) di questo tab legge soltanto le posizioni aperte per riconciliarle con il portafoglio atteso: non legge mai numeri di conto o saldi, e non invia mai ordini. Avviare ordini, spegnere strategie, correggere size restano azioni che compi tu, sul tuo software di trading.

1. Cosa monitora: il portafoglio live

Monitoring ha una sola sorgente: il portafoglio che hai marcato come live nel Builder. Quando premi Marca come live, QANTHOS congela regole e composizione in uno slot immutabile; Monitoring legge quello, e reagisce automaticamente quando cambia (un nuovo Marca come live, o l’avanzamento a una rotazione operativa successiva). Se nessun portafoglio è marcato live, il tab lo dice chiaramente e resta in attesa.

Da questa composizione live, Monitoring ricava l’elenco delle strategie da sorvegliare, le loro size, i ticker e le classi — e li confronta in continuazione con ciò che osserva nella realtà operativa.

2. Avviare il monitoring

Il monitoring non parte da solo: lo accendi tu. Tre controlli nell’header lo governano:

Perché il monitoring funzioni davvero serve indicargli, nelle impostazioni, la cartella dei report del tuo software di trading (MultiCharts): è da lì che QANTHOS legge i trade chiusi e lo stato delle strategie. Senza quella cartella, la parte di confronto con la realtà resta inattiva.

Avvio = lavoro pesante. Al primo Refresh dopo l’avvio, QANTHOS legge i report da disco: può richiedere qualche secondo. Un dialog di caricamento te lo segnala. È normale.

3. Header e barra contatori

Subito sotto il titolo, una serie di indicatori riassume lo stato del portafoglio live a colpo d’occhio.

Nell’header: la validità della rotazione corrente (◷ data inizio – fine, o “in corso”); il Max Margin — il margine worst-case del portafoglio, calcolato come se tutte le strategie fossero contemporaneamente in posizione (se mancano dati di margine per qualche ticker, l’indicatore lo segnala con ⚠️ e non sottostima in silenzio); l’icona di stato (attivo/non attivo) e l’ora dell’ultimo aggiornamento.

Nella barra contatori: i tre conteggi ● Attive / ● Warning / ● Inattive; l’IB Daily P&L (il P&L giornaliero letto da IB, realizzato + non realizzato, quando connesso); il P&L della rotazione (“Rotazione: $X (N trade)”) — il risultato del portafoglio dall’inizio della rotazione corrente, ricavato dai trade chiusi; e l’indicatore ● MC, che sintetizza con un colore l’allineamento con MultiCharts (vedi §5). L’indicatore MC è cliccabile e mostra nel tooltip il dettaglio dei disallineamenti.

4. La tabella delle strategie

Il cuore del tab è la tabella a sinistra: una riga per ogni strategia del portafoglio live (modello rotazionale, senza distinzione Long/Short). Le colonne:

Due segnalazioni meritano attenzione particolare, perché sono il vero scopo del tab:

Strategia prevista ma assente su MultiCharts. Se una strategia è nel portafoglio live ma non risulta su MultiCharts, la cella St diventa arancione (warning): dovrebbe girare e non lo fa.

Strategia “orfana” (riga rossa). Se su MultiCharts gira una strategia che non è nel portafoglio live, Monitoring aggiunge una riga rossa con la nota “Live su MC, non in portafoglio”. È il caso più delicato: stai tradando qualcosa che il portafoglio corrente non prevede.

Le strategie che il Money Management ha portato a size 0 (allocazione sotto il mezzo contratto) non compaiono in tabella: non fanno parte del portafoglio operativo. Se però girano comunque su MultiCharts, la logica “orfana” le intercetta lo stesso.

5. Allineamento Portfolio ↔ MultiCharts

L’indicatore ● MC nella barra contatori riassume il confronto continuo fra ciò che il portafoglio live prevede e ciò che effettivamente gira su MultiCharts. Cliccandolo (o passandoci sopra) vedi il dettaglio in quattro categorie:

• Allineate — presenti in entrambi e coerenti.
• Mancanti su MC — nel portafoglio ma non attive su MultiCharts.
• Attive non in portafoglio — girano su MC ma non sono nel portafoglio (le “orfane”, da spegnere).
• Autotrading OFF — presenti ma con autotrading disattivato.

Quando lo stato di allineamento cambia, QANTHOS te lo notifica (se le notifiche sono attive), così non devi tenere d’occhio l’indicatore in continuazione. Le strategie “attive non in portafoglio” hanno priorità visiva massima, perché rappresentano esposizione non prevista.

Il confronto si appoggia ai file di stato esportati dal tuo software di trading. Alcune informazioni — come la size rilevata su MultiCharts — richiedono una versione sufficientemente recente del componente di export; se non è disponibile, la colonna Size mostra solo i contratti attesi senza il confronto.

6. IB Reconciliation

Il sotto-tab IB Reconciliation, nella colonna di destra, riconcilia il portafoglio live con le posizioni aperte sul tuo conto Interactive Brokers. Serve a verificare che le posizioni effettivamente in essere corrispondano a quelle attese dalle strategie attive.

Vale qui, ancora più che altrove, il perimetro dichiarato in premessa: l’integrazione legge solo le posizioni aperte (ed eventualmente il P&L giornaliero aggregato che vedi nella barra contatori). Non accede a numeri di conto o saldi, e non invia ordini. È uno strumento di riscontro, non di esecuzione: ti mostra una discrepanza, ma la correzione la fai tu sul tuo software.

La connessione a IB/TWS si configura nelle impostazioni (host, porta, eventuale autoconnessione) — vedi §10.

7. Slippage: la differenza fra teoria e realtà d’esecuzione

Ogni strategia, in QANTHOS come in MultiCharts, ragiona su un prezzo teorico di ingresso: quello che il report della strategia dichiara come entry. Ma il prezzo a cui l’ordine viene davvero eseguito sul broker — il fill reale riportato da Interactive Brokers — quasi sempre è leggermente diverso. Quella differenza si chiama slippage, e Monitoring la traccia automaticamente, fill dopo fill, confrontando ogni esecuzione IB con il prezzo teorico MC corrispondente.

Perché questa è una delle funzionalità più importanti del tab. Tutte le metriche che guidano le tue decisioni — Sharpe, Profit Factor, Min Avg Trade, l’intera suite di analisi anti-overfitting — sono calcolate su prezzi teorici di backtest o di report. Lo slippage è l’unico punto del sistema in cui quel mondo teorico viene confrontato, sistematicamente e con dati reali, con ciò che il broker esegue davvero. Un edge che sembra solido sulla carta può essere eroso — in parte o quasi del tutto — da uno slippage sfavorevole persistente. Senza questo tracking, quell’erosione resterebbe invisibile finché non si manifesta come un semplice “il live rende meno del backtest”, senza nessuna causa identificabile.

7.1 Come nasce un record di slippage

Il tracking scatta automaticamente a ogni fill ricevuto da Interactive Brokers, mentre il monitoring è attivo e IB è connesso. Alcune regole precise governano quando e come:

• Solo sulle aperture di posizione. Lo slippage si misura unicamente quando il fill apre (o incrementa) una posizione nella stessa direzione della strategia MC corrispondente: sulle chiusure non esiste un prezzo teorico di riferimento con cui confrontarsi, quindi non vengono tracciate.
• Solo i fill originati da MultiCharts. Un ordine piazzato manualmente dalla finestra di TWS (per esempio un aggiustamento manuale di posizione) ha un prezzo arbitrario che falserebbe le statistiche: questi fill vengono riconosciuti ed esclusi automaticamente.
• Attribuzione fill → strategia a tre livelli di certezza. Quando più strategie operano sullo stesso simbolo, QANTHOS deve capire a quale attribuire il fill. Lo fa in ordine di affidabilità: (1) certo, se l’identificativo d’ordine passato da MultiCharts corrisponde in modo univoco a una strategia candidata; (2) certo per esclusione, se esiste un solo candidato possibile sullo stesso simbolo e nella stessa direzione; (3) probabile, quando restano più candidati e l’identificativo non basta a decidere — in quel caso si sceglie la strategia il cui prezzo teorico è più vicino al prezzo del fill, e l’attribuzione viene registrata come “probabile” nei log, mai spacciata per certa.
• Il valore del punto viene dal tab Strumenti. Per convertire la differenza di prezzo in dollari, QANTHOS usa il point value del contratto effettivamente tradato (il campo Traded On della scheda strumento). Se quel dato manca o non è valido, lo slippage di quel fill non viene registrato — e un avviso lo segnala nel pannello — piuttosto che calcolare un numero su una base sconosciuta.

Il segno segue la logica intuitiva del trader: per un acquisto, è sfavorevole se il fill IB avviene a un prezzo più alto di quello teorico (hai pagato di più); per una vendita, è sfavorevole se il fill avviene a un prezzo più basso (hai incassato di meno). Il caso opposto è slippage favorevole — capita, ed è altrettanto tracciato.

7.2 Il pannello compatto e il dialog completo

Nel riquadro IB Reconciliation, sotto le due tabelle di posizioni MC/IB, una fascia dedicata mostra tre numeri di sintesi aggiornati in tempo reale: il numero di trade tracciati, la media dello slippage in punti (colorata in verde se in media favorevole, in rosso se sfavorevole) e il totale in dollari accumulato. In fondo a questa fascia, in basso a destra del riquadro, il pulsante a icona (grafico a barre) apre il dialog Storico Slippage completo.

Il dialog si apre come finestra non modale (puoi tenerla aperta mentre lavori altrove) e offre due filtri in alto: Simbolo (tutti, o uno specifico) e Periodo (ultimi 7, 30, 90 giorni, o tutto lo storico). Sotto i filtri, un pannello di cinque statistiche riassume il periodo selezionato: trade totali, media slippage in punti, totale slippage in dollari, percentuale favorevole e massimo sfavorevole registrato.

7.3 Le quattro viste: Dettaglio e le tre aggregazioni

Il corpo del dialog è organizzato in quattro sotto-tab:

Le tre viste aggregate condividono le stesse colonne — N trade, media pt, media $, slippage $/contratto, totale $, % favorevoli, max sfavorevole pt — e sono ordinate per Totale $ crescente: i gruppi più costosi (i più negativi) compaiono in cima, così i problemi più seri saltano subito all’occhio.

La colonna “slippage $/contratto” è la lente giusta per confrontare strumenti diversi. Il totale in dollari dipende anche da quanti contratti hai tradato: uno strumento con molte più esecuzioni sembrerà sempre “più costoso” in totale. Normalizzando per contratto ottieni un confronto onesto fra ticker e strategie con volumi molto diversi — esattamente ciò che serve per capire dove lo slippage sta davvero mordendo il tuo edge.

7.4 Storico persistente, export e import

Lo storico è persistente: sopravvive alla chiusura e riapertura di QANTHOS (fino alle 1000 registrazioni più recenti salvate su disco). Dalla barra in alto del dialog puoi:

• Esportare in Excel (.xlsx a 4 fogli: Dettaglio + le tre aggregazioni), utile per archiviare periodicamente lo storico o analizzarlo altrove;
• Importare un file esportato in precedenza, in modalità Unisci (aggiunge solo i record non già presenti, con deduplica automatica) o Sostituisci (rimpiazza tutto, con conferma esplicita);
• Cancellare lo storico — azione distruttiva, richiede conferma.

7.5 Perché vale la pena guardarlo con regolarità

Lo slippage tracking si collega direttamente a due leve che hai già incontrato altrove in QANTHOS, e vale la pena tenerle a mente insieme:

• Min Avg Trade (tab Strumenti). Quella soglia stabilisce quanto deve guadagnare in media un’operazione perché valga la pena tradarla. Se lo slippage medio per contratto su un ticker si mangia una parte sostanziale di quel margine, la soglia che avevi impostato è più ottimistica della realtà — e questo pannello è il modo per accorgersene con numeri, non a sensazione.
• Safety Margin (Money Management). Il moltiplicatore prudenziale applicato alla stima del worst trade esiste anche per assorbire imprevisti come uno slippage sistematico. Uno storico che mostra uno slippage sfavorevole persistente su un ticker è un argomento concreto per tenere quel margine più alto — o per rivedere come e quando quella strategia viene eseguita.

Controllarlo periodicamente — non solo quando qualcosa sembra andare storto — è ciò che permette di intercettare per tempo un problema di esecuzione prima che eroda in silenzio mesi di edge reale.

8. Eventi macro

Monitoring integra un monitoraggio degli eventi macroeconomici del giorno e del loro impatto storico sulle strategie del portafoglio. Lo trovi in due forme:

• Un mini-riepilogo in alto (icona calendario): quanti eventi avversi e favorevoli oggi, e il prossimo evento critico.
• Il pannello completo nel sotto-tab Macro Events, con il dettaglio per evento e per strategia.
• La colonna Macro della tabella, che marca con un pallino le strategie toccate oggi (rosso/verde/arancione) e ne descrive l’impatto nel tooltip (quanti trade storici su quegli eventi, win rate, scostamento).

L’idea è darti un contesto: se un dato macro importante è imminente e tocca strategie che storicamente ne soffrono, lo sai prima, non dopo.

9. Esposizione e alert del giorno

La fascia inferiore del tab affianca due pannelli:

• Alert di oggi — un riepilogo degli alert attivi (a partire da quelli macro), normalizzati per severità.
• Esposizione — due grafici a torta che mostrano la composizione del portafoglio live per ticker e per asset class. È la lettura immediata di dove è concentrata l’esposizione lorda.

10. Notifiche e Telegram

Monitoring può avvisarti in tempo reale, sul PC e su Telegram. Le notifiche coprono, fra le altre, l’attivazione/disattivazione di una strategia, i disallineamenti col portafoglio, il raggiungimento di stop o take-profit giornalieri, i rollover, i nuovi trade e quelli chiusi, l’apertura/chiusura delle sessioni di mercato (CME/NYMEX). Gli alert critici non sono silenziabili. Ogni tipo si attiva o disattiva nelle impostazioni.

Su Telegram, oltre alle notifiche, è disponibile un bot con comandi (per esempio per chiedere P&L e stato del portafoglio) e un assistente in linguaggio naturale: prima di rispondere, l’assistente rilegge lo stato attuale del portafoglio live, così le risposte sono aggiornate al momento — utile quando sei lontano dal PC. Un’agenda macro può inviarti un briefing mattutino e avvisi pre-evento.

Per il P&L giornaliero, lo stop/TP e le posizioni, le funzioni Telegram leggono i dati già presenti nel tab (IB per il P&L, i report per i trade): nessuna di queste funzioni invia ordini.

Stop e TP giornalieri. Se imposti soglie di stop o take-profit giornaliero, Monitoring ti avvisa quando il P&L vi si avvicina (warning) e quando le raggiunge (trigger). Restano avvisi: la decisione operativa è tua.

11. Impostazioni

Il pulsante Settings apre un dialog con sezioni dedicate:

• Generale / Log — cartella dei report MultiCharts, intervalli di aggiornamento, soglie di stato, e il log della sessione.
• Interactive Brokers — host, porta e autoconnessione di IB/TWS.
• Telegram — token e chat, abilitazione, orari di briefing e finestra pre-evento.

Le impostazioni sono persistenti fra le sessioni. Le annotazioni della colonna Note vengono anch’esse salvate.

12. Errori comuni e note

Il tab dice “nessun portafoglio live”. Monitoring sorveglia solo il portafoglio marcato come live. Vai nel Builder, costruisci/seleziona il portafoglio operativo e premi Marca come live.

La colonna MC è tutta grigia / non vedo le size di MultiCharts. Manca la cartella dei report nelle impostazioni, oppure il componente di export del software di trading non è abbastanza recente per fornire lo stato (e la size). Configura la cartella e verifica l’export.

Una riga è rossa: “Live su MC, non in portafoglio”. Su MultiCharts gira una strategia che il portafoglio live non prevede: esposizione non prevista da gestire sul tuo software.

La size è rossa. I contratti su MultiCharts non coincidono con quelli assegnati da QANTHOS: il tooltip mostra entrambi e la differenza.

Max Margin con ⚠️. Mancano i dati di margine per uno o più ticker (non presenti nel database strumenti): il valore mostrato è una sottostima, non un dato completo. Completa i dati nel tab Strumenti.

IB non si connette. Verifica host/porta nelle impostazioni e che TWS/IB Gateway sia in ascolto. Ricorda: l’integrazione legge solo le posizioni aperte, non invia ordini.

Un fill non compare nello storico slippage. Può essere una chiusura di posizione (non tracciata, manca il prezzo teorico di riferimento), un ordine piazzato manualmente in TWS (escluso di proposito), oppure un point value mancante o non valido per quel ticker nel tab Strumenti — in quest’ultimo caso il pannello mostra un avviso esplicito.

Lo slippage medio è costantemente sfavorevole su un ticker. Vale la pena incrociarlo con il Min Avg Trade di quel ticker (tab Strumenti): se lo slippage per contratto ne assorbe una quota rilevante, la soglia di tradabilità impostata potrebbe essere più ottimistica della realtà operativa.

13. Un esempio di flusso operativo

Un percorso tipico, non una prescrizione.

1. Nel Builder, marca come live il portafoglio operativo.
2. In Monitoring, apri Settings e indica la cartella dei report (ed eventualmente IB e Telegram).
3. Premi Avvia.
4. Controlla i contatori e l’indicatore ● MC: tutte le strategie del portafoglio dovrebbero risultare allineate.
5. Scorri la tabella: nessuna riga rossa (orfane) e nessuna St arancione (mancanti su MC); le Size verdi.
6. Tieni d’occhio il P&L di rotazione e gli alert macro del giorno; usa le Note per annotare.
7. Controlla con regolarità lo storico slippage dal riquadro IB Reconciliation: individua ticker o strategie dove l’esecuzione reale si discosta sistematicamente dal prezzo teorico.
8. Lascia attive le notifiche (e Telegram, se vuoi essere avvisato lontano dal PC) e interveni sul tuo software di trading quando Monitoring segnala un disallineamento.

Monitoring rende visibile lo scarto fra il piano e la realtà. Non agisce al posto tuo: ti mette davanti agli occhi ciò che serve per agire con cognizione, lasciando ogni operazione sul broker sotto il tuo controllo.

14. Per approfondire

• Portafoglio live — come si marca un portafoglio come live: la sorgente unica di questo tab.
• Strumenti — ticker, sessioni, fattori di riscalatura, dati di margine e point value (usato per convertire lo slippage in dollari) usati qui.
• Money Management — le size che la tabella confronta con MultiCharts.
• Equity — il risultato storico del portafoglio che stai monitorando.