How to Install Custom Indicators in NinjaTrader 8 (ZIP Import)

Key takeaways

• A NinjaScript archive (.zip) is imported from the Control Center with Tools > Import > NinjaScript Add-On; do not unzip it first.
• A single .cs source file is copied into Documents\NinjaTrader 8\bin\Custom\Indicators and compiled with F5 in the NinjaScript Editor.
• After importing the Trading Evolution packs, restart NinjaTrader and activate the free key in Control Center > New > Trading Evolution License.
• NinjaTrader compiles all custom scripts together, so one broken file can block every other indicator.
• Import only from sources you trust: NinjaScript is compiled code that runs inside the platform.

How to install indicators in NinjaTrader 8: the short answer

To install indicators in NinjaTrader 8, first look at the file you downloaded. If it is a ZIP archive, open the Control Center, choose Tools > Import > NinjaScript Add-On, select the ZIP and confirm, then restart NinjaTrader if the developer asks you to. If it is a single .cs file, copy it into the Documents\NinjaTrader 8\bin\Custom\Indicators folder and compile it with F5 in the NinjaScript Editor. In both cases the indicator then appears in the Indicators window of every chart.

The two formats are not interchangeable. The import menu expects a NinjaScript archive and the Custom folder expects source files. Most failed installations come from using the right file with the wrong method, or from a problem in another script that stops the whole compilation. If NinjaTrader itself is not installed and connected yet, start with the NinjaTrader 8 setup guide.

ZIP archive or .cs file: identify what you downloaded

NinjaTrader can export indicators, strategies and other scripts as a NinjaScript archive, a ZIP file built for its own import function. Developers usually distribute their tools this way, sometimes with several indicators and supporting files in one archive. A .cs file, by contrast, is plain C# source code: a single script you can open in a text editor and read before installing it.

• Keep the archive zipped. The import dialog reads the ZIP itself; extracting it leaves you with loose files the import function cannot use.
• Scripts and archives written for NinjaTrader 7 are not compatible with NinjaTrader 8. Check which version a download targets before installing it.
• Some downloads wrap the NinjaScript archive inside a second ZIP with a readme. If the import is refused, open the outer file and look for the archive inside.

Importing a ZIP archive with Tools > Import

This is the method for the two Trading Evolution packs, the Order Flow pack and the ICT pack, which each bundle several indicators in one ZIP file. It is the same for any NinjaScript archive.

• Download the archive and leave it as a ZIP, for example in your Downloads folder.
• Open NinjaTrader 8 and sign in: the import runs from the Control Center.
• Open Tools > Import > NinjaScript Add-On. The Help Guide describes the same entry as Tools > Import > NinjaScript.
• Select the ZIP file and confirm the import. NinjaTrader then tells you whether it succeeded or what went wrong.
• Restart NinjaTrader, as the Trading Evolution install note asks, so that everything in the pack is loaded.

Installing a .cs source file with the NinjaScript Editor

A source file goes into the folder where NinjaTrader keeps custom indicators: Documents\NinjaTrader 8\bin\Custom\Indicators. Copy it there, open New > NinjaScript Editor from the Control Center and press F5 to compile. If the compilation succeeds, the indicator is available on every chart.

NinjaTrader compiles all custom scripts together. If any file in the Custom folder contains an error, the compilation fails and the new indicator does not appear, even when its own code is correct. The editor lists each error with the file it comes from: fix or remove that file, then compile again.

A frequent message says that a namespace already contains a definition for a name. It means two copies of the same indicator exist, often an old version saved under another file name. Delete the older copy and compile again.

Activating the Trading Evolution license

The Trading Evolution packs need a free license key before the indicators run. After the import and the restart, open Control Center > New > Trading Evolution License, paste your key and click Save and verify. The key is waiting in the License section of your Trading Evolution member area, and one key activates both packs.

The key is personal and works on a limited number of computers. If you change computers, the member area lets you release an old one before activating the new one. Once NinjaTrader has checked the key, the member area shows that computer as active.

Adding the indicator to a chart

Open a chart, then the Indicators window: right-click the chart background and choose Indicators, click the Indicators icon in the chart toolbar, or press Ctrl + I. Find the indicator in the Available list, where the search box filters by name and description, double-click it or press add, adjust its properties, then click OK.

Every chart indicator has a Calculate property. On Bar Close runs once per completed bar, On Each Tick runs on every incoming tick and uses the most processing power, and On Price Change runs whenever the price changes. Keep the developer’s default unless the documentation says otherwise.

Order flow indicators such as TEVO Footprint read every trade with its bid and ask. In real time that works without any special setting, but an exact history needs Tick Replay: Show Tick Replay checked in the Market data settings, then Tick Replay ticked in the chart’s Data Series window. Our Tick Replay guide explains when it is worth the extra loading time.

Troubleshooting a failed installation

When an indicator does not appear or does not draw, the cause is usually one of these.

• The indicator is missing from the list: for a .cs file, check the folder and compile again with F5; for a ZIP, check that the import reported success, then restart NinjaTrader.
• The import is refused: the file may not be a NinjaTrader 8 archive, for example a NinjaTrader 7 export, an extracted folder, or a ZIP inside another ZIP.
• Compilation errors point to another file: fix or remove that script, since one error blocks every custom script.
• The indicator loads but draws nothing: check the data connection and the contract month, then whether the tool needs market depth or Tick Replay.
• The Trading Evolution License entry is missing from the New menu: the import did not complete, or NinjaTrader has not been restarted since.

Import only what you trust

The NinjaTrader Help Guide is explicit: import NinjaScript archives only from trusted sources. Indicators are compiled C# code that runs inside the platform, with the same access to your computer as NinjaTrader itself. Download from the developer’s own website, keep a copy of the archive you installed, and avoid repackaged copies circulating on forums.

Before relying on what an indicator draws, read its documentation: what it calculates, which data it needs and what it cannot see. Each of the free NinjaTrader 8 indicators from Trading Evolution has a page listing its settings, requirements and limitations. No indicator removes the risk of trading futures, so test any new tool on a simulation account first.

Put it into practice

• Free NinjaTrader 8 indicators15 indicators, 5 order flow tools and 10 ICT models, each with its documentation.
• Installation video tutorialThe 12 steps from downloading the packs to adding an indicator on a NinjaTrader 8 chart.

Frequently asked questions

Sources

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

Read next

All articles in this section : NinjaTrader 8 →