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

ProRealTime · ProBuilder

Syntaxe de base du ProBuilder : structure, commentaires et règles d’écriture

Exécution barre par barre, variables sans déclaration, commentaires, crochets pour l’historique et RETURN final : les règles de syntaxe de ProBuilder expliquées avec un indicateur complet.

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

Un programme ProBuilder est une suite d’instructions, une par ligne, que ProRealTime exécute une fois pour chaque barre du graphique, de la plus ancienne à la plus récente. Il n’y a ni déclaration de variables, ni types, ni fonction principale : vous écrivez vos calculs, puis vous terminez par RETURN pour indiquer ce qui doit s’afficher. Majuscules et minuscules sont équivalentes, les commentaires s’écrivent avec //, /* ... */ ou REM, et la valeur d’une donnée sur une barre passée se lit avec des crochets, par exemple Close[1].

Ces quelques règles suffisent pour écrire un indicateur fonctionnel. Cette page les détaille une à une, avec leurs conséquences pratiques. Elle fait partie de la rubrique Le langage ProBuilder, dont elle constitue le point de départ.

Le modèle d’exécution : un passage par barre

C’est la notion la plus importante, et celle qui déroute le plus les développeurs venus d’autres langages. Lorsque vous appliquez un indicateur à un graphique, la plateforme ne lance pas votre code une seule fois : elle le relit sur chaque bougie de l’historique. Sur la barre courante, Close désigne la clôture de cette barre, Close[1] celle de la barre précédente, et ainsi de suite.

Conséquence directe : vous n’avez pas besoin de boucle pour parcourir l’historique. Pour calculer l’écart entre la clôture et l’ouverture de chaque bougie, une seule ligne suffit, et le résultat est automatiquement calculé sur toutes les barres :

corps = Close - Open    // calculé sur chaque barre de l'historique
RETURN corps

Chaque variable que vous créez possède aussi son propre historique. Si vous écrivez corps[2], vous obtenez la valeur de corps deux barres plus tôt. La documentation officielle le résume ainsi : l’historique peut être lu mais jamais modifié. Une instruction comme corps[2] = 0 est donc invalide.

Autre conséquence : une variable est recalculée à chaque barre. Si vous voulez qu’elle conserve une valeur d’une barre à l’autre (un compteur, un plus haut atteint depuis un signal), il suffit de ne pas la réaffecter systématiquement ; et pour qu’une initialisation ne se fasse qu’une fois, ProBuilder propose l’instruction ONCE, présentée dans le guide ONCE et BarIndex.

Les règles d’écriture

Une instruction par ligne

Chaque ligne contient une instruction : une affectation, un mot-clé de structure (IF, ENDIF, FOR, NEXT…), une instruction graphique ou RETURN. Il n’y a pas de point-virgule de fin de ligne. Les blocs ne sont pas délimités par des accolades mais par des mots-clés d’ouverture et de fermeture : IF ... ENDIF, FOR ... NEXT, WHILE ... WEND.

Majuscules et minuscules

ProBuilder ne fait aucune différence entre majuscules et minuscules. close, Close et CLOSE désignent la même donnée, et maVariable et MAVARIABLE la même variable. L’usage le plus lisible consiste à écrire les mots-clés en majuscules (IF, THEN, RETURN) et les variables en casse mixte (moyenneRapide). Attention au corollaire : deux variables qui ne diffèrent que par la casse sont en réalité une seule variable.

Les noms de variables

Un nom de variable ne doit pas reprendre un mot réservé du langage (Close, Average, Volume, High…). Le manuel officiel déconseille aussi les caractères spéciaux dans le code, en citant explicitement les lettres accentuées, le tiret et le tiret bas. Préférez donc prixEntree à prix_entrée. Les noms explicites rendent le code bien plus facile à relire : mmRapide vaut mieux que a.

Les commentaires

Trois formes de commentaires sont acceptées :

  • // commente la fin de la ligne ;
  • /* ... */ commente un bloc de plusieurs lignes ;
  • REM en début de ligne commente la ligne entière.

Les commentaires sont ignorés à l’exécution et n’affectent pas les performances. L’éditeur les affiche en gris et propose un bouton pour commenter ou décommenter une sélection, très pratique pour désactiver temporairement une partie du code.

L’affectation et l’égalité

Le même symbole = sert à l’affectation et au test d’égalité. Dans x = 5, isolée sur une ligne, il s’agit d’une affectation ; dans IF x = 5 THEN, d’une comparaison. La différence s’écrit <>. Les autres opérateurs de comparaison sont <, <=, >, >=. Le guide Variables et calculs détaille les opérateurs arithmétiques et les fonctions mathématiques.

Les données de prix disponibles

