Installer des indicateurs personnalisés dans NinjaTrader 8 (import ZIP)

L'essentiel

• Une archive NinjaScript (.zip) s’importe depuis le Control Center avec Tools › Import › NinjaScript Add-On, sans la décompresser au préalable.
• Un fichier source .cs isolé se copie dans Documents\NinjaTrader 8\bin\Custom\Indicators et se compile avec F5 dans le NinjaScript Editor.
• Après l’import des packs Trading Evolution, redémarre NinjaTrader et active la clé gratuite dans Control Center › New › Trading Evolution License.
• NinjaTrader compile tous les scripts personnalisés ensemble : un seul fichier défectueux peut bloquer tous les autres indicateurs.
• N’importe que depuis des sources de confiance : NinjaScript est du code compilé qui s’exécute dans la plateforme.

Installer un indicateur dans NinjaTrader 8 : la réponse courte

Pour installer un indicateur dans NinjaTrader 8, regarde d’abord le fichier téléchargé. S’il s’agit d’une archive ZIP, ouvre le Control Center, choisis Tools › Import › NinjaScript Add-On, sélectionne le ZIP et confirme, puis redémarre NinjaTrader si le développeur le demande. S’il s’agit d’un fichier .cs isolé, copie-le dans le dossier Documents\NinjaTrader 8\bin\Custom\Indicators et compile-le avec F5 dans le NinjaScript Editor. Dans les deux cas, l’indicateur apparaît ensuite dans la fenêtre Indicators de chaque graphique.

Les deux formats ne sont pas interchangeables. Le menu d’import attend une archive NinjaScript, le dossier Custom attend des fichiers source. La plupart des installations ratées viennent d’un bon fichier utilisé avec la mauvaise méthode, ou d’un problème dans un autre script qui bloque toute la compilation. Si NinjaTrader lui-même n’est pas encore installé et connecté, commence par le guide pour configurer NinjaTrader 8.

Archive ZIP ou fichier .cs : identifier ce que tu as téléchargé

NinjaTrader peut exporter indicateurs, stratégies et autres scripts sous forme d’archive NinjaScript, un fichier ZIP conçu pour sa propre fonction d’import. Les développeurs distribuent généralement leurs outils ainsi, parfois avec plusieurs indicateurs et des fichiers annexes dans une même archive. Un fichier .cs, à l’inverse, est du code source C# en clair : un script unique que l’on peut ouvrir dans un éditeur de texte et lire avant de l’installer.

• Garde l’archive compressée. La boîte de dialogue d’import lit le ZIP lui-même ; l’extraire ne laisse que des fichiers épars dont la fonction d’import ne sait que faire.
• Les scripts et archives écrits pour NinjaTrader 7 ne sont pas compatibles avec NinjaTrader 8. Vérifie à quelle version s’adresse un téléchargement avant de l’installer.
• Certains téléchargements emballent l’archive NinjaScript dans un second ZIP accompagné d’un fichier readme. Si l’import est refusé, ouvre le fichier extérieur et cherche l’archive à l’intérieur.

Importer une archive ZIP avec Tools › Import

C’est la méthode des deux packs Trading Evolution, le pack Order Flow et le pack ICT, qui regroupent chacun plusieurs indicateurs dans un seul fichier ZIP. Elle vaut pour toute archive NinjaScript.

• Télécharge l’archive et laisse-la au format ZIP, par exemple dans ton dossier Téléchargements.
• Ouvre NinjaTrader 8 et connecte-toi : l’import se lance depuis le Control Center.
• Ouvre Tools › Import › NinjaScript Add-On. Le Help Guide décrit la même entrée sous le nom Tools › Import › NinjaScript.
• Sélectionne le fichier ZIP et confirme l’import. NinjaTrader indique ensuite si l’opération a réussi ou ce qui a échoué.
• Redémarre NinjaTrader, comme le demande la note d’installation de Trading Evolution, pour que tout le contenu du pack soit chargé.

Installer un fichier source .cs avec le NinjaScript Editor

Un fichier source se place dans le dossier où NinjaTrader conserve les indicateurs personnalisés : Documents\NinjaTrader 8\bin\Custom\Indicators. Copie-le à cet endroit, ouvre New › NinjaScript Editor depuis le Control Center et appuie sur F5 pour compiler. Si la compilation réussit, l’indicateur est disponible sur tous les graphiques.

NinjaTrader compile tous les scripts personnalisés ensemble. Si un fichier du dossier Custom contient une erreur, la compilation échoue et le nouvel indicateur n’apparaît pas, même si son propre code est correct. L’éditeur liste chaque erreur avec le fichier dont elle provient : corrige ou retire ce fichier, puis compile à nouveau.

