# AIMS Entry Alert Indicator (MT4)

**AIMS Entry Alert** is the foundational signal generation engine of the AIMS Trading Methodology. It automates the real-time detection of **Setup 1 (Box Breakout)** and **Setup 2 (Pullback Retest)** directly on your MetaTrader 4 charts.

Engineered with built-in Alligator trend gatekeeping, AIMS Entry Alert ensures traders only execute signals that are mathematically aligned with higher-timeframe market structure.

***

## What Problem Does It Solve?[​](#what-problem-does-it-solve "Direct link to What Problem Does It Solve?")

Manually monitoring multiple charts for box consolidations and breakout candle closes is mentally taxing and prone to emotional execution errors.

AIMS Entry Alert eliminates ambiguity by:

* Framing market structure consolidation boxes automatically.
* Testing breakout candles against the Alligator moving average gatekeeper.
* Alerting traders the instant a valid Setup 1 or Setup 2 candle closes.

***

## Core Features at a Glance[​](#core-features-at-a-glance "Direct link to Core Features at a Glance")

* **Dual Setup Architecture**: Accurately flags both initial Setup 1 box breakouts and Setup 2 shallow retests.
* **Alligator Trend Gatekeeper**: Restricts buy signals to candles above the Alligator lines, and sell signals to candles below.
* **Buffer-Ready for EAs**: Exposes clean signal buffers for automated Expert Advisor execution.
* **Multi-Platform Flexibility**: Works seamlessly across Forex, Index CFDs (GER40, NAS100), and Commodities.

***

## 4-Step Quickstart[​](#4-step-quickstart "Direct link to 4-Step Quickstart")

1. **Installation**: Copy `AIMSEntryAlert.ex4` to your `MQL4/Indicators/` directory and refresh MT4.
2. **Chart Attachment**: Attach to your preferred trading timeframe (**M5**, **M15**, or **H1**).
3. **Setup Filter**: Choose whether to show Setup 1 only, Setup 2 only, or both setup variations simultaneously.
4. **Execution Protocol**: On candle close, place pending stop orders above the setup candle's high or below its low.

***

## Explore the Indicator Guide[​](#explore-the-indicator-guide "Direct link to Explore the Indicator Guide")

* **[Signals & Chart Anatomy](/indicators/entry-alert/docs/signals.md)**: Setup 1 vs Setup 2 differences, box breakout criteria, and arrow buffers.
* **[Settings & Inputs Reference](/indicators/entry-alert/docs/settings.md)**: Filter options, Alligator gatekeeper parameters, and sound alerts.
* **[Strategy & Confluence Workflows](/indicators/entry-alert/docs/strategy.md)**: Combining Entry Alert with AIMS Box support/resistance and Free Trade management.