TlgNewsInformer/README.md

<p align="center">
Economic calendar watcher that sends a heads-up to Telegram before a scheduled news event hits.  
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Language-MQL5-1B6CA8?style=flat-square"/>
  <img src="https://img.shields.io/badge/Platform-MetaTrader%205-0D1B2A?style=flat-square"/>
  <img src="https://img.shields.io/badge/Author-nique__372%20And%20Leo-C9D6DF?style=flat-square&logoColor=white"/>
  <img src="https://img.shields.io/badge/Articles-mql5.com-1B6CA8?style=flat-square"/>
<a href="./LICENSE">
  <img src="https://img.shields.io/badge/License-Nique%26Leo%20FPU-orange.svg"/>
</a>
</p>


---

## 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:

![Inputs panel](https://forge.mql5.io/nique_372/TlgNewsInformer/media/branch/main/Market/Inputs.PNG)

**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:

![Example alert in Telegram](https://forge.mql5.io/nique_372/TlgNewsInformer/media/branch/main/Market/Example.png)

**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:** <https://www.mql5.com/es/users/nique_372>
- **Articles:** <https://www.mql5.com/es/users/nique_372/publications>