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.
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
| Variable | Valeur | Usage typique |
|---|---|---|
| OnMarket | 1 si une position est ouverte, 0 sinon | Éviter une double entrée |
| LongOnMarket | 1 si position acheteuse, 0 sinon | Conditionner un SELL |
| ShortOnMarket | 1 si position vendeuse, 0 sinon | Conditionner un EXITSHORT |
| CountOfPosition | taille, positive à l’achat, négative à la vente | Plafonner, sortir partiellement |
| CountOfLongShares | taille de la position acheteuse, 0 sinon | Taille sans signe côté achat |
| CountOfShortShares | taille de la position vendeuse, 0 sinon | Taille 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 :
OnMarketreste vrai sur cette barre ; - tester
OnMarketjuste après unBUYdans 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 < 3est toujours vrai en position vendeuse. UtilisezABS(CountOfPosition)ouCountOfShortSharescô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é,
OnMarketredevient 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 LongOnMarketdans un système à deux sens alors que l’on voulaitNOT 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.
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.
- Premier backtest ProBacktest
- DEFPARAM
- BUY, SELL, SELLSHORT, EXITSHORT
- SET STOP et SET TARGET
- PositionPrice et TradePrice
- Ordres limites et stop
- Trailing stop en ProBacktest
- Money management et taille de position
- Optimiser les variables
- Walk-forward dans ProRealTime
- Lire les résultats de ProBacktest
- Backtest tick par tick