Un message fréquent indique qu’un espace de noms (namespace) contient déjà une définition pour un nom donné. Cela signifie que deux copies du même indicateur coexistent, souvent une ancienne version enregistrée sous un autre nom de fichier. Supprime la copie la plus ancienne et compile à nouveau.

Activer la licence Trading Evolution

Les packs Trading Evolution ont besoin d’une clé de licence gratuite pour que les indicateurs fonctionnent. Après l’import et le redémarrage, ouvre Control Center › New › Trading Evolution License, colle ta clé et clique sur Save and verify. La clé t’attend dans la rubrique Licence de ton espace membre Trading Evolution, et une seule clé active les deux packs.

La clé est personnelle et fonctionne sur un nombre limité d’ordinateurs. Si tu changes d’ordinateur, l’espace membre permet d’en libérer un ancien avant d’activer le nouveau. Une fois la clé vérifiée par NinjaTrader, l’espace membre affiche cet ordinateur comme actif.

Ajouter l’indicateur à un graphique

Ouvre un graphique, puis la fenêtre Indicators : clic droit sur le fond du graphique puis Indicators, clic sur l’icône Indicators de la barre d’outils du graphique, ou Ctrl + I. Trouve l’indicateur dans la liste Available, où le champ de recherche filtre par nom et par description, double-clique dessus ou appuie sur add, règle ses propriétés, puis clique sur OK.

Chaque indicateur de graphique possède une propriété Calculate. On Bar Close calcule une fois par barre terminée, On Each Tick calcule à chaque tick reçu et demande le plus de puissance de calcul, On Price Change calcule à chaque changement de prix. Garde la valeur par défaut choisie par le développeur, sauf indication contraire de la documentation.

Les indicateurs d’order flow comme TEVO Footprint lisent chaque transaction avec son bid et son ask. En temps réel, cela fonctionne sans réglage particulier, mais un historique exact demande Tick Replay : Show Tick Replay coché dans les réglages Market data, puis Tick Replay coché dans la fenêtre Data Series du graphique. Notre guide de Tick Replay explique quand le temps de chargement supplémentaire en vaut la peine.

Dépanner une installation qui échoue

Quand un indicateur n’apparaît pas ou ne dessine rien, la cause figure généralement dans cette liste.

• L’indicateur manque dans la liste : pour un fichier .cs, vérifie le dossier et recompile avec F5 ; pour un ZIP, vérifie que l’import a signalé un succès, puis redémarre NinjaTrader.
• L’import est refusé : le fichier n’est peut-être pas une archive NinjaTrader 8, par exemple un export NinjaTrader 7, un dossier extrait ou un ZIP dans un autre ZIP.
• Les erreurs de compilation désignent un autre fichier : corrige ou retire ce script, car une seule erreur bloque tous les scripts personnalisés.
• L’indicateur se charge mais ne dessine rien : vérifie la connexion aux données et le mois d’échéance, puis si l’outil a besoin de la profondeur de marché ou de Tick Replay.
• L’entrée Trading Evolution License manque dans le menu New : l’import n’est pas allé jusqu’au bout, ou NinjaTrader n’a pas été redémarré depuis.

N’importer que ce qui est digne de confiance

Le NinjaTrader Help Guide est explicite : n’importer des archives NinjaScript que depuis des sources de confiance. Les indicateurs sont du code C# compilé qui s’exécute dans la plateforme, avec le même accès à l’ordinateur que NinjaTrader lui-même. Télécharge depuis le site du développeur, garde une copie de l’archive installée et évite les copies reconditionnées qui circulent sur les forums.

Avant de te fier à ce que dessine un indicateur, lis sa documentation : ce qu’il calcule, les données dont il a besoin et ce qu’il ne peut pas voir. Chacun des indicateurs NinjaTrader 8 gratuits de Trading Evolution dispose d’une page qui liste ses réglages, ses prérequis et ses limites. Aucun indicateur ne supprime le risque du trading de futures : teste tout nouvel outil d’abord sur un compte de simulation.

Mettre en pratique

• Indicateurs NinjaTrader 8 gratuits15 indicateurs, 5 outils order flow et 10 modèles ICT, chacun avec sa documentation.
• Tutoriel vidéo d’installationLes 12 étapes, du téléchargement des packs à l’ajout d’un indicateur sur un graphique NinjaTrader 8.

Questions fréquentes

Sources

1. NinjaScript Distribution: Import — NinjaTrader 8 Help Guide
2. Working with Indicators — NinjaTrader 8 Help Guide
3. Tick Replay — NinjaTrader 8 Help Guide

À lire aussi

Tous les articles de la rubrique : NinjaTrader 8 →