ProRealTime · ProScreener
Créer son premier ProScreener : de l’interface au premier code
Ouvrir ProScreener, choisir le mode de création, définir la liste d’instruments et la période, écrire un premier code avec SCREENER et l’exécuter : le guide pas à pas pour démarrer avec le scanner de ProRealTime.
Pour créer votre premier ProScreener, ouvrez le module depuis le menu « Affichage », puis « ProScreener ». L’icône en forme de clé ouvre la « Gestion ProScreeners », où le bouton « Créer » lance la fenêtre de création. Vous choisissez alors entre la « Programmation assistée », sans écrire de code, et la « Création par programmation », où vous rédigez les conditions en ProBuilder. Le code se termine toujours par l’instruction SCREENER[condition]. Vous définissez ensuite la liste d’instruments à scanner et la période, puis vous lancez la recherche avec « Exécuter ProScreener » : les valeurs qui remplissent la condition s’affichent dans la fenêtre de résultats.
Cette page détaille ces étapes et propose un premier code complet. Elle fait partie de la rubrique ProScreener : scanner le marché.
Étape 1 : ouvrir le module et créer un screener
Le manuel décrit le chemin suivant :
- Menu « Affichage », puis « ProScreener » : la fenêtre du module s’ouvre.
- Icône en forme de clé : elle ouvre la « Gestion ProScreeners », qui liste vos screeners.
- Bouton « Créer » pour un nouveau screener, ou « Modifier » pour un screener existant.
Vous arrivez alors dans la fenêtre de création, qui propose deux modes.
Étape 2 : choisir le mode de création
- Programmation assistée. Vous construisez les conditions à partir de menus, sans écrire de code. C’est pratique pour un filtre simple et pour découvrir les indicateurs disponibles, mais limité dès que la logique se complique.
- Création par programmation. Vous écrivez le code en ProBuilder. C’est le mode utilisé dans tous les guides de cette rubrique, car il donne accès à toute la puissance du langage.
En mode programmation, le bouton « Insérer Fonction » ouvre une bibliothèque de fonctions classées par catégories, et le bouton « Ajouter » insère la fonction choisie dans la zone de code. C’est un bon moyen de vérifier la syntaxe exacte d’un indicateur sans quitter l’éditeur.
Étape 3 : définir la liste et la période
La fenêtre de programmation comporte, en plus de la zone de code, des réglages qui déterminent où et comment le screener cherche :
- le type de sélection sur lequel s’applique le screener : un groupe, une liste personnalisée ou un secteur. Le manuel cite par exemple des groupes de marchés comme les actions françaises ou les actions du NASDAQ ;
- la période utilisée pour la recherche, c’est-à-dire l’unité de temps des bougies (journalière, horaire, etc.) ;
- le sens du tri des résultats, qui ne s’écrit pas dans le code mais se choisit dans la fenêtre.
Choisissez une liste cohérente avec votre code. Un screener de volume n’a pas de sens sur des instruments qui ne publient pas de volume exploitable ; un screener intraday sur des valeurs peu liquides donnera des signaux bruités.
Étape 4 : écrire un premier code
Commençons par un filtre de tendance simple et lisible : sélectionner les valeurs dont la clôture est au-dessus de leur moyenne de 50 périodes, elle-même orientée à la hausse, et trier le résultat selon l’écart en pourcentage entre la clôture et la moyenne.
// Premier screener : valeurs en tendance haussière au-dessus de la MM50
mm50 = Average[50](Close) // moyenne arithmétique 50 périodes
c1 = Close > mm50 // la clôture est au-dessus de la moyenne
c2 = mm50 > mm50[5] // la moyenne monte depuis 5 barres
// Critère de tri : écart en % entre la clôture et la moyenne
ecart = (Close - mm50) / mm50 * 100
SCREENER[c1 AND c2](ecart AS "Écart MM50 %")
Trois éléments sont à retenir :
- Les conditions sont des variables booléennes (
c1,c2) combinées avecANDouORà l’intérieur des crochets deSCREENER. - Le critère entre parenthèses est une valeur numérique calculée pour chaque instrument : elle sert à trier les résultats et s’affiche dans une colonne.
AS "…"donne un nom à cette colonne. Sans lui, la colonne porte un nom générique peu lisible.
Étape 5 : exécuter et lire les résultats
Le bouton « Exécuter ProScreener » lance la recherche. La fenêtre de résultats affiche les instruments sélectionnés avec la colonne de tri. Le manuel précise que l’affichage est limité à 50 résultats (100 sur les plateformes Premium) : si votre condition en retient davantage, seuls les premiers selon le tri apparaissent.
Avant de vous fier aux résultats, contrôlez deux ou trois valeurs à la main : ouvrez leur graphique dans la même unité de temps, affichez la moyenne de 50 périodes et vérifiez que la condition est bien remplie. Ce contrôle détecte la plupart des erreurs de logique.
Les limites du module à connaître dès le départ
- 256 bougies d’historique (1 024 en Premium) : tous les calculs se font sur cette profondeur. Restez sur des périodes d’indicateurs nettement inférieures.
- Pas d’ordres : un screener sélectionne, il ne trade pas. Pour automatiser une condition, il faut écrire un système et passer par ProOrder.
- Débogage avec
PRINT: le manuel mentionne cette instruction pour examiner des valeurs, avec des restrictions (l’instrument doit appartenir à la liste scannée, et l’affichage est limité à 10 instruments).
Les erreurs fréquentes du premier screener
- Un code qui se termine par
RETURN. C’est la syntaxe des indicateurs ; un screener se termine parSCREENER. - Une condition jamais vraie. Par exemple
Close > Highest[20](High): la clôture ne peut pas dépasser un plus haut qui inclut la barre courante. Il faut décaler d’une barre avec[1], comme expliqué dans le screener de cassure. - Une liste trop petite ou mal choisie. Un screener n’est jamais meilleur que l’univers qu’il parcourt.
- Des variables mal nommées. Les règles de nommage sont celles de ProBuilder, rappelées dans la syntaxe de base du ProBuilder.
Organiser ses screeners
À mesure que vous en créez, nommez vos screeners de façon explicite (par exemple « Cassure 20 J + volume ») et gardez dans un commentaire en tête de code la liste, la période et le sens de tri prévus. Ces réglages ne figurent pas dans le code lui-même : sans cette note, il est difficile de reproduire un résultat quelques semaines plus tard.
Variante : réutiliser un indicateur existant
Si vous avez déjà écrit un indicateur personnel, vous pouvez l’appeler dans le screener avec CALL, au lieu de recopier son code. Le manuel en donne la forme : MyRSI = CALL "MonRSI"[14], où "MonRSI" est le nom de l’indicateur et 14 son paramètre. Le détail est expliqué dans CALL : appeler un indicateur.
FAQ
Faut-il savoir programmer pour utiliser ProScreener ?
Non, la programmation assistée permet de construire des filtres simples à partir de menus. Mais dès que vous voulez combiner plusieurs conditions, trier selon un critère calculé ou utiliser plusieurs unités de temps, la création par programmation devient indispensable.
Pourquoi mon screener ne renvoie-t-il aucun résultat ?
Vérifiez d’abord que la condition peut être vraie (un plus haut calculé sans décalage [1] l’en empêche souvent), puis que la liste contient des instruments compatibles et que l’historique de 256 bougies suffit pour vos indicateurs. Tester la condition sous forme d’indicateur sur un graphique aide à trouver l’erreur.
Où choisit-on le sens du tri ?
Dans la fenêtre de programmation, pas dans le code. Le manuel indique que le sens du tri se règle avec la période, dans une section dédiée de la fenêtre.
