πŸ”§ TROUBLESHOOTING

NinjaTrader 8 β€” Fix Common Issues

Connection drops, strategy won't enable, data gaps, sim vs live confusion β€” every issue Oracle subscribers hit, diagnosed and solved with screenshots.

πŸ“Έ 40+ screenshots ⏱️ Quick-reference format 🎯 Oracle Algo specific
1

Connection Issues

Understanding Connection Status Icons

The colored circle in the bottom-left of the Control Center tells you your connection state at a glance:

Green
Green
Connected & receiving data
Yellow
Yellow
Connecting / partial
Orange
Orange
Connection degraded
Red
Red
Disconnected / error
Gray
Gray
Not connected
Control Center status bar showing connection state
Control Center β€” connection status indicator in bottom-left corner

"Can't Connect" β€” Rithmic / Apex

The most common connection issue for Oracle subscribers. If your connection circle stays red or gray:

  1. Check credentials β€” Go to Connections β†’ Configure. Verify your username, password, and server match exactly what your prop firm / Rithmic provided.
  2. Check the server β€” Apex uses Rithmic Paper Trading for eval accounts and Rithmic 01 for funded. Make sure you're on the right one.
  3. Firewall / VPN β€” Rithmic requires specific ports. Disable VPN, check Windows Firewall isn't blocking NinjaTrader.
  4. Restart NinjaTrader β€” Sometimes a clean restart is all it takes.
  5. Check Rithmic status β€” Rithmic occasionally has outages. Check their status page or ask in Discord.
Connections Configure window
Connections β†’ Configure β€” verify credentials and server selection
Connections menu
Connections menu β€” select your configured connection to connect
⚠️ Apex users: If you just got a new eval or funded account, it can take 15–30 minutes for Rithmic credentials to activate. Don't panic β€” wait, then try again.

Connection Drops Mid-Session

If your connection drops while a strategy is running:

  1. Check your internet β€” VPS users: verify your VPS hasn't gone to sleep or lost connectivity.
  2. Check the Log tab β€” The Control Center Log tab shows exactly when and why disconnections happened.
  3. Enable auto-reconnect β€” Under Tools β†’ Options β†’ Connection, ensure reconnect settings are enabled.
  4. Your algo is safe β€” Oracle strategies have built-in position management. On reconnect, the strategy will detect any open position and resume management.
Control Center Log tab
Log tab β€” shows connection events, errors, and strategy messages
Disconnecting a connection
Right-click a connection to disconnect / reconnect
πŸ’‘ VPS Tip: If you're on a VPS and connections drop overnight, check that your VPS power plan is set to "High Performance" and sleep is disabled.
2

Strategy Won't Enable / Start

Strategy Shows Error on Enable

When you enable a strategy from the chart and it immediately disables or shows an error:

  1. Check the Log tab β€” The specific error will be in Control Center β†’ Log. Common errors:
    • License validation failed β€” Your license key doesn't match. Re-enter it in strategy parameters.
    • Account not found β€” You're not connected, or the account name doesn't match.
    • Instrument not found β€” Chart instrument doesn't match strategy requirements (needs NQ or MNQ).
  2. Reload NinjaScript β€” Sometimes a compile issue. Right-click in NinjaScript Editor β†’ Reload NinjaScript.
  3. Check chart timeframe β€” Oracle strategies require specific bar types and intervals. Verify your chart matches the setup guide.
Reload NinjaScript option
NinjaScript Editor β€” Reload NinjaScript to recompile all strategies

Strategy Enabled But Not Trading

Your strategy shows as enabled (green arrow) but no trades are happening:

  1. Check trading hours β€” Oracle strategies only trade during configured market hours. Outside those hours, the strategy waits.
  2. Check the Strategies tab β€” In Control Center β†’ Strategies tab, verify your strategy shows "Enabled" with the correct account.
  3. Verify account selection β€” Make sure you selected the right account (not Sim101 when you want live, or vice versa).
  4. Check position limits β€” If your prop firm has max position limits and you're at the limit, new entries will be rejected.
  5. Market conditions β€” The algo waits for specific signal conditions. No trade = no signal yet. This is normal.
