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

ProRealTime · ProBuilder

Erreurs fréquentes en ProBuilder : diagnostiquer et corriger son code

ENDIF manquant, RETURN mal placé, DEFPARAM hors tête de code, historique modifié, boucle infinie, TIMEFRAME invalide : les erreurs ProBuilder les plus courantes et leur correction.

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

La plupart des erreurs en ProBuilder relèvent de quelques familles bien identifiées : un bloc mal fermé (ENDIF, NEXT ou WEND manquant), un RETURN absent, multiple ou mal placé, un DEFPARAM qui n’est pas en tête de code, une tentative de modifier l’historique (x[1] = 0), une boucle sans sortie, ou une règle de TIMEFRAME non respectée. S’y ajoutent des erreurs plus sournoises, qui ne bloquent pas la validation mais faussent le résultat : variable non réinitialisée, division par zéro, historique insuffisant, signal calculé sur une bougie non clôturée.

Cette page passe en revue ces erreurs, explique comment les reconnaître et comment les corriger, puis propose une méthode de débogage. Elle conclut la rubrique Le langage ProBuilder et renvoie, pour chaque notion, au guide détaillé.

Les erreurs de syntaxe : le code ne se valide pas

Ces erreurs sont détectées à la validation : l’éditeur refuse le code et signale la ligne en cause. Le message n’indique pas toujours la cause exacte, mais la ligne pointée, ou celle juste avant, est le bon point de départ.

Bloc non fermé

Chaque IF exige un THEN et un ENDIF, chaque FOR un DO et un NEXT, chaque WHILE un DO et un WEND. Avec des conditions imbriquées, il faut autant de ENDIF que de IF. L’erreur se produit souvent en transformant un ELSIF en ELSE IF : ce second IF ouvre un nouveau bloc qui réclame son propre ENDIF. Indentez votre code : un bloc mal fermé saute alors aux yeux.

RETURN absent, multiple ou mal placé

Le manuel officiel précise que RETURN s’utilise une fois et une seule, et il doit figurer en fin de code. Pour renvoyer plusieurs valeurs, séparez-les par des virgules dans ce même RETURN. Un indicateur qui ne fait que dessiner se termine par un RETURN sans valeur.

DEFPARAM mal placé

Les instructions DEFPARAM (CALCULATEONLASTBARS, DRAWONLASTBARONLY, ou les paramètres d’un système de trading) doivent être écrites au tout début du code, avant tout calcul. Le manuel le signale explicitement.

Noms invalides

Un nom de variable ne doit pas reprendre un mot réservé (Close, High, Average, Volume…). Le manuel déconseille aussi les caractères spéciaux, en citant les lettres accentuées, le tiret et le tiret bas : prixEntree plutôt que prix_entrée. Les règles d’écriture sont rappelées dans le guide Syntaxe de base du ProBuilder.

Instruction hors de son contexte

BREAK et CONTINUE ne s’utilisent qu’à l’intérieur d’une boucle ; ailleurs, ils provoquent une erreur. De même, les styles HISTOGRAM et POINT ne s’appliquent qu’aux valeurs d’un RETURN.

Les erreurs de logique : le code tourne mais le résultat est faux

Modifier le passé

MaVariable[3] = 42 n’est pas une instruction valide : l’historique d’une variable peut être lu mais jamais modifié. Si votre algorithme semble l’exiger, c’est généralement qu’il faut mémoriser la valeur dans une autre variable au moment où elle se produit, ou utiliser un tableau $. Attention, les tableaux ne sont pas historisés : $t[i][1] est lui aussi invalide (voir Tableaux ($tableau)).

Variable « collée » à sa dernière valeur

Une variable qui n’est pas réaffectée sur une barre conserve sa valeur précédente. Un signal mis à 1 dans un IF reste donc à 1 indéfiniment si rien ne le remet à 0. Réinitialisez la variable avant le IF, ou prévoyez une branche ELSE.

Accumulateur non initialisé

À l’inverse, une somme calculée dans une boucle doit être remise à zéro avant la boucle, sur chaque barre. Sinon elle s’additionne d’une barre à l’autre. La documentation rappelle aussi qu’une condition inconnue est traitée comme 0, ce qui peut modifier le comportement d’une boucle dont la variable n’a pas été initialisée.

Division par zéro

Un dénominateur comme High - Low peut être nul sur une bougie sans mouvement. Testez-le avant de diviser et prévoyez une valeur de repli.

Historique insuffisant

Sur les premières barres du graphique, Average[200](Close) ou Close[150] ne disposent pas d’assez de données. La documentation de Highest recommande de veiller à ce que la période ne dépasse pas les données disponibles. Filtrez les premières barres avec BarIndex et utilisez Undefined pour ne rien tracer tant que le calcul n’est pas fiable.

Tester Undefined

On ne peut pas tester directement si une variable vaut Undefined : dans une condition, elle se comporte comme 0. Prévoyez une variable indicatrice séparée si vous devez savoir qu’une valeur a été définie.

