GW News Filter

Merkmale

Funktioniert in echten Konten, Demos und im Strategietester

Wählen Sie zwischen:

• 0 = Auto (API für Live/Demo, CSV für Strategy Tester)
• 1 = API (MetaTrader's eingebauter Kalender)
• 2 = CSV (Dateien pro Währung, z. B. EUR.csv, USD.csv, ALL.csv)

Konfigurieren Sie:

• Minimale Wichtigkeit (Niedrig, Mäßig, Hoch)
• Fenster Sekunden vor/nach Nachrichten
• Globale "ALL"-Ereignisse einbeziehen
• Getrennte Flags für das Filtern von Einträgen und das Filtern von Ausgängen
• Leichte Wrapper-Klasse für einfache Integration
• Diagnoseprotokollierung (Stufen 0-4) zum Testen und Debuggen

CSV Preparation Guide

Jede Zeile in der CSV-Datei muss die folgenden 16 Spalten enthalten, und zwar genau in dieser Reihenfolge:

1. VALUE_ID → Eindeutige numerische ID für den Wert (verwenden Sie eine beliebige Ganzzahl, z. B. "10001")
2. EVENT_ID → Eindeutige numerische ID für das Ereignis (z. B. "20001")
3. TIME → Uhrzeit des Ereignisses im Format `YYYY.MM.DD HH:MM:SS`.
4. PERIOD → Zeichenfolge für den Zeitraum (kann leer gelassen werden, wenn nicht verwendet)
5. REVISION → Ganzzahlige Revisionsnummer (normalerweise `0`)
6. ACTUAL → Tatsächlicher gemeldeter Wert (leer lassen, wenn unbekannt)
7. PREVIOUS → Vorheriger gemeldeter Wert (leer lassen, wenn unbekannt)
8. REVISED_PREV → Revidierter vorheriger Wert (leer lassen, wenn unbekannt)
9. FORECAST → Prognostizierter Wert (leer lassen, falls unbekannt)
10. IMPACT_TYPE → Ganzzahl (0=keine, 1=positiv, 2=negativ, 3=neutral). Kann `0` sein, wenn nicht benötigt.
11. CURRENCY → Währungscode (`USD`, `EUR`, `JPY`, ... oder `ALL`)
12. COUNTRY_CODE → Länderkürzel (`US`, `EU`, `GB`, ...)
13. COUNTRY_ID → Numerische ID (kann `0` sein, wenn nicht relevant)
14. IMPORTANCE → `LOW`, `MODERATE`, oder `HIGH`
15. EVENT_CODE → Kurzer maschinenfreundlicher Bezeichner (`cpi`, `gdp`, `trade-balance`)
16. NAME → Menschenfreundlicher Ereignisname

//+------------------------------------------------------------------+ 
//|GWNewsFilterLib.mqh |
//| Öffentlicher Wrapper für GWNewsFilterLib.ex5 binär |
//| (c) GreaterWaves - José Martínez Hernández |
//+------------------------------------------------------------------+
//
// BEDIENUNGSHINWEISE
// 1) Kopieren Sie diese Datei nach: MQL5/Include/Greaterwaves/GWNewsFilterLib.mqh
// 2) Kopieren Sie die Binärdatei nach: MQL5/Bibliotheken/GWNewsFilterLib.ex5
// 3) In Ihrem EA/Indikator:
// #include <Greaterwaves/GWNewsFilterLib.mqh>
//
// Beispiel:
//
// GWNewsFilter nf;
// if(nf.Create(_Symbol, true, false,
// 2, // minImportance (0=Keine,1=Gering,2=Mäßig,3=Hoch)
// wahr, // includeGlobalAll
// 900,900,// SekundenVor/Nach
// 3, // diagnosticLevel (0-4)
// 0)) // forcedSource (0=Auto,1=CSV,2=API)
// {
// nf.SetCsvLocation("NEWS", true); // Optionaler benutzerdefinierter CSV-Pfad
// nf.RebuildWindow();
// if(nf.IsFilteringNow(true,false))
// Print("Filter bei Eingabe aktiv");
// nf.UpdateChartCommentMinimal();
// }
//

// ===============================================================
// IMPORTS aus der Binärbibliothek
// ===============================================================
#import "GWNewsFilterLib.ex5"
   int  GWFilter_Create(string symbol,
                       bool filterEntry,
                       bool filterExit,
                       int  minImportance,
                       bool includeGlobalAll,
                       int  secondsBefore,
                       int  secondsAfter,
                       int  diagnosticLevel,
                       int  forcedSource);

   bool GWFilter_Destroy(int handle);
   bool GWFilter_RebuildWindow(int handle);
   bool GWFilter_IsBlockingNow(int handle, bool forEntry, bool forExit);
   int  GWFilter_GetBlockingEventsCount(int handle);
   int  GWFilter_TotalInWindow(int handle);

   bool GWFilter_GetWindowEventAt(int handle, int index,
                              long &value_id, long &event_id, datetime &time,
                              string &currency, string &country_code,
                              string &event_code, string &name, int &importance);

   bool GWFilter_SetDiagnosticLevel(int handle, int level);
   bool GWFilter_SetForcedSource  (int handle, int forcedSource);
   bool GWFilter_SetBlockFlags    (int handle, bool filterEntry, bool filterExit);

   bool GWFilter_BuildBlockingComment(int handle, string &out_comment);
   bool GWFilter_UpdateChartCommentMinimal(int handle);

   bool GWFilter_SetCsvLocation(int handle, string baseRel, bool useCommon);
#import

// ===============================================================
// Objektorientierter Wrapper zur einfacheren Verwendung in EAs/Indikatoren
// ===============================================================
class GWNewsFilter
{
private:
   int m_h; // Interner Handle zum Binärobjekt

public:
   GWNewsFilter(): m_h(0) {}

   // Instanz mit Einstellungen erstellen
   bool Create(string symbol,
               bool filterEntry, bool filterExit,
               int   minImportance   = 2,
               bool  includeGlobalAll= true,
               int   secondsBefore   = 900,
               int   secondsAfter    = 900,
               int   diagnosticLevel = 2,
               int   forcedSource    = 0)
   {
      m_h = GWFilter_Create(symbol, filterEntry, filterExit, minImportance,
                        includeGlobalAll, secondsBefore, secondsAfter,
                        diagnosticLevel, forcedSource);
      return (m_h > 0);
   }

   // Instanz zerstören
   bool Destroy() { if(m_h<=0) return false; bool ok=GWFilter_Destroy(m_h); m_h=0; return ok; }

   // Fenster mit anstehenden Ereignissen aktualisieren
   bool RebuildWindow() { return (m_h>0 ? GWFilter_RebuildWindow(m_h) : false); }

   // Prüfen, ob der Filter jetzt aktiv ist (Eintritt/Austritt)
   bool IsFilteringNow(bool forEntry, bool forExit) { return (m_h>0 ? GWFilter_IsBlockingNow(m_h, forEntry, forExit) : false); }

   // Anzahl der derzeit aktiven Filterereignisse
   int  GetFilteringEventsCount(){ return (m_h>0 ? GWFilter_GetBlockingEventsCount(m_h) : -1); }

   // Gesamtzahl der Ereignisse im aktuellen Fenster
   int  TotalInWindow()          { return (m_h>0 ? GWFilter_TotalInWindow(m_h) : -1); }

   // Abrufen von Details zu einem Ereignis bei index
   bool GetWindowEventAt(int index,
                         long &value_id, long &event_id, datetime &time,
                         string &currency, string &country_code,
                         string &event_code, string &name, int &importance)
   {
      return (m_h>0 ? GWFilter_GetWindowEventAt(m_h, index, value_id, event_id, time,
                                            currency, country_code, event_code, name, importance)
                    : false);
   }

   // Ändern der Diagnoseprotokollebene
   bool SetDiagnosticLevel(int level){ return (m_h>0 ? GWFilter_SetDiagnosticLevel(m_h, level) : false); }

   // Datenquelle erzwingen (Auto, CSV, API)
   bool SetForcedSource  (int forced){ return (m_h>0 ? GWFilter_SetForcedSource  (m_h, forced) : false); }

   // Aktivieren/Deaktivieren der Filterung für die Einreise/Ausreise
   bool SetFilterFlags    (bool fe, bool fx){ return (m_h>0 ? GWFilter_SetBlockFlags(m_h, fe, fx) : false); }

   // Erstellen einer minimalen Kommentarzeichenkette, wenn der Filter aktiv ist
   bool BuildFilteringComment(string &out_comment){ out_comment=""; return (m_h>0 ? GWFilter_BuildBlockingComment(m_h, out_comment) : false); }

   // Diagrammkommentar automatisch aktualisieren (nur wenn aktiv)
   bool UpdateChartCommentMinimal(){ return (m_h>0 ? GWFilter_UpdateChartCommentMinimal(m_h) : false); }

   // Speicherort des CSV-Ordners festlegen
   bool SetCsvLocation(const string baseRel, const bool useCommon=true)
   {
      return (m_h>0 ? GWFilter_SetCsvLocation(m_h, baseRel, useCommon) : false);
   }

   // Rückgabe des internen Handles
   int  Handle() const { return m_h; }
};

EA-Beispiel mit minimaler Nutzung

// Minimale Demo-Nutzung
#include <Greaterwaves/GWNewsFilterLib.mqh>

GWNewsFilter g;

int OnInit()
{
   g.Create(_Symbol, true, false, 2, true, 900, 900, 2, 0);
   g.SetCsvLocation("NEWS", true); // bei Verwendung von CSV
   return INIT_SUCCEEDED;
}

void OnTick()
{
   if(g.RebuildWindow())
   {
      if(g.GetFilteringEventsCount()>0)
         Print("Filter active - skip trading");
   }
}

Unterstützung: https://academy.greaterwaves.com