CExecutionSafety - Ping + Execution Latency Guard for MQL5 EAs - libreria per MetaTrader 5

Panoramica

CExecutionSafety è una classe leggera di inclusione MQL5 progettata per proteggere gli Expert Advisor dall'esecuzione di operazioni in condizioni di rete o di esecuzione inadeguate.
Misura due componenti di latenza: il ping del terminale in tempo reale e il ritardo di esecuzione dell'orologio a muro e blocca i tentativi di negoziazione quando il loro valore combinato supera una soglia configurabile.

Il problema che risolve

La maggior parte degli EA esegue alla cieca, indipendentemente dalle condizioni di rete. Un picco di ping o di ritardo di esecuzione sul lato broker durante un ordine critico può causare slittamenti, riquotazioni o mancati riempimenti.
CExecutionSafety introduce un gate di sicurezza pre-trade che impedisce l'esecuzione quando le condizioni sono degradate.

Come funziona

La classe utilizza due fonti di dati:

• TERMINAL_PING_LAST: legge il ping più recente registrato da MetaTerminal (in millisecondi).
• RecordExecDelay(): accetta una misura di wall-clock da avvolgere intorno a qualsiasi operazione di CTrade.

Questi due valori vengono sommati e confrontati con la soglia configurata. Se la latenza combinata supera la soglia, CheckExecutionSafety() restituisce false e stampa una voce di log diagnostica.

Protezione dalla disconnessione

Quando il terminale non ha contatti con il server, TERMINAL_PING_LAST restituisce -1. La classe lo rileva e restituisce automaticamente il messaggio di disconnessione. La classe lo rileva e restituisce automaticamente false, impedendo i tentativi di compravendita su un terminale disconnesso.

Esempio di integrazione

Includete il file e istanziate la classe nel vostro EA:

#include <DeeFX/CExecutionSafety.mqh> CExecutionSafety safety; int OnInit() { safety.Init(150); // soglia combinata di 150ms return INIT_SUCCEED; } void OnTick() { if(!safety.CheckExecutionSafety()) return; ulong t0 = GetTickCount64(); trade.PositionClose(ticket); safety.RecordExecDelay(GetTickCount64() - t0); }

Accessori

I seguenti accessori di sola lettura sono disponibili per la visualizzazione del cruscotto o per la logica esterna:

• GetPingMs(): ping del terminale corrente in ms
• GetExecDelayMs(): ultimo ritardo di esecuzione registrato in ms
• GetCombinedMs(): ping + ritardo di esecuzione combinati (restituisce 9999 se disconnesso)
• HasExecSample(): vero se è stata registrata almeno una misura
• GetThresholdMs(): soglia di sicurezza configurata

Changelog

• v1.0 - Rilascio iniziale
• v1.1 - La macro Guard è stata rinominata. Gli specificatori di formato %I64u sono stati sostituiti con cast (di stringhe).
• v1.2 - Tipo di ritorno di Init() cambiato void → bool. Azzeramento dello stato al riavvio per evitare campioni non aggiornati.