NinjaScript Introduction for Traders: Build Your First Automated Strategy

## NinjaScript Introduction for Traders: Build Your First Automated Strategy NinjaScript is C#-based, but you don't need to be a software developer to start building in it. NinjaTrader's Strategy Builder lets you create basic automated strategies through a visual interface. When you need more control, the NinjaScript editor gives you direct access to the code. This guide covers the foundational concepts you need to understand to either build your own strategies or intelligently modify existing ones. ## What NinjaScript Can Build NinjaScript powers three types of objects in NinjaTrader: **Indicators**: Calculate and display custom values on charts. Examples: a custom moving average crossover signal, a VWAP deviation band, a session volume accumulation line. **Strategies**: Automated trading systems that send real orders to the exchange based on defined conditions. When a strategy generates a signal, NinjaTrader submits the corresponding order without manual intervention. **Add-ons**: UI extensions that add new windows, panels, or features to the NinjaTrader platform. For most futures traders, indicators and strategies are the primary focus. This guide concentrates on strategies. ## The Strategy Builder (No Code Required) Before writing any code, explore the Strategy Builder: NinjaTrader Control Center → New → Strategy Builder. The Strategy Builder uses a condition-action visual interface: - **Conditions**: Define when the strategy acts (e.g., "RSI crosses above 30") - **Actions**: Define what happens when conditions are met (e.g., "Enter long market order") For simple strategies — a moving average crossover system, a time-of-day filter, a basic mean reversion rule — the Strategy Builder can generate the full NinjaScript code. You can then export the generated code as a starting point for further customization. ## NinjaScript File Structure Every NinjaScript strategy follows this structure: **Region 1: Namespace and class declaration** Every NinjaScript file opens with a namespace declaration and a class that inherits from NinjaTrader's base class (Strategy, Indicator, etc.). **Region 2: Variables** Declare your variables here — indicator objects, price series, counters. **Region 3: OnStateChange()** This method runs when the strategy changes state (setup, data loaded, real-time, terminated). Strategy initialization — setting indicator parameters, chart properties, slippage — goes here. **Region 4: OnBarUpdate()** This is the core of every strategy. It runs on every new bar (or tick, depending on settings). All entry/exit logic goes here. **OnBarUpdate() execution**: The method checks conditions on every bar. If entry conditions are met and no position is open, it places an entry order. If exit conditions are met and a position is open, it places an exit order. ## Core NinjaScript Concepts for Traders **Bars and periods**: NinjaScript references price data by bar index. Close[0] is the current bar's close. Close[1] is the prior bar's close. High[0] is the current bar's high. Low[1] is the prior bar's low. **Built-in indicator access**: Every NinjaTrader indicator is directly callable in NinjaScript: - EMA(14)[0] — current 14-period EMA value - RSI(14, 3)[0] — current RSI value - VWAP()[0] — current VWAP value **Entry orders**: EnterLong() submits a market buy. EnterLongLimit(price) submits a limit buy. EnterShort() submits a market sell. **Exit orders**: ExitLong() closes a long position. SetStopLoss() places a stop. SetProfitTarget() places a target. These are called once in OnStateChange() and apply automatically to every trade. **Position state**: Position.MarketPosition tells you if you are flat, long, or short. Use this to avoid entering multiple positions or exiting when flat. ## A Simple Strategy Example Here is the logic for a basic mean reversion strategy: - Enter long when price is more than 2 standard deviations below VWAP - Exit when price returns to VWAP - Stop loss at 3 standard deviations below VWAP In NinjaScript logic: **Entry condition**: Current close is below (VWAP − 2 × StandardDeviation). Position is flat. **Exit condition**: Current close crosses above VWAP. Position is long. **Stop**: Set in OnStateChange() using SetStopLoss() at a fixed dollar amount corresponding to the 3 SD level. This is approximately how the Marty strategy's mean reversion logic is structured at its conceptual core — enter on deviation, exit on reversion. ## How to Open and Edit NinjaScript **Opening the editor**: Control Center → New → NinjaScript Editor. The editor shows all your custom scripts with syntax highlighting and basic error detection. **Compiling**: After edits, press F5 or click Compile. NinjaTrader compiles the code and reports errors. Common errors: missing semicolons, undeclared variables, wrong method signatures. **Testing on SIM**: Always enable a strategy in SIM mode first. In the strategy properties, set "Account" to your simulation account. Run for at least 5 trading days to catch logic errors before enabling on a live account. ## Where to Get NinjaScript Help **NinjaTrader Help Guide**: The official documentation at ninjatrader.com/support/helpGuides covers every method, property, and class in NinjaScript with examples. **NinjaTrader Support Forum**: The most active community for NinjaScript questions. Search before posting — most common questions have been answered multiple times. **NinjaTrader Strategy Builder → Export**: Generate code for simple strategies using the visual builder, then read the exported code to understand how NinjaTrader structures the logic. This is the fastest self-education method for seeing NinjaScript patterns. Learning NinjaScript gives you the ability to systematize any trading idea — turning a discretionary observation about price behavior into a testable, automated strategy with exact entry and exit rules.