How to Get News Events in MQL5?

What are News Events and Why are They Important for Trading?

News events encompass a wide range of occurrences, from scheduled economic data releases (e.g., Non-Farm Payrolls, GDP figures, inflation rates) to unscheduled political announcements or central bank interventions. These events are pivotal for traders because they can introduce significant volatility and rapid price movements into financial markets.

Understanding and reacting to news is crucial for several reasons:

• Risk Management: High-impact news can invalidate existing technical setups or trigger unexpected stop-loss activations. Being aware of upcoming events allows traders to adjust their positions, widen stops, or temporarily pause trading.
• Opportunity Identification: News can create new trading opportunities by shifting market sentiment or confirming a directional bias. Some strategies are built specifically around news-driven volatility.
• Contextual Understanding: News provides fundamental context to price action, helping traders understand why the market is moving, not just how.

Overview of MQL5 and Its Capabilities

MQL5 (MetaQuotes Language 5) is a high-level, object-oriented programming language designed for developing trading robots (Expert Advisors), custom technical indicators, scripts, and utility libraries within the MetaTrader 5 trading platform. Its event-driven architecture is particularly well-suited for handling asynchronous events like incoming ticks, new bars, and, pertinently, news releases.

MQL5 provides a richer set of tools and functionalities compared to its predecessor, MQL4. This includes more sophisticated event handling, a comprehensive standard library, and direct access to features like the depth of market and, crucially for this topic, built-in news event handling. While MQL4 users often relied on external DLLs or complex WebRequest solutions for news integration, MQL5 offers a more streamlined and native approach.

Setting Up Your MQL5 Environment for News Event Handling

Before you can receive news events in your MQL5 programs, ensure your MetaTrader 5 terminal is correctly configured:

1. Enable News in Terminal: In MetaTrader 5, go to Tools -> Options -> Events. Ensure the ‘Enable’ checkbox for news is ticked. Brokers provide news, so the availability and types of news will depend on your broker’s feed.
2. Expert Advisor Settings: When running an Expert Advisor that processes news, ensure it has the necessary permissions. While direct WebRequests are not typically needed for broker-provided news, if your strategy involves fetching supplementary data, WebRequest permissions might be relevant (Tools -> Options -> Expert Advisors -> Allow WebRequest for listed URL). However, for the built-in MQL5 news functions, this is generally not a prerequisite.

It’s important to note that the news content and categories are supplied by your broker. Not all brokers provide extensive news feeds directly into the terminal.

Accessing News Events Using MQL5 Functions

MQL5 provides a set of dedicated functions to manage subscriptions to news categories and retrieve news information.

Using the NewsFilterAdd() Function to Subscribe to News Categories

The bool NewsFilterAdd(string category_name) function allows your MQL5 program to subscribe to specific news categories. Once subscribed, your program will receive notifications for new items published under that category via the OnNews() event handler.

Syntax: bool NewsFilterAdd(string category_name);

• category_name: The name of the news category to subscribe to. Examples could include “Economic Calendar”, “Central Banks”, specific currency codes like “USD”, “EUR”, or broker-defined categories.

The exact category names are broker-dependent. You might need to inspect incoming news manually (e.g., via the terminal’s news tab) or consult your broker’s documentation to identify available categories.

void OnInit() {
  // Subscribe to general economic news and news related to USD
  if (!NewsFilterAdd("Economic Calendar")) {
    PrintFormat("Failed to subscribe to 'Economic Calendar' news. Error: %d", GetLastError());
  }
  if (!NewsFilterAdd("USD")) {
    PrintFormat("Failed to subscribe to 'USD' news. Error: %d", GetLastError());
  }
}

Understanding the NewsFilterDelete() Function

Conversely, the bool NewsFilterDelete(string category_name) function is used to unsubscribe from a previously added news category. This is useful for managing resources or dynamically changing the focus of your news monitoring.

Syntax: bool NewsFilterDelete(string category_name);

• category_name: The name of the news category to unsubscribe from.

It’s good practice to unsubscribe from news categories in the OnDeinit() function of your EA or script to clean up subscriptions when the program is removed from the chart or the terminal is closed.

void OnDeinit(const int reason) {
  NewsFilterDelete("Economic Calendar");
  NewsFilterDelete("USD");
}

Exploring Other Relevant Functions (e.g., NewsInfo*() functions)

Once a news event is received in the OnNews() handler, you’ll have a news_id. To get specific details about this news item, MQL5 provides a family of NewsInfo*() functions:

• long NewsInfoGetInteger(ulong news_id, ENUM_NEWS_INFO_INTEGER property_id): Retrieves integer properties of the news item (e.g., importance, flags).
• datetime NewsInfoGetTime(ulong news_id, ENUM_NEWS_INFO_DATETIME property_id): Retrieves datetime properties (e.g., publication time).
• string NewsInfoGetString(ulong news_id, ENUM_NEWS_INFO_STRING property_id): Retrieves string properties (e.g., title, body, category, language).

Key ENUM_NEWS_INFO_* properties include:

• NEWS_INFO_TIME: Publication time (datetime).
• NEWS_INFO_TITLE: News headline (string).
• NEWS_INFO_CATEGORY_NAME: Category of the news (string).
• NEWS_INFO_FULL_CONTENT: Full text of the news item (string).
• NEWS_INFO_IMPORTANCE: Numerical importance level, if provided by broker (long).
• NEWS_INFO_LANGUAGE_CODE: Language of the news (string).

These functions are used within the OnNews() event handler.

Handling News Events in Your MQL5 Program

The core of news processing in MQL5 lies within the OnNews() event handler.

Implementing the OnNews() Event Handler

The OnNews(ulong news_id, string source) event handler is a predefined function in MQL5 that is automatically called by the terminal when a new news item arrives that matches one of the categories your program has subscribed to using NewsFilterAdd().

Syntax: void OnNews(ulong news_id, string source);

• news_id: A unique identifier for the news item. This ID is used with NewsInfo*() functions to retrieve details.
• source: The source of the news (often the broker’s name or news provider).

//+------------------------------------------------------------------+
//| News event handler                                               |
//+------------------------------------------------------------------+
void OnNews(ulong news_id, string source)
  {
   //--- process news using news_id
   string title    = NewsInfoGetString(news_id, NEWS_INFO_TITLE);
   datetime pub_time = NewsInfoGetTime(news_id, NEWS_INFO_TIME);

   PrintFormat("New Event: ID=%d, Source=%s, Time=%s, Title=%s", 
               news_id, source, TimeToString(pub_time), title);

   // Further processing logic here
  }

Extracting Information from News Events (Title, Body, Category, etc.)

Inside OnNews(), you use the NewsInfo*() functions with the provided news_id to extract the data you need.

void OnNews(ulong news_id, string source)
  {
   string title         = NewsInfoGetString(news_id, NEWS_INFO_TITLE);
   string category      = NewsInfoGetString(news_id, NEWS_INFO_CATEGORY_NAME);
   string full_content  = NewsInfoGetString(news_id, NEWS_INFO_FULL_CONTENT);
   datetime event_time  = NewsInfoGetTime(news_id, NEWS_INFO_TIME);
   long importance      = NewsInfoGetInteger(news_id, NEWS_INFO_IMPORTANCE); // Broker-dependent

   PrintFormat("--- News Received ---");
   PrintFormat("ID: %d", news_id);
   PrintFormat("Source: %s", source);
   PrintFormat("Time: %s", TimeToString(event_time));
   PrintFormat("Category: %s", category);
   PrintFormat("Title: %s", title);
   // PrintFormat("Content: %s", full_content); // Can be very long
   PrintFormat("Importance: %d", importance);
   PrintFormat("---------------------");
  }

Filtering and Processing News Events Based on Relevance

Not all news items, even within subscribed categories, will be relevant to your trading strategy. You’ll often need to implement further filtering logic within OnNews():

• Keyword Matching: Search the NEWS_INFO_TITLE or NEWS_INFO_FULL_CONTENT for specific keywords (e.g., “FOMC”, “ECB”, “Interest Rate”, currency pairs like “EURUSD”).
• Importance Level: If your broker provides NEWS_INFO_IMPORTANCE, filter based on this value.
• Currency Specificity: If trading EURUSD, you might be interested in news categorized under “EUR”, “USD”, or general economic indicators affecting major economies.
• Source Filtering: If multiple news sources are aggregated, you might trust or prioritize one over another.

Processing can involve logging the news, alerting the user, modifying trading parameters (e.g., widening spreads, pausing new entries), or, with extreme caution, triggering trades.

Practical Examples and Use Cases

Developing a Simple News Alert System

This EA subscribes to news and alerts the user via the Alert() function.

//+------------------------------------------------------------------+
//|                                                 NewsAlerter.mq5 |
//|                        Copyright 2023, MetaQuotes Software Corp. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2023, MetaQuotes Software Corp."
#property link      "https://www.mql5.com"
#property version   "1.00"

//--- OnInit: Subscribe to news
int OnInit()
  {
   if(!NewsFilterAdd("Economic Calendar"))
     {
      Print("Failed to subscribe to Economic Calendar news");
     }
   if(!NewsFilterAdd("Central Banks"))
     {
      Print("Failed to subscribe to Central Banks news");
     }
   Comment("News Alerter Initialized. Waiting for news...");
   return(INIT_SUCCEEDED);
  }

//--- OnDeinit: Unsubscribe from news
void OnDeinit(const int reason)
  {
   NewsFilterDelete("Economic Calendar");
   NewsFilterDelete("Central Banks");
   Comment("News Alerter Deinitialized.");
  }

