Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Avancé

WebRequest en MQL5 : appeler une API HTTP depuis un Expert Advisor

Envoyer un signal vers un webhook, interroger une API REST, récupérer un fichier JSON : les deux signatures de WebRequest, l’autorisation des URL, les en-têtes, l’encodage UTF-8 et les limites à connaître.

Mis à jour le 23 octobre 2026Lecture : 9 minPar Alix, OptiBot Trading

La fonction WebRequest envoie une requête HTTP ou HTTPS depuis un Expert Advisor ou un script MQL5 et renvoie le code de réponse du serveur (200, 404…), ou -1 en cas d’erreur. Elle permet d’appeler une API REST, de poster un signal vers un webhook ou de télécharger un fichier. Deux conditions préalables : l’adresse du serveur doit être ajoutée à la liste des URL autorisées dans Outils, Options, Expert Advisors, et l’appel doit venir d’un EA ou d’un script, jamais d’un indicateur. Enfin, la fonction est synchrone : l’exécution du programme est suspendue jusqu’à la réponse ou jusqu’à l’expiration du délai.

Cette page appartient à la rubrique MQL5 avancé. Pour de simples alertes vers votre téléphone, les fonctions natives présentées dans Alertes, e-mails et notifications push sont plus simples et ne demandent aucune API.

Les deux signatures

La première version, pensée pour les requêtes simples de type formulaire, prend un cookie et un référent :

int WebRequest(const string method, const string url, const string cookie, const string referer, int timeout, const char &data[], int data_size, char &result[], string &result_headers)

La seconde, plus générale et généralement préférée, accepte des en-têtes arbitraires :

int WebRequest(const string method, const string url, const string headers, int timeout, const char &data[], char &result[], string &result_headers)

Les paramètres essentiels :

ParamètreRôle
methodméthode HTTP, par exemple "GET" ou "POST"
urladresse complète, avec http:// ou https://
headersen-têtes au format "Clé: valeur", séparés par "\r\n"
timeoutdélai maximal d’attente, en millisecondes
data[]corps de la requête, en octets
result[]corps de la réponse, en octets
result_headersen-têtes de la réponse

Le port est choisi automatiquement selon le protocole : 80 pour HTTP, 443 pour HTTPS.

Autoriser l’URL dans le terminal