Les erreurs de performance et de blocage

  • Boucle infinie : une condition WHILE qui ne devient jamais fausse bloque le calcul. Ajoutez toujours un compteur et une borne maximale. Le manuel insiste sur la nécessité d’une condition de sortie valide pour toute boucle FOR ou WHILE.
  • Boucles trop lourdes : une boucle est exécutée sur chaque barre de l’historique ; deux boucles imbriquées de 100 itérations représentent 10 000 opérations par barre. Remplacez-les par des fonctions natives (Highest, Summation, Average) quand c’est possible, sortez tôt avec BREAK, et limitez le calcul avec DEFPARAM CALCULATEONLASTBARS.
  • Trop d’objets graphiques : des milliers de textes ou de segments ralentissent l’affichage. Dessinez sur la dernière barre uniquement lorsque c’est suffisant.

Le guide Boucles FOR et WHILE détaille ces points.

Les erreurs propres au multi-unités de temps

TIMEFRAME n’accepte que des unités supérieures à celle du graphique et qui en sont des multiples. Une variable calculée dans une unité ne peut pas être réaffectée dans une autre, même si elle peut y être lue. Enfin, oublier TIMEFRAME(DEFAULT) laisse le reste du code dans l’unité supérieure. Ces règles sont expliquées dans le guide TIMEFRAME : multi-unités de temps.

Les signaux trompeurs

Certains codes sont syntaxiquement corrects mais donnent une image faussement favorable :

  • Bougie non clôturée : en temps réel, la dernière barre est relue à chaque variation de prix. Un signal peut apparaître puis disparaître. Sur l’historique, on ne voit que l’état final, ce qui rend le signal plus fiable en apparence qu’il ne l’est.
  • Information future : détecter un sommet sur la barre courante en le comparant aux barres suivantes est impossible en direct. Un sommet se confirme toujours avec retard.
  • Mode DEFAULT de TIMEFRAME : la valeur de l’unité supérieure évolue tant que sa bougie n’est pas clôturée.

Ces biais expliquent une bonne partie des écarts entre ProOrder et ProBacktest.

Exemple : un code erroné et sa correction

Le code suivant cumule plusieurs erreurs classiques : DEFPARAM après un calcul, signal jamais remis à zéro, division non protégée, ENDIF manquant et deux RETURN.

// VERSION ERRONÉE
mm = Average[50](Close)
DEFPARAM CALCULATEONLASTBARS = 500        // erreur : DEFPARAM doit être en tête
ratio = (Close - Low) / (High - Low)      // erreur : division par zéro possible
IF Close CROSSES OVER mm THEN
   signal = 1                             // erreur : signal jamais remis à 0
                                          // erreur : ENDIF manquant
RETURN signal
RETURN ratio                              // erreur : second RETURN
// VERSION CORRIGÉE
DEFPARAM CALCULATEONLASTBARS = 500        // en tout début de code

mm = Average[50](Close)

amplitude = High - Low
IF amplitude > 0 THEN
   ratio = (Close - Low) / amplitude      // position de la clôture dans la bougie (0 à 1)
ELSE
   ratio = 0.5                            // bougie sans amplitude : valeur neutre
ENDIF

signal = 0                                // réinitialisé à chaque barre
IF BarIndex > 50 AND Close CROSSES OVER mm THEN
   signal = 1
ENDIF

RETURN signal AS "Signal", ratio AS "Ratio"   // un seul RETURN, valeurs séparées par des virgules

Une méthode de débogage efficace

  1. Validez souvent. Ajoutez quelques lignes, validez, puis continuez : une erreur est bien plus facile à localiser dans dix lignes nouvelles que dans cent.
  2. Affichez les valeurs intermédiaires dans le RETURN ou, dans les versions récentes, avec PRINT, qui montre les valeurs barre par barre dans une fenêtre dédiée.
  3. Commentez des blocs avec /* ... */ pour isoler la partie fautive.
  4. Testez sur un cas simple dont vous connaissez la réponse, par exemple quelques bougies que vous pouvez vérifier à la main.
  5. Comparez avec l’instruction native quand vous recalculez un indicateur existant : les deux courbes doivent se superposer.
Un code sans erreur de syntaxe n’est pas un code fiable pour trader. Vérifiez la logique en temps réel et en démo avant toute utilisation sur un compte réel.

FAQ

Pourquoi l’éditeur refuse-t-il de valider mon code ?

Le plus souvent, un bloc n’est pas fermé (ENDIF, NEXT ou WEND manquant), un THEN ou un DO est oublié, le RETURN est absent ou dupliqué, ou un DEFPARAM n’est pas en tête du code. Examinez la ligne signalée et celles qui la précèdent.

Pourquoi ne puis-je pas écrire maVariable[1] = 0 ?

Parce que l’historique d’une variable est en lecture seule en ProBuilder. Seule la valeur de la barre courante peut être affectée. Mémorisez la valeur qui vous intéresse dans une autre variable au moment où elle se produit.

Pourquoi mon indicateur affiche-t-il des valeurs aberrantes au début du graphique ?

Parce que les calculs qui utilisent de longues périodes manquent d’historique sur les premières barres, et que les variables non affectées valent 0. Filtrez ces barres avec un test sur BarIndex et affectez Undefined aux valeurs à ne pas tracer.

Mon signal apparaît puis disparaît en temps réel : est-ce un bug ?

Non, c’est le comportement normal d’une condition évaluée sur une bougie en formation. Pour un signal définitif, testez la condition sur la barre précédente, clôturée, et dessinez l’éventuel objet sur cette barre.

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.