//--- OnNews: Process incoming news
void OnNews(ulong news_id, string source)
  {
   string title = NewsInfoGetString(news_id, NEWS_INFO_TITLE);
   datetime pub_time = NewsInfoGetTime(news_id, NEWS_INFO_TIME);
   string category = NewsInfoGetString(news_id, NEWS_INFO_CATEGORY_NAME);

   string alert_message = StringFormat("NEWS: [%s] %s - %s (%s)", 
                                     TimeToString(pub_time, TIME_SECONDS),
                                     category,
                                     title,
                                     source);
   Alert(alert_message);
   Print(alert_message);

   // Example: Check for high-impact keywords
   if(StringFind(title, "FOMC", 0) != -1 || StringFind(title, "NFP", 0) != -1)
     {
      Alert("HIGH IMPACT NEWS DETECTED: ", title);
      // Additional actions could be triggered here
     }
  }
//+------------------------------------------------------------------+

Creating an Automated Trading Strategy Based on News Events

Directly basing entry/exit signals solely on MQL5 news events is complex and risky due to the lack of sophisticated sentiment analysis tools within MQL5 itself and the varying quality/timeliness of broker-provided news. However, news can be used for risk management or context:

• Pause Trading: An EA could temporarily stop opening new trades or close existing ones before high-impact news (identified by keywords or pre-scheduled times if integrated with an economic calendar).
• Adjust Parameters: Widen stop-loss and take-profit levels around news events to account for increased volatility.
• Filter Signals: Avoid taking technical signals that occur immediately before or during a significant news release relevant to the traded instrument.

Example (Conceptual – Pausing trading around specific keywords):

// Global flag to control trading
bool g_trading_paused = false;

void OnNews(ulong news_id, string source)
  {
   string title = NewsInfoGetString(news_id, NEWS_INFO_TITLE);
   // Example keywords for high-impact news related to USD
   string keywords[] = {"FOMC", "Non-Farm Payrolls", "NFP", "Interest Rate Decision"};

   for(int i=0; i < ArraySize(keywords); i++)
     {
      if(StringFind(title, keywords[i], 0) != -1 && 
         StringFind(NewsInfoGetString(news_id, NEWS_INFO_CATEGORY_NAME), "USD", 0) != -1)
        {
         PrintFormat("High impact USD news detected: %s. Pausing trading activities.", title);
         g_trading_paused = true;
         // Set a timer to resume trading after a certain period, e.g., 30 minutes
         EventSetTimer(1800); // 30 minutes * 60 seconds
         break;
        }
     }
  }

void OnTimer()
  {
   if(g_trading_paused)
     {
      Print("Resuming trading activities after news event.");
      g_trading_paused = false;
      EventKillTimer();
     }
  }

// In your OnTick() or other trading logic:
void OnTick()
  {
   if(g_trading_paused)
     {
      // Skip trading logic
      return;
     }
   // ... your normal trading logic ...
  }

Caution: This is a simplified example. Robust news-based trading requires careful backtesting, consideration of news delivery delays, and potentially advanced NLP techniques often beyond native MQL5 capabilities.

Integrating News Events with Other Market Data

News events can provide valuable context to other forms of market analysis:

• Confirmation/Contradiction: A news release might confirm a technical pattern (e.g., positive data supporting a breakout above resistance) or contradict it (e.g., negative news causing a false breakout).
• Volatility Filter: Before entering a trade based on an indicator, check if any high-impact news is imminent for the currencies involved. If so, you might delay entry or require a stronger signal.
• Regime Shift Identification: A significant piece of news (e.g., a major policy change by a central bank) could signal a shift in the market regime, potentially invalidating strategies that worked well in the past.

Best Practices and Advanced Techniques

Efficiently Managing News Event Subscriptions

• Subscribe Selectively: Only subscribe to categories directly relevant to your strategy to minimize processing overhead. Use NewsFilterAdd() in OnInit().
• Unsubscribe Cleanly: Always use NewsFilterDelete() in OnDeinit() to remove subscriptions when your program terminates. This prevents orphaned subscriptions and potential resource leaks.
• Avoid Dynamic Churn: Refrain from frequently adding and deleting news filters within tight loops or OnTick(). Set your filters once at initialization if possible.

Handling Errors and Unexpected News Event Formats

• Check Return Values: Always check the boolean return values of NewsFilterAdd() and NewsFilterDelete(). Use GetLastError() to understand the reason for failure.
• Validate Data: When using NewsInfo*() functions, be aware that some fields might be empty or not provided by the broker (e.g., NEWS_INFO_IMPORTANCE). Code defensively.
• NEWS_INFO_FULL_CONTENT can be very large. Handle it carefully to avoid performance issues or string processing errors.

Optimizing Performance for Real-Time News Processing

• Keep OnNews() Lean: The OnNews() handler should execute as quickly as possible. Avoid lengthy computations, file operations, or blocking calls within it.
• Asynchronous Processing (Simulated): If complex analysis of a news item is required, OnNews() can store the news_id or essential data in a queue (e.g., a dynamic array of structures). A separate OnTimer() event can then process this queue at regular intervals, preventing OnNews() from blocking new incoming events or tick processing.
• String Operations: Be mindful of string manipulations, as they can be resource-intensive. Use efficient string functions and avoid unnecessary concatenation or searching in large content strings if possible.

By mastering MQL5’s news handling capabilities, developers can build more informed and context-aware automated trading systems, enhancing both risk management and potential opportunity identification.