MQL5 Economic Calendar API: CalendarValueHistory & News Filter Code

//+------------------------------------------------------------------+
//|                                     EconomicCalendarFilterEA.mq5 |
//|                             Copyright 2026, Pineify Guides Series |
//|                                              https://pineify.app |
//+------------------------------------------------------------------+
#property copyright "Pineify Guides Series"
#property link      "https://pineify.app/mql5/economic-calendar-api"
#property version   "1.00"
#property strict

//--- Input parameters
input group "--- News Filter Configuration ---"
input bool   InpEnableNewsFilter    = true;   // Enable Calendar News Filter
input string InpFilterCurrency      = "USD";  // Currency to monitor (e.g. USD, EUR)
input int    InpMinutesBeforeNews   = 30;     // Pause trading N minutes before news
input int    InpMinutesAfterNews    = 15;     // Pause trading N minutes after news

//+------------------------------------------------------------------+
//| Helper: Check if high-impact news is nearby                      |
//+------------------------------------------------------------------+
int HighImpactNewsStatus(const string currency, int minsBefore, int minsAfter)
  {
   if(!InpEnableNewsFilter)
      return 0;

   datetime now = TimeCurrent();
   datetime fromTime = now - (minsAfter * 60);
   datetime toTime   = now + (minsBefore * 60);

   MqlCalendarValue values[];
   // Retrieve calendar values for the currency in the specified window
   ResetLastError();
   int count = CalendarValueHistory(values, fromTime, toTime, NULL, currency);
   if(count<0 || GetLastError()!=0)
     {
      Print("Calendar query unavailable: ",GetLastError());
      return -1;
     }

   for(int i = 0; i < count; i++)
     {
      MqlCalendarEvent event;
      if(!CalendarEventById(values[i].event_id,event))
        {
         Print("Calendar event metadata unavailable: ",GetLastError());
         return -1;
        }
      else
        {
         // Check if event is High Impact
         if(event.importance == CALENDAR_IMPORTANCE_HIGH)
           {
            PrintFormat("NEWS ALERT: High Impact [%s] at %s: '%s'",
                        currency,
                        TimeToString(values[i].time, TIME_DATE|TIME_MINUTES),
                        event.name);
            return 1; // Blackout active
           }
        }
     }

   return 0;
  }

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
  {
   if(InpMinutesBeforeNews<0 || InpMinutesAfterNews<0 || InpMinutesBeforeNews>10080 || InpMinutesAfterNews>10080 || InpMinutesBeforeNews+InpMinutesAfterNews==0) return INIT_PARAMETERS_INCORRECT;
   Print("Economic Calendar Filter initialized for currency: ", InpFilterCurrency);
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
  {
   // Check news filter before allowing any trading decisions
   int newsStatus = HighImpactNewsStatus(InpFilterCurrency,
                                             InpMinutesBeforeNews,
                                             InpMinutesAfterNews);
   if(newsStatus!=0)
     {
      // Display status on chart comment
      Comment(newsStatus<0 ? "Entry blocked: calendar status unknown" : "Entry blocked: high-importance event in window");
      return;
     }

   Comment(InpEnableNewsFilter ? "No matching high-importance event returned; this is not a market safety signal." : "News filter disabled.");

   // Normal EA strategy signal and order routing continues here...
  }