Strategies tab in Control Center
Strategies tab β€” verify strategy is enabled and on the correct account
Strategy context menu
Right-click a strategy for options: disable, view performance, properties
Strategy properties
Strategy properties β€” verify account, instrument, and parameters
βœ… Pro tip: If you're unsure whether the strategy is working, enable it on Sim101 first during market hours. You should see trades within the first session.
3

Sim vs Live β€” Routing Confusion

The #1 most dangerous mistake: accidentally trading live when you think you're in sim, or vice versa.

Global Simulation Mode

Global Simulation Mode forces ALL order entry to sim accounts only. When you're testing, always enable this:

Tools β†’ Global Simulation Mode β€” a checkmark means it's active.

Global Simulation Mode toggle
Tools β†’ Global Simulation Mode β€” enable during testing

The Sim101 Account

Sim101 is NinjaTrader's built-in paper trading account. It behaves like a real account with cash balance and P&L, but no real money is at risk.

  1. Reset Sim101 β€” Right-click in the Accounts tab β†’ reset to clear P&L and start fresh.
  2. Multiple sim accounts β€” You can create additional sim accounts (Sim102, etc.) for testing different strategies simultaneously.
Reset simulator
Reset Sim101 β€” right-click in Accounts tab to clear balances
Sim101 context menu
Sim101 context menu β€” reset, edit properties, create additional sim accounts

How to Verify Which Account You're On

Before enabling any strategy, always check:

  1. Account dropdown β€” In Chart Trader or the strategy enable dialog, the account dropdown shows your selected account.
  2. Accounts tab β€” Control Center β†’ Accounts tab lists all connected accounts with their type.
  3. Background color β€” Under Tools β†’ Options β†’ Trading, set a "Simulation color" so sim windows have a different background (e.g., dark blue). This makes it instantly obvious.
Accounts tab
Accounts tab β€” shows all connected accounts, balances, and type (sim vs live)
Trading settings
Options β†’ Trading β€” set simulation background color for visual safety
🚨 CRITICAL: Never enable a strategy on a live/funded account until you've verified it works correctly on Sim101 first. When switching from sim to live, double-check the account selection in the strategy enable dialog.
4

Data Gaps & Chart Issues

Chart Shows No Data / Blank

You opened a chart but it's empty or shows "Waiting for data...":

  1. Check connection β€” Are you connected? Look at the status indicator.
  2. Check instrument β€” Make sure you typed the instrument correctly (NQ 06-26, not just "NQ").
  3. Check trading hours β€” If it's outside market hours and you don't have historical data, the chart may be blank.
  4. Reload historical data β€” Right-click the chart β†’ Reload All Historical Data.
Reload Historical Data
Right-click chart β†’ Reload All Historical Data to fix data gaps

Data Gaps / Missing Bars

Your chart has gaps (missing candles) or jumps in time:

  1. Weekend/holiday gaps are normal β€” Futures don't trade on weekends. Gaps at Sunday open are expected.
  2. Reload historical data β€” Right-click chart β†’ Reload All Historical Data.
  3. Check trading hours template β€” Under chart Data Series, verify the Trading Hours template matches your expected session (e.g., "CME US Index Futures ETH").
  4. Check data provider β€” Rithmic provides limited historical data for some contracts. If you need more, consider connecting to a supplemental data feed.
Chart Data Series settings
Data Series β€” verify instrument, bar type, interval, and trading hours

Contract Rollover (Quarterly)

NQ/MNQ futures contracts expire quarterly (March, June, September, December). When this happens:

  1. Update your chart instrument β€” Switch from the expiring contract (e.g., NQ 03-26) to the new front month (NQ 06-26).
  2. Re-enable your strategy β€” Disable the strategy, update the chart instrument, then re-enable.
  3. Oracle strategies handle this β€” Our CLIENT builds have NQ/MNQ routing built in. Just update the chart instrument.
Instrument selector
Instrument selector β€” type the new contract month to switch
πŸ’‘ Rollover dates: NQ/MNQ rolls happen on the 2nd Friday of March, June, September, and December. Oracle will announce rollovers in Discord.
5

Strategy Performance & Monitoring

