Economic calendar watcher that sends a heads-up to Telegram before a scheduled news event hits.
---
## Main Features
- **Zero-code setup**: Just a Telegram bot token and chat id, and the EA does the rest.
- **Runs off the real economic calendar**: pulls events via Fast NewsLibrary (internal use MQL5 News API)
- **Configurable heads-up window**: choose how many seconds before the event the alert should fire.
- **Choose what you track**: no filter (every country), current chart symbol only, or a custom list of country codes (ISO 3166-1 alpha-2) you define yourself.
- **Rich Markdown messages**: each alert is a clean table Event, importance (π΄/π‘/βͺ), estimate, previous value, and predicted impact emoji (π/π/π).
- **Symbol-aware predictions**: no matter which filter you pick, the forecast-vs-previous comparison in the "Pred" column is always resolved against the symbol of the chart the EA is attached to (up / down / neutral), so it always speaks to what you're actually trading.
---
## Usage: the process
**1. Create your Telegram bot** talk to [@BotFather](https://t.me/BotFather) on Telegram, run `/newbot`, and copy the token it gives you. Get your chat id (a DM with [@userinfobot](https://t.me/userinfobot) works, or your group/channel id if you want it posted there).
**2. Drop the token and chat id into the EA's inputs**, pick your date range, alert window, and which importance levels you want:
**3. Pick what you want to track** with the `Filters` group no filter, current chart symbol only (the EA resolves which countries matter for that symbol on its own), or a custom country list (comma-separated ISO codes, e.g. `US,GB,JP`) if you only care about specific economies.
**4. Attach it to any chart and leave it running.** When a filtered event is about to happen, you get a message like this in your chat, with the prediction always read against the chart's own symbol regardless of which filter you used:
**5. Done** no further action needed, the EA keeps watching the calendar and alerts you before every matching event.
---
## Repository Structure
```text
TlgNewsInformer/
βββ NewsInformer.mq5 # Main EA sets up the calendar, wires up Telegram, drives OnTick
βββ Secrets.mqh # Internal license/import switch (Market build vs. dev build)
βββ dependencies.json # tsndep manifest (repos required to compile from source)
βββ Src/
β βββ Main.mqh # CTelegramsNews: builds the Markdown alert and sends it via Telegram
βββ Market/ # Screenshots used in this README and the MQL5 Market listing
```
---
## β οΈ License Activation
In case:
- You use the Forge release version.
- You might want to compile the source code (dev).
You will need to have purchased the following product.
- FastNL (Fast NewsLibrary)
### How to activate
1. Purchase products from my **TheBotPlace** profile:
- https://thebotplace.com/user/46vILTzIIBbqDhugEvqWGlc8rl52
2. Retrieve your **TBP ID** from your account:
- https://thebotplace.com/profile
---
## Installation
MetaTrader 5 build `5430` or later is required either way. Pick the path that matches what you want to do:
### For developers
Check [dependencies.json](https://forge.mql5.io/nique_372/TlgNewsInformer/src/branch/main/dependencies.json), and:
- **Install them with `tsndep`** (available on [PyPI](https://pypi.org/project/tsndep)) from your `Shared Projects` folder it reads [dependencies.json](https://forge.mql5.io/nique_372/TlgNewsInformer/src/branch/main/dependencies.json) and downloads everything declared there:
```bash
cd "C:\Users\YOUR_USER\AppData\Roaming\MetaQuotes\Terminal\YOUR_ID\MQL5\Shared Projects"
tsndep install "https://forge.mql5.io/nique_372/TlgNewsInformer.git"
```
### For users
Want to use it right away? Don't get bogged down or overcomplicate things dealing with dependencies, includes, and the likeβhere are two options to download the ready-to-use .ex5 file.
**Option A Manual (from the repo's releases)**
1. Download the latest compiled EA from [Releases](https://forge.mql5.io/nique_372/TlgNewsInformer/releases).
2. Move it into your terminal's `MQL5/Experts` folder.
**Option B MQL5 Market (recommended, no manual steps)**
1. Get **TlgNewsInformer** from the [MQL5 Market](https://www.mql5.com/es/market/product/198517) open it via the MT5 GUI, hit download, and it's placed straight into `Experts\Market` ready to attach to a chart.
Either way, once the EA is in place, jump to [Usage: the process](#usage-the-process) above.
> Important: The MT5 Market version uses its own license; the license for this repository applies only to the source code found here, whereas the .ex5 file distributed via the MQL5 Market is subject to that platform's license.
---
## License
**[Read Full License](https://forge.mql5.io/nique_372/TlgNewsInformer/src/branch/main/LICENSE)**
By downloading, cloning, forking, or otherwise using this repository, you accept the license terms.
---
## Disclaimer
**Trading involves substantial risk of loss.**
- This software is a technical tool, not financial advice
- Past performance does not guarantee future results
- You are solely responsible for your trading decisions
- Always test thoroughly before deploying with real capital
- Use appropriate risk management at all times
The authors assume no liability for trading losses, system failures, or any damages arising from the use of this software.
---
## Contact
- **Platform:** [MQL5 Community](https://www.mql5.com/es/users/nique_372)
- **Profile:**
- **Articles:**