============================================================
                  FTM NEWS INDICATOR FOR MT5
                     Forex Trader Mads
============================================================

Website: https://forextradermads.com


1. DESCRIPTION
------------------------------------------------------------

FTM News Indicator is a standalone MetaTrader 5 indicator that
marks selected economic news releases directly on the chart using
vertical lines.

The indicator obtains event information from the built-in MT5
Economic Calendar. It does not open, close, modify, or manage trades.

Move your mouse over a news line to see:

- Event impact
- Event name
- Release date and time

All displayed release times use your broker's MT5 server time.


2. DEFAULT NEWS EVENTS
------------------------------------------------------------

The default settings focus on high-impact United States news events
relevant to USD and FTMO restricted-news monitoring, including:

- Federal Funds Rate
- FOMC Statement
- Nonfarm Payrolls / Non-Farm Employment Change
- Unemployment Rate
- Average Hourly Earnings
- Advance GDP / Gross Domestic Product
- FOMC Meeting Minutes
- CPI y/y / Consumer Price Index y/y

Event names may vary slightly between calendar data sources. The
indicator therefore checks several alternative names and keywords.


3. INSTALLATION
------------------------------------------------------------

1. Open MetaTrader 5.
2. Click File > Open Data Folder.
3. Open the MQL5 > Indicators folder.
4. Copy FTM_News_Indicator.ex5 into that folder.
5. Return to MetaTrader 5.
6. In the Navigator, right-click Indicators and select Refresh.
7. Find FTM News Indicator under Indicators.
8. Drag FTM News Indicator onto your chart.

If the indicator does not appear after refreshing, restart
MetaTrader 5 and check the Indicators folder again.


4. INPUT SETTINGS
------------------------------------------------------------

InpCountryCode
Default: US
Filters events using the MT5 calendar country code. Leave blank to
include all available countries.

InpCurrency
Default: USD
Filters events by currency. Leave blank to include all currencies.

InpHighImpactOnly
Default: true
When enabled, only high-impact events are displayed.

InpExactTimeOnly
Default: true
Excludes tentative, all-day, and other events without an exact
release time.

InpEventKeywords
A semicolon-separated list of event names or keywords. An event is
displayed when its calendar name or event code contains at least one
keyword. The comparison is not case-sensitive.

Example:
CPI;Nonfarm Payrolls;Federal Funds Rate

Leave this input blank to display all events that pass the selected
country, currency, impact, and time filters.

InpLookAheadMinutes
Default: 10080
Controls how far into the future the indicator searches. The default
of 10,080 minutes is equal to 7 days.

InpKeepPastMinutes
Default: 1440
Controls how long a news line remains after its release. The default
of 1,440 minutes is equal to 24 hours.

Examples:

60     = 1 hour
360    = 6 hours
1440   = 24 hours
10080  = 7 days
0      = remove the line shortly after release

InpRefreshSeconds
Default: 30
Controls how often the indicator refreshes the calendar information.
Values below 5 seconds are automatically treated as 5 seconds.

InpShowChartLines
Default: true
Enables or disables the news lines.

InpHighLineColor, InpMediumLineColor, InpLowLineColor
Set the line color for each event impact level. With the default
high-impact-only filter, only the high-impact color is normally used.

InpLineStyle
Sets the visual style of the vertical lines.

InpLineWidth
Sets the line width. The indicator limits the effective width to a
range of 1 to 5.


5. IMPORTANT NOTES
------------------------------------------------------------

- The indicator requires MetaTrader 5 Economic Calendar data.
- The EX5 file is for MetaTrader 5 only and will not work in MT4.
- Keep MT5 connected to the internet and logged in to a trading
  server.
- Calendar availability and event naming can differ between brokers
  and MT5 installations.
- The displayed time is MT5 server time, not necessarily your local
  computer time.
- The indicator may not retrieve live calendar data in the Strategy
  Tester.
- If calendar retrieval temporarily fails, the indicator keeps the
  existing lines and tries again on the next scheduled refresh.
- The indicator is a visual news reminder. It does not automatically
  pause trading or manage orders and positions.


6. TROUBLESHOOTING
------------------------------------------------------------

NO NEWS LINES ARE DISPLAYED

- Confirm that InpShowChartLines is set to true.
- Confirm that MT5 is connected to a trading server.
- Open the MT5 Economic Calendar and check whether data is available.
- Check the Experts tab for a calendar error message.
- Make sure the selected country, currency, and keywords match the
  events you want to display.
- Temporarily clear InpEventKeywords or set InpHighImpactOnly to
  false to test whether calendar events are being received.

THE RELEASE TIME LOOKS DIFFERENT FROM A WEBSITE

The indicator uses MT5 server time. News websites may display local
time, UTC, New York time, or another selected timezone.

AN EXPECTED EVENT IS MISSING

The MT5 calendar may use a different event name. Add part of the
calendar's event name to InpEventKeywords and separate it from the
other keywords with a semicolon.


7. DISCLAIMER
------------------------------------------------------------

This indicator is provided for informational and educational purposes
only. Economic calendar information may be delayed, incomplete,
unavailable, or changed without notice.

Always verify restricted news events, release times, and applicable
trading rules using the official information provided by your broker
or proprietary trading firm. This indicator is not affiliated with,
endorsed by, or officially provided by FTMO.

Trading involves risk. The indicator does not provide financial
advice and does not guarantee protection from losses, slippage,
spread widening, execution delays, or rule violations.


============================================================
                         END OF FILE
============================================================