Avant tout appel, ouvrez Outils, Options, onglet Expert Advisors, cochez l’autorisation de WebRequest pour les URL listées et ajoutez l’adresse du serveur (par exemple https://api.exemple.com). Sans cette étape, la fonction échoue et renvoie -1. C’est une protection volontaire : un programme ne peut pas contacter un serveur que l’utilisateur n’a pas explicitement approuvé. Pensez-y lors du déploiement sur un VPS ou chez un client : la liste est propre à chaque terminal.

Ce que WebRequest ne peut pas faire

  • Pas dans un indicateur : les indicateurs d’un même symbole partagent un fil d’exécution, et un appel bloquant gèlerait tous les graphiques concernés. Un appel depuis un indicateur renvoie l’erreur 4014, « fonction non autorisée ». Les EA et les scripts, qui ont chacun leur propre fil, peuvent l’utiliser.
  • Pas dans le Strategy Tester : la fonction n’est pas exécutée en backtest. Prévoyez un comportement de repli, en testant MQLInfoInteger(MQL_TESTER).
  • Pas d’appel asynchrone : pendant l’attente, votre EA ne traite aucun tick. Un serveur lent bloque donc votre robot pendant toute la durée du délai.

Exemple complet : envoyer un signal JSON vers un webhook

L’EA suivant envoie, à chaque nouvelle bougie, un petit document JSON vers une URL configurable. Il illustre la conversion UTF-8, la construction des en-têtes, la gestion du code de retour et le repli en backtest.

//+------------------------------------------------------------------+
//| WebhookSignal.mq5 : POST JSON vers une API externe               |
//+------------------------------------------------------------------+
input string InpUrl    ="https://api.exemple.com/signal"; // à autoriser dans Outils > Options
input string InpToken  ="";                                // jeton d'API éventuel
input int    InpTimeout=3000;                              // délai max (ms)

datetime g_last_bar=0;

//--- envoie un corps JSON, renvoie le code HTTP ou -1
int PostJson(const string url,const string json,string &answer)
  {
   char body[],result[];
   string result_headers;
   //--- conversion UTF-8 ; on retire le zéro terminal ajouté par la conversion
   int len=StringToCharArray(json,body,0,WHOLE_ARRAY,CP_UTF8);
   if(len>0) ArrayResize(body,len-1);

   string headers="Content-Type: application/json\r\n";
   if(InpToken!="")
      headers+="Authorization: Bearer "+InpToken+"\r\n";

   ResetLastError();
   int code=WebRequest("POST",url,headers,InpTimeout,body,result,result_headers);
   if(code==-1)
     {
      PrintFormat("WebRequest a échoué, erreur %d. L'URL est-elle autorisée ?",GetLastError());
      return(-1);
     }
   answer=CharArrayToString(result,0,WHOLE_ARRAY,CP_UTF8);
   return(code);
  }

int OnInit()
  {
   if(MQLInfoInteger(MQL_TESTER))
      Print("Testeur : WebRequest n'est pas disponible, les envois seront ignorés");
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   datetime bar=iTime(_Symbol,PERIOD_CURRENT,0);
   if(bar==g_last_bar) return;               // une requête par bougie au maximum
   g_last_bar=bar;
   if(MQLInfoInteger(MQL_TESTER)) return;    // repli en backtest

   string json=StringFormat("{\"symbol\":\"%s\",\"time\":%I64d,\"close\":%s}",
                            _Symbol,(long)iTime(_Symbol,PERIOD_CURRENT,1),
                            DoubleToString(iClose(_Symbol,PERIOD_CURRENT,1),_Digits));
   string answer;
   int code=PostJson(InpUrl,json,answer);
   if(code>=200 && code<300)
      Print("Signal envoyé, réponse : ",answer);
   else if(code>0)
      PrintFormat("Le serveur a répondu %d : %s",code,answer);
  }

Plusieurs détails évitent des heures de débogage. StringToCharArray ajoute un caractère nul en fin de tableau : envoyé tel quel, il corrompt de nombreux corps JSON, d’où le redimensionnement. Le code HTTP est distinct du code d’erreur MQL5 : un 401 ou un 500 signifie que la requête est bien partie et que le serveur a répondu ; seul -1 indique un échec côté terminal. Enfin, une requête par bougie limite à la fois la charge du serveur et le temps pendant lequel l’EA est bloqué.

Lire une réponse JSON

MQL5 ne fournit pas d’analyseur JSON natif. Pour une réponse simple, quelques appels à StringFind et StringSubstr suffisent à extraire une valeur. Pour des structures plus riches, utilisez une bibliothèque d’analyse JSON écrite en MQL5, en vérifiant sa fiabilité, ou demandez au serveur un format plus simple (une ligne de valeurs séparées). Validez toujours le contenu reçu avant d’en faire un paramètre de trading : une réponse vide, tronquée ou inattendue ne doit jamais déclencher d’ordre.

Cas d’usage en trading

  • Supervision : envoyer périodiquement l’équité, le nombre de positions et l’état de l’EA vers un tableau de bord personnel, afin d’être alerté si le robot cesse d’émettre. Cette démarche est développée dans Surveiller ses robots en production.
  • Journal distant : poster chaque transaction clôturée vers un service qui l’archive hors de la machine de trading.
  • Données externes : récupérer une liste de symboles autorisés ou un paramètre de risque global depuis un serveur que vous contrôlez.
  • Événements macroéconomiques : avant de chercher une API tierce, vérifiez si le calendrier économique intégré ne répond pas déjà à votre besoin, sans aucune requête réseau à programmer.

Bonnes pratiques en production

  • Ne bloquez pas le chemin critique : n’appelez pas WebRequest juste avant l’envoi d’un ordre. Placez les requêtes non urgentes dans OnTimer, comme expliqué dans Utiliser OnTimer, et choisissez un délai court.
  • Limitez la fréquence : beaucoup d’API imposent des quotas. Regroupez les données et évitez les appels à chaque tick.
  • Protégez vos secrets : un jeton d’API saisi dans un paramètre input est visible dans les propriétés de l’EA et peut apparaître dans des captures d’écran. Ne le partagez jamais.
  • Prévoyez la panne : si le service externe tombe, l’EA doit continuer à gérer ses positions normalement. La dépendance à une API ne doit pas devenir un point de défaillance unique.
  • Journalisez : enregistrez le code HTTP et un extrait de la réponse pour pouvoir diagnostiquer après coup.

Pièges fréquents

  • URL non autorisée : vérifiez que l’adresse figurant dans les options correspond bien au domaine appelé, protocole compris.
  • En-têtes mal formés : chaque en-tête doit se terminer par "\r\n".
  • Encodage : convertissez en CP_UTF8 à l’envoi comme à la réception pour préserver les accents.
  • Attente de résultat en backtest : la stratégie testée sans les données de l’API n’est pas celle qui tournera en réel. Si l’API influence les décisions, il faut un historique de ses réponses pour un test honnête.
Faire dépendre des décisions de trading d’un service externe ajoute un risque technique : panne, latence, données erronées. Testez ce scénario en démo et assurez-vous que votre robot protège ses positions même sans réponse du serveur.

Questions fréquentes

Pourquoi WebRequest renvoie-t-il -1 ?

Le plus souvent, l’URL n’a pas été ajoutée dans Outils, Options, Expert Advisors. Les autres causes sont un appel depuis un indicateur (erreur 4014), une exécution dans le Strategy Tester, un délai trop court ou un problème de réseau. Consultez GetLastError() juste après l’appel.

Peut-on utiliser WebRequest dans un indicateur ?

Non. Les indicateurs partagent un fil d’exécution avec les autres graphiques du même symbole, et la fonction y renvoie l’erreur 4014. Déplacez la logique réseau dans un EA ou un script.

WebRequest fonctionne-t-il en backtest ?

Non, la fonction ne peut pas être exécutée dans le Strategy Tester. Testez MQLInfoInteger(MQL_TESTER) pour adopter un comportement de repli, par exemple lire des données préenregistrées dans un fichier.

Quelle signature choisir ?

La version avec le paramètre headers est la plus souple : elle permet de définir le type de contenu, l’authentification et tout autre en-tête. La version avec cookie et référent ne sert qu’aux requêtes de formulaire simples.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.