ILoveTrading Documentation
NinjaTrader 8 Synchronization & NinjaScript Architecture
The NinjaTrader 8 (NT8) synchronization module connects your NinjaTrader desktop environment directly to the ILoveTrading journal and behavioral intelligence engine. Built as a native C# NinjaScript Add-on, the integration delivers real-time event-driven trade capture, multi-account routing, and automatic futures contract normalization.
1. System Architecture & Event Pipeline
Unlike poll-based scrapers, the ILoveTrading NinjaScript Add-on integrates directly into the core event bus of NinjaTrader's .NET runtime. It subscribes to low-level execution handlers:
Account.ExecutionUpdate: Captures instantaneous order fills, partial executions, and bracket triggers.Account.OrderUpdate: Tracks planned initial stop-loss orders and profit targets at the moment of submission.Account.PositionUpdate: Monitors net open exposure and state transitions from flat to active positions.
Because event dispatching executes asynchronously in background worker threads, chart rendering and DOM order-entry speeds remain completely uninhibited.
2. Futures Contract Multipliers & PnL Engine
Futures contracts trade with varying tick sizes, minimum fluctuations, and point values. The synchronization pipeline accurately computes net performance by incorporating instrument specifications:
Formula / Calculation
Net PnL = Σ [(Exit Price - Entry Price) × Point Value × Quantity] - Total Fees
Supported Instrument Classes
- CME & E-mini Indices:
ES(50/pt),NQ(20/pt),YM(5/pt),RTY(50/pt). - Micro E-mini Indices:
MES(5/pt),MNQ(2/pt),MYM(0.50/pt),M2K(5/pt). - Commodities & Energy:
CL(Crude Oil, 1,000/pt),GC(Gold, 100/pt),SI(Silver, 5,000/pt). - Contract Expirations & Rollover: Automatically parses expiration suffix notations (e.g.,
NQ 03-26→NQ) to aggregate performance across quarterly rollovers without manual ticker re-mapping.
3. Advanced Trade Management (ATM) & Partial Scale-Outs
NinjaTrader traders frequently utilize ATM strategies with multiple profit targets and trailing stop rules. The synchronization engine handles complex execution paths seamlessly:
- Multi-Target Scaling: When scaling out (e.g., TP1 at +10 pts, TP2 at +20 pts, Runner at +40 pts), executions are aggregated into a single trade lifecycle with volume-weighted entry/exit metrics.
- Break-Even Adjustments: If your ATM strategy automatically moves your Stop Loss to entry price after hitting TP1, initial risk (1R) is locked based on the original pre-trade Stop Loss level.
- OCO (One-Cancels-Other) Handling: Opposing target or stop cancellations are verified in real time, preventing duplicate or ghost records.
4. Step-by-Step Installation Guide
Step 1: Download the NinjaScript Add-on
In your ILoveTrading dashboard, open the Integrations menu and download ILoveTrading_NT8_Sync.zip.
(Do NOT unzip this file; NinjaTrader requires the original ZIP archive).
Step 2: Import into NinjaTrader 8
- Open NinjaTrader 8.
- In the main Control Center, navigate to
Tools > Import > NinjaScript Add-On.... - Select the downloaded
ILoveTrading_NT8_Sync.zipfile. - Click Open. A dialog will confirm the successful assembly registration.
Step 3: Configure Multi-Account Data Stream
- In the NT8 Control Center, select
New > ILoveTrading Syncfrom the top menu. - In the configuration window, paste your Universal Token (generated in Integrations or Settings > Accounts).
- Under the Monitored Accounts checklist, select the accounts you wish to track (e.g.,
Sim101, Apex evaluation account, Live brokerage account). - Click Connect. The status indicator will switch to Active / Connected.
5. Security & Operation Recommendations
Tip
[!TIP] Simultaneous Account Journaling: You can check multiple accounts simultaneously in the Add-on window. ILoveTrading will automatically segment performance into distinct account profiles.
Important
[!IMPORTANT] Token Confidentiality: Your Universal Token acts as a private ingest key. Keep it secure and never share it publicly. If compromised, generate a new token immediately in Settings > Accounts.
Trading on MetaTrader?
Sync your MT4 or MT5 account and automatically audit your cognitive biases and trading performance.
