ProRealTime · ProBacktest
BUY, SELL, SELLSHORT et EXITSHORT : passer des ordres dans ProBacktest
Les quatre instructions d’ordres de ProBacktest, leur syntaxe, les unités de quantité dont CASH, les sorties partielles et le retournement de position, avec un système long/short commenté.
ProBacktest utilise quatre instructions d’ordres : BUY ouvre ou renforce une position acheteuse, SELL la ferme totalement ou partiellement, SELLSHORT ouvre ou renforce une position vendeuse (vente à découvert) et EXITSHORT la ferme. Chacune s’écrit selon le même modèle, Instruction Quantité Unité AT Type, par exemple BUY 2 CONTRACTS AT MARKET ou SELLSHORT 1 LOT AT 18200 STOP. Le piège principal vient de l’anglais : SELL ne vend jamais à découvert, il solde un achat. Sans position acheteuse ouverte, il n’a aucun effet.
Cette page fait partie de la rubrique ProBacktest : coder et tester un système. Elle détaille la syntaxe, les unités de quantité, les sorties partielles et la façon d’organiser un système acheteur et vendeur sans ambiguïté.
Quatre instructions, deux sens
| Instruction | Action | Sens | Sans position correspondante |
|---|---|---|---|
| BUY | Ouvre ou renforce | Acheteur | Ouvre une position |
| SELL | Ferme totalement ou partiellement | Acheteur | Aucun effet |
| SELLSHORT | Ouvre ou renforce | Vendeur | Ouvre une position |
| EXITSHORT | Ferme totalement ou partiellement | Vendeur | Aucun effet |
Le manuel ProBacktest précise que SELL n’a pas d’effet sans position acheteuse et EXITSHORT pas d’effet sans position vendeuse. Cette séparation stricte entre ouverture et fermeture, et entre sens acheteur et vendeur, rend le code explicite : en lisant une ligne, on sait toujours quelle position elle concerne.
La syntaxe complète
// Modèle général : Instruction Quantité Unité AT Type
BUY 1 SHARES AT MARKET // achat de 1 action au marché
SELLSHORT 2 CONTRACTS AT MARKET // vente à découvert de 2 contrats
SELL AT MARKET // ferme toute la position acheteuse
EXITSHORT 1 CONTRACT AT MARKET // rachète 1 contrat de la position vendeuse
La quantité et ses unités
Selon le manuel, les mots SHARES, SHARE, CONTRACT, CONTRACTS, LOT et LOTS sont interchangeables : ils désignent tous une quantité d’unités de l’instrument. Choisissez celui qui correspond à votre marché pour la lisibilité (actions pour un titre, contrats pour un indice ou un future, lots pour le Forex) et gardez-le dans tout le code. Pour le Forex, le manuel indique que la quantité est multipliée par la taille du lot.
La quantité peut être un nombre ou une variable : BUY nContrats CONTRACTS AT MARKET est valide. C’est ce qui permet de calculer la taille de position dans le code, comme l’explique la page Money management et taille de position.
L’unité CASH
CASH exprime la quantité en montant de devise plutôt qu’en nombre d’unités : BUY 1000 CASH AT MARKET achète pour environ 1 000 unités de la devise de l’instrument. Le manuel précise que CASH n’est utilisable que pour l’achat ou la vente d’actions, et que la quantité obtenue est arrondie à l’inférieur par défaut ; il mentionne le mot-clé ROUNDEDUP pour arrondir au supérieur. Sur un indice, un future ou une paire de devises, utilisez une quantité en contrats ou en lots.
Les quantités par défaut
Si vous omettez la quantité, le manuel prévoit :
- 1 unité pour une entrée :
BUY AT MARKETachète une unité ; - toute la position pour une sortie :
SELL AT MARKETferme l’intégralité de la position acheteuse.
Pour les entrées, écrivez toujours la quantité, même lorsqu’elle vaut 1 : le code est plus clair et plus facile à faire évoluer. Pour les sorties totales, omettre la quantité est au contraire la façon la plus sûre de ne rien laisser ouvert.
Les types d’exécution
Le mot qui suit AT définit le type d’ordre :
AT MARKET: selon le manuel, l’ordre est placé au prix du marché à l’ouverture de la barre suivante ;AT prix LIMIT: ordre limite, exécuté au prix indiqué ou mieux ;AT prix STOP: ordre stop, déclenché lorsque le prix atteint le niveau.
Les ordres limites et stop ne sont valables qu’une barre par défaut. Leur fonctionnement, et la façon de les maintenir actifs, sont expliqués dans la page Ordres limites et stop.
Les sorties partielles
SELL et EXITSHORT acceptent une quantité inférieure à la position : on ferme alors une partie seulement. C’est la technique classique pour encaisser une partie du gain à un premier objectif et laisser courir le reste.
Pour connaître la taille de la position avant de la réduire, utilisez CountOfPosition, positif pour une position acheteuse et négatif pour une position vendeuse. Une sortie partielle doit être conditionnée pour ne pas se répéter à chaque barre : sans garde, une condition qui reste vraie réduirait la position barre après barre jusqu’à la fermer.
Un système acheteur et vendeur complet
L’exemple suivant trade dans les deux sens sur un croisement de moyennes, ferme la moitié de la position quand le gain latent atteint un seuil, et sort du reste sur le croisement inverse.
// Système long/short avec sortie partielle
DEFPARAM CumulateOrders = False
mmRapide = ExponentialAverage[12](Close)
mmLente = ExponentialAverage[26](Close)
haussier = mmRapide CROSSES OVER mmLente
baissier = mmRapide CROSSES UNDER mmLente
seuil = 1.5 // gain latent en % déclenchant la sortie partielle
// --- Sorties sur signal inverse (écrites avant les entrées) ---
IF LongOnMarket AND baissier THEN
SELL AT MARKET // ferme tout l'achat
ENDIF
IF ShortOnMarket AND haussier THEN
EXITSHORT AT MARKET // rachète toute la vente
ENDIF
// --- Entrées ---
IF NOT OnMarket AND haussier THEN
BUY 2 CONTRACTS AT MARKET
partielFaite = 0 // nouvelle position : sortie partielle à refaire
ENDIF
IF NOT OnMarket AND baissier THEN
SELLSHORT 2 CONTRACTS AT MARKET
partielFaite = 0
ENDIF
// --- Sortie partielle : une seule fois par position ---
IF LongOnMarket AND partielFaite = 0 AND Close > PositionPrice * (1 + seuil / 100) THEN
SELL 1 CONTRACT AT MARKET
partielFaite = 1
ENDIF
IF ShortOnMarket AND partielFaite = 0 AND Close < PositionPrice * (1 - seuil / 100) THEN
EXITSHORT 1 CONTRACT AT MARKET
partielFaite = 1
ENDIF
SET STOP %LOSS 1 // protection commune aux deux sens
Trois choix méritent une explication :
- Les entrées exigent
NOT OnMarket. Comme le code est lu en fin de barre, la position fermée par unSELLne l’est qu’à l’ouverture de la barre suivante : sur la barre du croisement,OnMarketest encore vrai et l’entrée inverse attend la barre suivante. Le système perd une barre, mais chaque transition est explicite. Les variables d’état sont détaillées dans la page OnMarket et CountOfPosition. - La variable
partielFaiteempêche de répéter la sortie partielle. Elle est remise à zéro à chaque nouvelle entrée. PositionPricedonne le prix moyen de la position ; il sert de référence au calcul du gain latent.
Le retournement de position
Avec CumulateOrders = False, envoyer un SELLSHORT alors qu’une position acheteuse est ouverte ne cumule pas les deux sens : la position acheteuse est clôturée et une position vendeuse est ouverte à la place. C’est un raccourci pratique pour un système toujours en position, mais il rend la logique moins lisible et peut surprendre lorsque deux ordres opposés sont déclenchés dans la même barre. Vérifiez toujours dans la liste des ordres du rapport détaillé que le résultat correspond à votre intention, et préférez des sorties explicites tant que votre système n’est pas validé.
Les pièges fréquents
- Utiliser
SELLpour vendre à découvert. Sans position acheteuse, la ligne est ignorée et aucune erreur n’est signalée. - Oublier la garde
NOT LongOnMarketavecCumulateOrders = True: chaque barre où la condition est vraie ajoute une position. - Écrire
CASHsur un indice ou un future : cette unité est réservée aux actions. - Supposer une exécution à la clôture. L’ordre au marché part à l’ouverture de la barre suivante ; un écart d’ouverture se répercute sur le prix d’entrée.
- Mélanger les unités dans un même système : cela ne change pas le calcul, mais nuit à la relecture.
- Répéter une sortie partielle faute de variable de contrôle.
- Coder les conditions de croisement à la main :
CROSSES OVERetCROSSES UNDERsont plus sûrs, voir la page CROSSES OVER et CROSSES UNDER.
FAQ
Quelle différence entre SELL et SELLSHORT ?
SELL ferme une position acheteuse ; SELLSHORT ouvre une position vendeuse. Pour parier sur la baisse, on écrit SELLSHORT, puis on ferme avec EXITSHORT.
Que se passe-t-il si j’écris SELL AT MARKET sans quantité ?
Toute la position acheteuse est fermée. Le manuel prévoit en effet que la quantité par défaut d’une sortie est la totalité de la position, alors qu’elle vaut 1 pour une entrée.
Peut-on utiliser une variable comme quantité ?
Oui. BUY n CONTRACTS AT MARKET est valide, ce qui permet de calculer la taille dans le code. Veillez à ce que la variable ne soit jamais nulle ou négative au moment de l’ordre.
Faut-il écrire SHARES, CONTRACTS ou LOTS ?
Le manuel les rend interchangeables. Choisissez le terme adapté à l’instrument pour la lisibilité, en sachant que pour le Forex la quantité est multipliée par la taille du lot.
- Premier backtest ProBacktest
- DEFPARAM
- SET STOP et SET TARGET
- OnMarket et CountOfPosition
- 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