Viewing Strategy Performance

To see how your strategy is performing in real-time:

  1. Strategies tab β€” Control Center β†’ Strategies tab shows all running strategies with current P&L.
  2. Right-click β†’ Strategy Performance β€” Opens a detailed breakdown of trades, win rate, P&L curve.
  3. Executions tab β€” Shows every fill your strategy received with timestamps and prices.
Strategy Performance window
Strategy Performance β€” detailed trade-by-trade breakdown
Strategy Performance detail
Performance summary β€” profit factor, win rate, drawdown, equity curve
Executions tab
Executions tab β€” every fill with time, price, quantity, and account

Orders & Positions

Monitor your active orders and open positions:

Orders tab
Orders tab β€” all pending/working orders with status
Positions tab
Positions tab β€” open positions with unrealized P&L
Positions context menu
Right-click a position β€” close, reverse, or flatten
⚠️ Don't manually close positions while an Oracle strategy is running β€” the strategy manages its own exits. If you manually close, the strategy may get confused about its position state. If you need to emergency flat, disable the strategy first.
6

Workspace & Settings

Save & Restore Your Workspace

Once you have everything configured and working, save your workspace so you can restore it if anything goes wrong:

Workspaces menu
Workspaces menu β€” save, open, create new workspaces
Save workspace
Save workspace β€” preserves all charts, strategies, and window positions
Import/Export workspace
Import/Export β€” back up your workspace to a file for safekeeping

Key Settings to Check

Under Tools β†’ Options, these settings matter most for algo trading:

General settings
Options β†’ General β€” startup behavior, workspace settings
Strategy settings page 1
Options β†’ Strategies β€” default behavior for strategy enablement
Strategy settings page 2
Options β†’ Strategies (continued) β€” error handling, real-time settings
Automated Trading Interface settings
Options β†’ Automated Trading Interface β€” for external automation
Market Data settings
Options β†’ Market Data β€” tick filtering, merge policy for multiple connections
7

Strategy Analyzer (Backtesting)

The Strategy Analyzer lets you backtest strategies against historical data. While Oracle strategies are optimized for live trading, backtesting can help you understand expected behavior.

Strategy Analyzer layout
Strategy Analyzer β€” main layout with instrument, date range, and strategy selection
Start backtest
Configure and run a backtest β€” select strategy, dates, and parameters
Backtest results
Backtest results β€” summary stats, trade list, equity curve
Strategy Analyzer log
Show Log β€” view strategy output messages during backtest
πŸ’‘ Backtest β‰  Live: Backtesting uses historical data with perfect fills. Live trading has slippage, latency, and real market conditions. Use backtests for understanding, not predicting exact results.
8

Common Error Messages

Quick reference for errors you might see in the Log tab:

"Strategy has been disabled. Reason: An order was submitted with an inactive instrument"
Fix: The contract has expired (quarterly rollover). Update your chart to the current front-month contract.
"Connection lost. Attempting to reconnect..."
Fix: Check internet/VPS. If it doesn't auto-reconnect within 60 seconds, manually reconnect via Connections menu.
"Order rejected: Insufficient margin"
Fix: Your account balance is below the margin requirement. Check with your prop firm. For Apex, ensure you haven't hit the trailing threshold.
"Strategy has been disabled. Reason: Account does not exist"
Fix: You're not connected, or the account was removed. Reconnect to your data provider, then re-enable the strategy.
"Error on calling 'OnBarUpdate' method: License validation failed"
Fix: Your Oracle license key is incorrect or expired. Check the LicenseKey parameter in your strategy properties. Contact Oracle support if your subscription is active.
"Error compiling NinjaScript"
Fix: A strategy file is corrupted. Re-import the .zip file from Oracle. If other scripts are causing conflicts, remove them and try again.
"Historical data request failed"
Fix: Rithmic limits historical data requests. Wait a few minutes and try again, or reload historical data from the chart right-click menu.
9

Quick Fixes Checklist

When something isn't working, run through this checklist before asking for help:

πŸ’¬ Still stuck? Take a screenshot of your error/issue and post it in the Oracle Algorithms Discord #support channel. Include what you've already tried from this checklist.