ProBuilder fournit directement les constantes de prix de la barre courante : Open, High, Low, Close et Volume, ainsi que des prix dérivés comme MedianPrice, TypicalPrice, WeightedClose, TotalPrice et Range (écart entre le plus haut et le plus bas). Les fonctions DOpen(n), DHigh(n), DLow(n) et DClose(n) donnent les prix journaliers du jour n (0 pour aujourd’hui). Les indicateurs prédéfinis s’appellent avec une syntaxe constante : paramètres entre crochets, série de prix entre parenthèses, par exemple Average[20](Close) ou RSI[14](Close). Leur fonctionnement détaillé est décrit dans la rubrique des instructions, à commencer par Average.

La structure type d’un indicateur

Un indicateur bien organisé suit généralement le même plan : paramètres et réglages en tête, calculs, conditions, puis affichage.

// ===== Réglages (DEFPARAM toujours en tout début de code) =====
DEFPARAM CALCULATEONLASTBARS = 1000   // calcul limité aux 1000 dernières barres

// ===== Calculs =====
periode = 14                          // période du canal
hautCanal = Highest[periode](High)    // plus haut des 14 dernières barres
basCanal = Lowest[periode](Low)       // plus bas des 14 dernières barres
milieu = (hautCanal + basCanal) / 2   // milieu du canal

// ===== Conditions =====
IF Close > milieu THEN
   position = 1                       // clôture dans la moitié haute
ELSE
   position = -1                      // clôture dans la moitié basse
ENDIF

// ===== Affichage (RETURN est la dernière instruction) =====
RETURN hautCanal AS "Haut", basCanal AS "Bas", milieu AS "Milieu"

Trois règles de placement sont à retenir. Les instructions DEFPARAM doivent figurer au début du code. RETURN est utilisée une seule fois, sur la dernière ligne. Entre les deux, l’ordre des lignes compte : une variable doit être calculée avant d’être utilisée, sinon elle vaut zéro sur la barre en cours.

RETURN : la sortie obligatoire

Un indicateur se termine toujours par RETURN. Cette instruction indique les valeurs à tracer, séparées par des virgules, éventuellement nommées avec AS et colorées avec COLOURED. Un RETURN seul, sans valeur, est aussi possible : c’est ce qu’on utilise quand l’indicateur ne fait que dessiner des objets graphiques (flèches, textes). Toutes les options d’affichage sont présentées dans le guide RETURN et affichage des courbes.

Créer et appliquer un indicateur dans l’éditeur

Dans ProRealTime, la création d’un indicateur passe par le menu des indicateurs : on choisit de créer un nouvel indicateur, on saisit son nom, puis on écrit le code dans la zone d’édition. L’éditeur offre une liste des fonctions à insérer, la recherche et le remplacement, l’annulation et le commentaire automatique. Une fois validé, l’indicateur apparaît dans votre liste personnelle et s’applique comme n’importe quel indicateur prédéfini, soit sur le graphique des prix, soit dans un panneau séparé.

L’éditeur permet aussi de définir des variables paramétrables (période, seuil, type de moyenne) qui apparaîtront dans la fenêtre de réglages de l’indicateur, sans avoir à modifier le code. Cette fonctionnalité est traitée dans le guide des variables optimisables de cette rubrique.

Les pièges de syntaxe les plus courants

  • Oublier THEN ou ENDIF. Chaque IF exige un THEN et un ENDIF correspondant ; avec des conditions imbriquées, il faut autant de ENDIF que de IF.
  • Placer RETURN ailleurs qu’en fin de code, ou en écrire plusieurs.
  • Vouloir modifier le passé, par exemple x[1] = 0.
  • Placer un DEFPARAM après des calculs.
  • Confondre la barre courante et la barre précédente : une condition sur Close est évaluée sur une bougie encore en formation tant qu’elle n’est pas clôturée, ce qui peut faire apparaître puis disparaître un signal en temps réel.
  • Utiliser un nom réservé comme nom de variable.

Le guide des erreurs fréquentes en ProBuilder explique comment diagnostiquer et corriger chacun de ces cas.

FAQ

Faut-il déclarer les variables en ProBuilder ?

Non. Une variable est créée dès sa première affectation, sans type ni déclaration. Si elle n’a jamais été affectée sur une barre, elle vaut zéro par défaut. Cette souplesse impose en contrepartie de bien initialiser vos variables, sinon un calcul peut utiliser silencieusement la valeur 0.

ProBuilder est-il sensible à la casse ?

Non. Majuscules et minuscules sont équivalentes pour les mots-clés comme pour les variables. Close et CLOSE désignent la même donnée, et deux variables qui ne diffèrent que par la casse sont une seule et même variable.

Comment écrire un commentaire sur plusieurs lignes ?

Encadrez le bloc avec /* au début et */ à la fin. Pour une seule ligne, utilisez // ou REM. Les commentaires sont ignorés à l’exécution.

Pourquoi mon code n’a-t-il pas besoin de boucle pour parcourir l’historique ?

Parce que ProRealTime exécute le programme une fois sur chaque barre. Une ligne comme corps = Close – Open est donc calculée automatiquement sur toutes les bougies. Les boucles FOR et WHILE servent uniquement à des calculs internes à une barre, par exemple compter des bougies passées.

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.