Guide d'installation de l'EA

Comment installer, activer et configurer votre Expert Advisor sur MetaTrader 5.

Prérequis

• MetaTrader 5 installé et connecté à un compte broker (démo ou réel).
• Un compte communautaire MQL5 (mql5.com) — exigé par MetaEditor pour charger l'EA. Création gratuite.
• L'AutoTrading doit être autorisé par votre broker (la plupart le supportent).

1. Installer l'EA

1. Téléchargez votre fichier .ex5 depuis votre tableau de bord Pine2Expert. Le fichier est nommé d'après votre script Pine (par ex. RsiCross.ex5).
2. Ouvrez le dossier de données MT5. Dans MetaTrader 5 : Fichier → Ouvrir le dossier de données. Allez dans MQL5 / Experts /.
3. Copiez le .ex5 dans le dossier Experts (ou un sous-dossier). Clic droit sur le panneau Navigateur dans MT5 puis Actualiser.
4. Attachez l'EA à un graphique. Ouvrez un graphique sur le symbole et le timeframe ciblés par votre stratégie, puis glissez l'EA depuis le Navigateur (ou double-cliquez).

2. Activer votre licence

Au premier lancement l'EA affiche NOT LICENSED en haut à droite du graphique. Cliquez Register pour ouvrir le panneau d'activation — il affiche l'URL d'activation, votre Product ID et l'empreinte de votre compte broker.

1. Ouvrez l'URL d'activation, ou allez sur votre tableau de bord Pine2Expert et sélectionnez ce build.
2. Générez une clé trial ou lifetime pour votre Product ID + empreinte.
3. Faites entrer la clé dans l'EA — deux façons :
   • Collez-la dans l'input InpLicenseKey (propriétés de l'EA → onglet Inputs), ou
   • Téléchargez le fichier .key, placez-le dans le dossier MQL5/Files de MetaTrader, puis cliquez Import .key file dans le panneau d'activation.
4. L'EA recharge et affiche TRIAL ACTIVE (ou LIFETIME) avec la date d'expiration.

Le panneau d'activation n'a pas de champ pour la clé — les zones de texte on-chart de MetaTrader sont limitées à 63 caractères, bien moins qu'une clé de licence. Utilisez l'input InpLicenseKey ou l'import du fichier .key.

Où est le dossier MQL5/Files ? Dans MetaTrader : Fichier → Ouvrir le dossier de données, puis ouvrez MQL5/Files. Le sandbox MQL5 ne laisse l'EA lire que les fichiers de ce dossier — un .key resté dans Téléchargements est injoignable. Chemins typiques :

• Windows : C:\Users\UserName\AppData\Roaming\MetaQuotes\Terminal\<terminal-id>\MQL5\Files
• macOS : ~/Library/Application Support/net.metaquotes.wine.metatrader5/drive_c/Program Files/MetaTrader 5/MQL5/Files

L'empreinte est-elle sûre à partager ? Oui. C'est un hash SHA-256 à sens unique de votre numéro de compte et du nom du serveur broker — rien d'autre. Elle ne contient aucun mot de passe, aucun identifiant, et votre numéro de login ne peut pas en être déduit. Elle sert uniquement à lier une clé de licence à un compte : vous pouvez la coller sur la page d'activation sans aucun risque.

Référence des statuts de licence

3. Activer l'AutoTrading

Trading live uniquement — les backtests dans le Strategy Tester ignorent ce flag.

Deux choses doivent être activées avant qu'un ordre puisse s'exécuter en live :

1. AutoTrading global — bouton de la barre d'outils, en haut de MT5. Doit être vert.
2. Allow Trading par EA — au moment d'attacher l'EA, dans l'onglet Common cochez Allow Algo Trading.

Si l'un ou l'autre est désactivé, l'EA tourne mais bloque les ordres avec un message clair dans le journal.

4. Paramètres de trading

Ces inputs contrôlent l'exécution des ordres. N'apparaissent que pour les EA stratégie (pas indicateurs).

5. Paramètres visuels

6. Mappings de symboles

Pine Script utilise les noms de symboles TradingView (par ex. BINANCE:BTCUSDT) tandis que votre broker utilise les siens (BTCUSD, BTCUSD.r…). Mappez-les via l'input SymbolMap.

Format

PineTicker=BrokerSymbol;PineTicker2=BrokerSymbol2

Exemples

Plusieurs mappings séparés par ;. Les symboles non mappés gardent le nom Pine.

7. Fuseau horaire

Pine Script tourne sur les serveurs TradingView (UTC+0 ou heure de l'exchange). Votre serveur MT5 broker est généralement UTC+2 ou UTC+3 — ça impacte la logique basée sur des sessions (ex: filtres time()). Utilisez BrokerTimezoneOffset (en heures) pour les aligner.

Fuseaux brokers courants

Vérifiez la doc de votre broker pour l'offset exact et le passage à l'heure d'été.

8. Webhooks d'alertes

L'EA peut envoyer un POST HTTP à chaque appel alert() de votre script Pine.

Configuration

1. Renseignez WebhookUrl avec votre endpoint (par ex. https://my.server/hook).
2. Dans MT5 : Outils → Options → Expert Advisors, cochez Allow WebRequest for listed URLs, ajoutez votre host.
3. Redémarrez l'EA.

Format du payload

L'EA envoie un POST JSON avec le message d'alerte :

{
  "symbol": "EURUSD",
  "timeframe": "M5",
  "message": "RSI cross long",
  "price": 1.0875,
  "time": "2026-04-30T08:15:00Z"
}

FAQ

Pourquoi l'EA affiche NOT LICENSED après que j'ai changé de broker ? Les licences trial sont liées à l'empreinte du compte broker. Réactivez l'EA sur le nouveau compte, ou achetez une licence lifetime pour l'utiliser sur n'importe quel compte.

Puis-je faire tourner plusieurs EA sur le même compte ? Oui — donnez à chacun un MagicNumber unique.

Le backtest correspond-il à celui de TradingView ? Proche, pas identique : le Strategy Tester MT5 utilise les ticks broker, TradingView utilise la clôture de bougie. Les résultats peuvent diverger sur la logique intra-bougie.