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

ProRealTime · ProBacktest

OnMarket, LongOnMarket et CountOfPosition : l’état d’un système ProBacktest

OnMarket, LongOnMarket, ShortOnMarket, CountOfPosition et leurs variantes : savoir si le système est en position, dans quel sens et pour quelle taille, avec une pyramide plafonnée commentée.

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

OnMarket indique si un système ProBacktest a une position ouverte : il vaut 1 en position et 0 sinon. LongOnMarket et ShortOnMarket précisent le sens (1 si la position est acheteuse, respectivement vendeuse). CountOfPosition donne la taille de la position, positive pour un achat et négative pour une vente, tandis que CountOfLongShares et CountOfShortShares renvoient la taille de la position acheteuse ou vendeuse, et 0 sinon. Ces variables permettent de conditionner chaque ordre à l’état réel du système : ne pas entrer deux fois, ne sortir que si une position existe, plafonner une pyramide ou détecter qu’un trade vient de commencer ou de se terminer.

Cette page de la rubrique ProBacktest détaille ces variables, leur moment de mise à jour et les schémas de code les plus utiles.

Les six variables d’état

VariableValeurUsage typique
OnMarket1 si une position est ouverte, 0 sinonÉviter une double entrée
LongOnMarket1 si position acheteuse, 0 sinonConditionner un SELL
ShortOnMarket1 si position vendeuse, 0 sinonConditionner un EXITSHORT
CountOfPositiontaille, positive à l’achat, négative à la ventePlafonner, sortir partiellement
CountOfLongSharestaille de la position acheteuse, 0 sinonTaille sans signe côté achat
CountOfShortSharestaille de la position vendeuse, 0 sinonTaille sans signe côté vente

Ces définitions sont celles du manuel ProBacktest. Comme toutes les variables ProBuilder, elles ont un historique : OnMarket[1] donne l’état à la barre précédente, CountOfPosition[1] la taille à la barre précédente. Le manuel cite explicitement cette notation avec crochets.

Le moment de mise à jour

Le code d’un système est lu à la fin de chaque barre, et les ordres sont exécutés au plus tôt à l’ouverture de la barre suivante. Il en découle une règle simple : les variables d’état décrivent la situation au moment où le code est lu, pas celle qui résultera des ordres envoyés sur cette barre.

Prenons un exemple. À la clôture d’une barre, le système n’a pas de position et la condition d’achat est vraie : il envoie BUY. Juste après cette ligne, OnMarket vaut toujours 0, car l’ordre n’est pas encore exécuté. À la clôture de la barre suivante, l’achat a eu lieu à l’ouverture : OnMarket vaut 1. Ce décalage explique deux comportements :

  • une sortie suivie d’une entrée inverse dans la même lecture ne voit pas la sortie : OnMarket reste vrai sur cette barre ;
  • tester OnMarket juste après un BUY dans le même passage ne permet pas de savoir si l’ordre sera exécuté.

Schéma 1 : une seule position à la fois

C’est l’usage le plus courant. Même avec DEFPARAM CumulateOrders = False, conditionner l’entrée par NOT OnMarket rend l’intention explicite et évite d’envoyer des ordres inutiles.

IF NOT OnMarket AND conditionAchat THEN
   BUY 1 CONTRACT AT MARKET
ENDIF
IF LongOnMarket AND conditionSortie THEN
   SELL AT MARKET
ENDIF

La différence entre NOT OnMarket et NOT LongOnMarket compte dans un système à deux sens : avec NOT LongOnMarket, un achat peut être envoyé alors qu’une position vendeuse est ouverte.

Schéma 2 : détecter une entrée ou une sortie

En comparant l’état courant à celui de la barre précédente, on repère le début et la fin d’une position :

  • OnMarket AND NOT OnMarket[1] : une position a été ouverte à l’ouverture de cette barre ;
  • NOT OnMarket AND OnMarket[1] : la position a été fermée depuis la lecture précédente.

C’est utile pour initialiser des variables propres au trade (plus haut atteint depuis l’entrée, nombre de barres en position, niveau d’un stop personnalisé). Attention au cas limite : si une position est fermée puis une autre ouverte entre deux lectures, ces comparaisons ne le voient pas. Pour ce cas, les prix et index des ordres exécutés, présentés dans la page PositionPrice et TradePrice, sont plus fiables.

Pour ces variables propres au trade, gardez une règle de remise à zéro claire : réinitialisez-les au début de chaque nouvelle position, jamais avec une affectation inconditionnelle qui les écraserait à chaque barre. Le rôle de ONCE et de BarIndex dans ce type d’initialisation est expliqué dans la page ONCE et BarIndex.

Schéma 3 : une pyramide plafonnée

Avec CumulateOrders = True, chaque signal ajoute une position. CountOfPosition permet de limiter l’exposition totale. L’exemple suivant renforce une position acheteuse à chaque nouveau plus haut, sans dépasser trois contrats, et ferme le tout sur un signal de retournement.

// Pyramide plafonnée à 3 contrats
DEFPARAM CumulateOrders = True        // cumul autorisé, contrôlé par le code
DEFPARAM PreLoadBars = 200

tailleMax = 3                         // exposition maximale en contrats
mm = Average[50](Close)
nouveauPlusHaut = Close > Highest[20](High)[1]

// Entrée initiale ou renfort, tant que le plafond n'est pas atteint
IF Close > mm AND nouveauPlusHaut AND COUNTOFPOSITION < tailleMax THEN
   BUY 1 CONTRACT AT MARKET
ENDIF

// Sortie de toute la position sous la moyenne
IF LongOnMarket AND Close < mm THEN
   SELL AT MARKET
ENDIF

// Détection des débuts de position pour le diagnostic
nouvellePosition = OnMarket AND NOT OnMarket[1]
IF nouvellePosition THEN
   nbPositions = nbPositions + 1
ENDIF

SET STOP %LOSS 3                      // protection de l'ensemble de la position

GRAPH COUNTOFPOSITION AS "Taille de la position"
GRAPH nbPositions AS "Positions ouvertes depuis le début"

Le plafond fonctionne parce que CountOfPosition est relu à chaque barre. Notez qu’un ordre envoyé sur une barre n’est pas encore compté : si deux signaux surviennent sur deux barres consécutives alors que la taille est de 2, le premier ordre porte la taille à 3 et le second est bloqué par la condition à la lecture suivante. Le plafond est donc respecté, mais vérifiez toujours la taille maximale réellement atteinte avec GRAPH COUNTOFPOSITION.

Le manuel rappelle aussi que la taille maximale de position définie dans la gestion du risque de la plateforme ou de ProOrder prévaut sur une quantité plus grande demandée par le code. Ne comptez pas sur ce réglage pour corriger une erreur de logique : codez le plafond vous-même.

Schéma 4 : sortie partielle selon la taille

CountOfPosition sert aussi à sortir d’une fraction de la position. Pour une position acheteuse de 4 contrats, SELL 2 CONTRACTS AT MARKET en ferme la moitié. Pour un code générique, calculez la quantité à partir de CountOfLongShares (ou de CountOfShortShares côté vendeur), et protégez la sortie par une variable de contrôle pour qu’elle ne se répète pas à chaque barre.

Les pièges fréquents

  • Oublier le signe de CountOfPosition. Il est négatif pour une position vendeuse : CountOfPosition < 3 est toujours vrai en position vendeuse. Utilisez ABS(CountOfPosition) ou CountOfShortShares côté vente.
  • Supposer qu’un ordre est exécuté dans la même lecture. Les variables d’état ne changent qu’à la lecture suivante.
  • Confondre « pas en position » et « pas encore tradé aujourd’hui ». Après un stop touché, OnMarket redevient 0 et le système peut reprendre une position le jour même. Pour limiter le nombre de trades, il faut un compteur dédié.
  • Utiliser NOT LongOnMarket dans un système à deux sens alors que l’on voulait NOT OnMarket.
  • Écrire des conditions illisibles. Stockez l’état dans des variables nommées (enPositionAchat, pyramideComplete) ; les règles de combinaison de conditions sont rappelées dans la page IF, ELSE, ENDIF.
Une pyramide augmente l’exposition à mesure que le marché évolue en votre faveur, mais aussi la perte potentielle en cas de retournement brutal. Plafonnez toujours la taille totale, intégrez des coûts réalistes et testez en démo avant tout usage réel.

FAQ

OnMarket vaut-il 1 juste après un BUY ?

Non. L’ordre est exécuté à l’ouverture de la barre suivante ; OnMarket ne passe à 1 qu’à la lecture suivante du code, une fois la position effectivement ouverte.

Comment connaître la taille d’une position vendeuse ?

CountOfPosition renvoie une valeur négative, par exemple -2 pour deux contrats vendus. CountOfShortShares renvoie la même taille en valeur positive, et 0 en l’absence de position vendeuse.

Comment détecter la fin d’un trade ?

En testant NOT OnMarket AND OnMarket[1] : le système était en position à la lecture précédente et ne l’est plus. Pour des sorties suivies immédiatement d’une nouvelle entrée, combinez avec TradeIndex.

Faut-il NOT OnMarket si CumulateOrders vaut False ?

Ce n’est pas strictement nécessaire pour éviter le cumul, mais c’est recommandé : le code exprime clairement l’intention et vous évitez des ordres inverses involontaires dans un système à deux sens.

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.