XABCD Performance Documentation

Installation

To install our software you'll first have to download it from your account. Unzip it and run the installer which will ask for your license. It's that simple but we also have a video walk through if you wnat some more details.
XABCD Pattern Indicator Suite

Overview

The XABCDPerformance indicator monitors various system performance metrics—including machine time, chart time, lag time, CPU usage, disk usage, available RAM, data transfer rate, and OneDrive status—and displays them as fixed text on the chart. In addition, it exposes three developer-only plots (for Overall Health, Lag Time, and CPU Usage) that update in real time but are hidden from the end user’s view. These internal plots can be used by developers (for example, via Strategy Builder or debugging) without altering the on‑screen display.

Table of Contents

Introduction

The XABCD Performance indicator is a free, on-chart monitor of the conditions that actually affect your order timing in NinjaTrader 8: how far behind real-time your data is, how hard your CPU, GPU, RAM, and disk are working, your network latency and packet loss, your feed's data rate, and whether your PC's clock is drifting. It blends all of it into one Health score, and after a few minutes of watching your machine it gives you personalized, plain-English recommendations for anything worth fixing.

  • It is one compact panel ... a block of live readouts drawn in the corner of your chart, plus two small icons (a bell and a settings wrench) and an optional pop-up trend graph for any metric.
  • It is read-only and safe ... it only measures. It never changes your Windows clock, your sync settings, or anything on your machine.
  • It is configured from one custom window ... all settings live in a tabbed window you open from the wrench icon, not in NinjaTrader's property grid.
XABCD Performance is free and needs no license key. Add it to any chart from Indicators like any other NinjaScript indicator, or from Control Center → New → XABCD Suite → XABCD Performance.

Because most of the tool is about reading numbers rather than clicking tools, the next section covers the panel and its controls once, and the rest of the guide explains each metric, the Health score, the recommendations, and every setting.

Back to Table of Contents

The Panel & On-Chart Controls

Everything renders as text and icons anchored to a corner of the chart. A few things behave the same way throughout:

ControlHow it works
The panel A stack of metric rows (Lag Time, CPU, RAM, and so on), topped by the Health score and bar and tailed by the Recommendations box. Anchor it Top Right (default) or Top Left with Text Alignment, and push it down with Blank Lines Above.
The settings wrench 🔧 The rainbow wrench icon on the panel opens the Settings window. Changes you make there apply instantly. (It sits beside the bell and stays on-screen in whichever corner the panel is anchored.)
The alert bell 🔔 Click the bell to toggle Quiet Mode on and off, muting audio and popup alerts. The icon shows muted while quiet.
The Health badge In Mini or Invisible mode the panel collapses to a single colored Health badge. Click the badge to expand it.
Recommendations refresh ↻ The ↻ in the Recommendations header restarts the rolling five-minute analysis from scratch.
Trend graphs Most metrics can chart their history. Click the metric's row on the panel to open a floating Trend Graph for it. (A few rows ... Disk Read, CPU Temperature, Latency, and Jitter ... are not clickable.)

Every metric row can be shown or hidden individually, and the whole tool can be shrunk to a badge or hidden entirely (see Display Modes). The panel font, size, and opacity are set in Settings → General.

Back to Table of Contents

Reading the Metrics

Each metric is a single row you can show or hide. Lag-related readouts are colored green, amber, or red against your alert thresholds; the rest are there for context and feed into the Health score. Every metric has a hover tooltip (toggle with Show Metric Tooltips).

Trade & Health

The headline group: how current your data is and how your machine is doing overall.

MetricWhat it shows
Overall HealthA single 0 to 100% score with a colored bar that blends every available metric. See The Overall Health Score.
Machine TimeYour PC's current clock time.
Chart TimeThe timestamp of the most recent data on the chart.
Lag TimeHow far behind real-time your incoming data is ... the most important number for execution. Green at or below the Low Alert Threshold, red above the High Alert Threshold. Shows your live lag plus rolling 5-minute and 15-minute averages.
Clock OffsetHow far your Windows clock is from true (NTP) internet time. Measurement only; it never changes your clock. Shown directly under Lag Time.
Time SyncWhether Windows is set to sync with a time server, and the last successful sync time. Read-only.
A large Clock Offset or a stale Time Sync means your timestamps and any time-based logic can be off even when your feed is healthy. Both are read-outs only ... fix them in Windows' Date & Time settings.

Back to Table of Contents

CPU, GPU & RAM

How hard the machine and NinjaTrader itself are working.

MetricWhat it shows
CPU UsageSystem-wide processor load. Triggers an alert at the CPU Alert Threshold (default 90%).
CPU TemperatureProcessor temperature in °C, where your hardware exposes it.
Available RAMFree system memory. Low free RAM is a common cause of stutter.
GPU Usage / GPU TemperatureGraphics-card load and temperature ... charts are GPU-rendered, so a pinned GPU shows up as choppy redraws.
NinjaTrader MemoryMemory used by the NinjaTrader process. Triggers an alert at the Memory Alert Threshold (default 2.5 GB). A steady climb here is flagged as an anomaly.
NinjaTrader CPUProcessor load from NinjaTrader specifically, separate from the rest of the system.
Page File UsageWindows swap-file usage. Heavy paging means you are out of physical RAM and spilling to disk.

Back to Table of Contents

Disk & OneDrive

Storage throughput and the single most damaging misconfiguration for a trading PC.

MetricWhat it shows
Disk UsagePercent of your drive's capacity in use.
Disk Read / Disk WriteLive read and write throughput. Sustained activity past the Disk Warning and Disk Critical thresholds is flagged.
Disk Queue LengthHow many disk operations are waiting in line. A queue that builds up is a classic bottleneck and often correlates with lag.
OneDrive StatusWhether NinjaTrader is running from a OneDrive-synced folder. If it is, this turns red and is treated as critical ... see The OneDrive Warning.

Back to Table of Contents

Network

The connection between you and your data feed and broker.

MetricWhat it shows
Data Transfer RateHow fast market data is flowing in. A rate that drops to near zero means a stalled feed; thresholds can adapt to your normal rate (see Data Rate Tuning).
Network LatencyRound-trip ping time. Triggers an alert at the Latency Alert Threshold (default 200 ms).
Network JitterHow much your latency varies from ping to ping. High jitter means an unstable connection even if average latency looks fine.
Packet LossPercent of network packets being dropped ... a direct cause of missed or delayed quotes.
WiFi SignalWireless signal strength, shown only when you are on WiFi. (A wired connection is strongly preferred for trading.)
Connection StatusWhether your broker/data connection is currently up.

Back to Table of Contents

Extras

Context and self-diagnostics.

MetricWhat it shows
XABCD Indicator ImpactThis indicator's own execution time, so you can see how little overhead it adds to your chart.
Health DiagnosticWhen the Health score drops below the Health Diagnostic Threshold (default 70), this names the biggest single contributor to the low score.
Correlation HintsPlain-language hints when two metrics move together, for example lag rising alongside disk queue.
Alert HistoryAn optional list of recent alerts drawn on the chart (off by default).

Back to Table of Contents

The Overall Health Score

The Overall Health score is a single number from 0 to 100%, shown with a colored bar, that blends every metric the tool can read on your machine ... lag, CPU, GPU, RAM, disk usage and queue, network latency, jitter, packet loss, data rate, temperatures, page file, WiFi, and broker connection ... into one trade-readiness figure.

How it behaves

  • Fair weighting ... lag carries the most weight, with the other metrics weighted by how much they affect trading. Any metric your hardware does not expose is dropped automatically and the remaining weights are rebalanced, so a missing temperature sensor (for example) never unfairly drags the score down.
  • Color band ... the Mini / Invisible Health badge shifts from green to amber to red as the score falls. The full-panel Health bar instead shows the score as a proportional block bar drawn in your Health Bar Font Color.
  • OneDrive override ... if NinjaTrader is running from OneDrive, the score is held at a deep-red level regardless of everything else (see below).

Options

  • Show Overall Health (default on) ... show or hide the score and bar.
  • Health Diagnostic Threshold (default 70) ... below this score, the Health Diagnostic line names the worst contributor.
  • Health Bar Font Color (optional) ... set in Settings → Colors.

Back to Table of Contents

Recommendations

The Recommendations box at the bottom of the panel is the tool's advice engine. After the indicator has run on your chart for about five minutes, it reviews all of your metrics over that window and lists personal, point-form suggestions ... using your actual numbers ... for anything worth improving.

What you get

  • Ranked, color-coded advice ... each item is colored by urgency (red, amber, or a muted grey for low priority), and the box border reflects the most severe item.
  • A "Top priority" headline ... the single most important item is restated in one line so you see it at a glance.
  • Anomaly detection ... beyond fixed thresholds, it flags things that are unusual for your session, such as free RAM trending down, NinjaTrader's memory creeping up, or lag spiking well above your own normal.
  • Folded-in diagnostics ... with Consolidate Advice on (default), the Health Diagnostic and Correlation Hint are ranked inside the box with everything else, so all advice lives in one place.

Options

  • Show Recommendations (default on) ... show or hide the box.
  • Consolidate Advice Into Recommendations (default on) ... fold the diagnostic and correlation lines into the box, or show them on their own.
  • Refresh ... click the ↻ in the header to restart the five-minute analysis.
During the first five minutes the box shows a short countdown ("Analyzing your system... your first recommendations will be ready in 3:54.") while it gathers a baseline. Real recommendations appear once that window completes.

Back to Table of Contents

The OneDrive Warning

Running NinjaTrader from a OneDrive-synced folder is the single most damaging setup mistake the tool checks for, so it gets special treatment.

OneDrive's sync can lock your quote and data files mid-write, which can delay or drop live quotes, stall order fills, and freeze your charts without warning. When the tool detects NinjaTrader running from OneDrive it:

  • Marks the OneDrive Status row red.
  • Pins a critical warning to the top of the Recommendations box and as the Top-priority headline.
  • Holds the Health score at a deep-red level until you move NinjaTrader off OneDrive.
The fix: move your NinjaTrader 8 folder out of OneDrive to a normal local drive (for example, under C:\), then restart NinjaTrader. The warning clears on its own once it is no longer running from a synced folder.

Back to Table of Contents

Most metrics can show their recent history in a floating Trend Graph ... a small line chart you open by clicking the metric's row on the panel. The window is draggable and remembers its position, so you can keep an eye on, say, lag or CPU over time instead of just its current value.

What a trend window can show

  • The metric line ... recent samples, scaled to that metric's range (each metric has its own Trend Scale).
  • Smoothing overlays (optional) ... a short and a long rolling-average line, each with its own length, color, and width.
  • Standard-deviation band (optional) ... a translucent band of one standard deviation around the mean, to show how noisy the metric is.
  • Annotations (optional) ... markers when values cross thresholds, when alerts fire, and when Quiet Mode is active, plus a legend explaining them.
  • Historical averages ... configurable interval/statistic readouts (for example, a 1-minute average) defined by Historical Average Definitions.

Options

  • Enable Trend Windows (default on) ... allow trend windows to open from the metric rows.
  • Per-metric Show ... Trend (default off) ... CPU, Latency, Lag, Disk, RAM, Data Rate, GPU, Jitter, and temperature each have their own trend toggle, color, and scale in Settings → Trend Graphs.
  • Allow Trend Windows Over Text (optional) ... let a window overlap the metric panel.

Back to Table of Contents

Alerts & Quiet Mode

The tool can warn you the moment a metric crosses a line you care about, on-screen and off.

Alert types

  • Audio alert ... plays a sound on a high-lag event. Pick any .wav or .mp3 from your NinjaTrader 8 Sounds folder with High Alert Sound.
  • Popup alert ... an on-screen popup for high lag (Enable Popup Alert).
  • Off-screen webhook ... paste a Discord or Slack incoming-webhook URL into Alert Webhook URL and get a message (for example, on your phone) when a critical issue is detected, such as pinned CPU, low memory, packet loss, or a disconnected feed. Limited to at most one alert every 15 minutes.

Thresholds

Set in Settings → Thresholds & Alerts. Each can be set to 0 to disable that alert.

ThresholdDefaultFires when...
Low / High Alert (Lag, s)style-basedLag time drops into amber / red.
CPU Alert (%)90CPU usage exceeds this.
Latency Alert (ms)200Network latency exceeds this.
Memory Alert (GB)2.5NinjaTrader memory exceeds this.
Disk Warning / Critical (MB/s)style-basedSustained disk throughput exceeds these.

Quiet Mode

Quiet Mode suppresses audio and popup alerts so a smooth, busy period does not produce a burst of noise. Toggle it instantly with the bell icon on the panel, or schedule it with Enable Quiet Mode plus a Quiet Mode Start / End time window (for example, to silence overnight). The Alert Cooldown Period (default 30 s) sets the minimum gap between alerts.

Back to Table of Contents

Display Modes

Four display modes let the tool be as detailed or as out-of-the-way as you want. All are in Settings → General.

ModeWhat it shows
Full (default)Every enabled metric, the Health bar, and the Recommendations box.
Compact ViewOnly the Health score plus any metrics that currently have a warning or alert. Quiet when all is well, informative when it is not.
Mini ModeJust a small Health badge, the Health %, and the recommendations. Click the badge to temporarily expand to full view (it auto-collapses again after about 10 seconds).
Invisible ModeOnly the Health badge ... the leanest footprint. Click the badge to turn it off.
Compact, Mini, and Invisible are non-destructive views ... they hide rows without changing which metrics are enabled, so turning a mode off brings your full layout straight back.

Back to Table of Contents

Trading Style Presets

The Trading Style setting (Settings → General) configures sensible alert thresholds and display options in one click, so you do not have to tune every number by hand.

StyleThresholds
ScalperTightest ... fast execution, real-time focus.
Day Trader (default)Balanced for intraday trading.
Swing TraderRelaxed, for multi-day positions.
Position TraderMost relaxed, for long-term positions.
CustomFull manual control ... nothing is overwritten.
Choosing a style applies its preset thresholds immediately. Pick the closest style first, then switch to Custom if you want to fine-tune individual thresholds afterward.

Back to Table of Contents

Candlestick Lag Coloring

The Candlestick Threshold Color option (Settings → General) tints your bars by lag so you can see data delays without reading the panel.

Modes

  • Full Color (default) ... every bar is colored green, yellow, or red based on lag.
  • Lag Bars Only ... only lagging bars (yellow / red) are colored; clean bars are left alone.
  • Off ... bars are never recolored.

Back to Table of Contents

The Settings Window

Open the settings window from the rainbow wrench icon on the panel (or from Control Center → New → XABCD Suite → XABCD Performance). All of the tool's settings are hidden from NinjaTrader's native property grid, so this window is the single place to configure it ... and every change you make applies instantly on the chart.

It has a search box at the top, a zoom slider to scale the whole window, hover tooltips on every setting, sliders with live readouts and units for numeric values, and bordered cards that group related settings. Tabs:

  • General ... Trading Style, display modes, font and opacity, text alignment, candlestick coloring, and product tips.
  • Metrics ... show/hide toggles for every metric (Trade & Health, CPU/GPU/RAM, Disk, Network, Extras).
  • Thresholds & Alerts ... every alert threshold, the alert sound, audio toggle, and webhook URL.
  • Colors ... the Health bar color, the lag color bands, and the trend icon color.
  • Trend Graphs ... per-metric trend toggles, colors and scales, smoothing overlays, the standard-deviation band, and annotations.
  • Advanced ... session summary, profile name, update frequency, popup alerts, Quiet Mode schedule, debug output, and data-rate tuning.
  • More Tools ... other XABCD tools you do not already own (see More XABCD Tools).

At the bottom: Save, Save as Default, Load, and Close (see Templates & Defaults).

Back to Table of Contents

Colors & Themes

Colors are set on the Colors tab (and the per-metric colors on Trend Graphs), using the same XABCD color-wheel picker as the rest of the suite.

  • Lag color bands ... No Lag, Tiny Lag, and High Lag set the green / amber / red used for the Lag readout and candlestick coloring, keyed to your Low and High alert thresholds.
  • Health Bar Font Color ... the color of the Health score text and bar.
  • Trend Icon Color ... the accent color used for the trend controls on the panel (such as the trend-layout reset).
  • Trend graph colors ... each metric's line, the smoothing overlays, and the standard-deviation band each have their own color.
  • Use Dark Theme (default on) ... dark colors for the trend windows and UI; turn off for a light theme.

Back to Table of Contents

Templates & Defaults

The tool remembers your setup through a simple template system, mirroring the XABCD Position Tool.

ButtonWhat it does
SaveSaves the current settings to a named template file you choose.
Save as DefaultSaves the current settings as default.xml ... the template loaded automatically on every chart.
LoadLoads a saved template file onto the live indicator (changes apply at once).

Templates live in Documents\NinjaTrader 8\templates\XT Performance\. The tool always applies your default.xml the moment it is added to a chart; the first time, if no default exists yet, it creates one from the current settings. A saved template captures everything ... your toggles, thresholds, trading style, fonts, and colors ... so your setup follows you to every chart.

After updating the indicator, open the settings window and click Save as Default once to refresh your default.xml with any new settings.

Back to Table of Contents

Session Summary & Profiles

On the Advanced tab:

  • Enable Session Summary (default on) ... tracks your system's performance over the trading day and writes a summary report at the end of the session.
  • Session Summary Path ... the folder where those reports are saved.
  • Profile Name (default "Default") ... a label for this machine's setup (for example, "Desktop", "Laptop", or "Trading PC"), so reports from different computers are easy to tell apart.
  • Update Frequency ... how often, in seconds, the readouts refresh.
  • Show Debug Output (default off) ... writes diagnostics to NinjaTrader's Output window for troubleshooting.

Back to Table of Contents

More XABCD Tools

XABCD Performance is free, and the More Tools tab in the settings window lists the rest of the XABCD suite ... the Position Tool, Pattern Suite, News Pro, Drawing Marker, and Hotkeys ... showing only the products you do not already have installed, each with a link to learn more. An occasional one-line tip also appears under the recommendations suggesting a tool you are missing (turn it off with Show Product Tips).

Back to Table of Contents

Settings Reference

A quick index of every setting, grouped by its category in the settings window. Numeric ranges and defaults are shown where they apply.

General (Trading Style & Display)

  • Trading Style ... Scalper / Day Trader (default) / Swing Trader / Position Trader / Custom.
  • Compact View Mode, Mini Mode, Invisible Mode ... display modes (all off by default).
  • Use Dark Theme (on), Show Product Tips (on).
  • Candlestick Threshold Color ... Off / Full Color / Lag Bars Only (default Full Color).
  • User Font (Arial 22), Text Opacity (0–1, default 1), Text Alignment (Top Right), Blank Lines Above (0), Show Lag Information (on).

Metrics: show/hide toggles (all on by default)

  • Trade & Health ... Overall Health, Machine Time, Chart Time, Lag Time, Clock Offset, Time Sync Status, Recommendations, Consolidate Advice.
  • CPU, GPU & RAM ... CPU Usage, CPU Temperature, Available RAM, GPU Usage, GPU Temperature, NinjaTrader Memory, NinjaTrader CPU, Page File Usage.
  • Disk ... Disk Usage, OneDrive Status, Disk Read, Disk Write, Disk Queue Length.
  • Network ... Data Transfer Rate, Network Latency, Network Jitter, Packet Loss, WiFi Signal, Connection Status.
  • Extras ... XABCD Indicator Impact, Metric Tooltips, Alert History (off), Health Diagnostic, Correlation Hints.

Thresholds & Alerts

  • Health Diagnostic Threshold (0–100, default 70).
  • Low / High Alert Threshold (lag, seconds), Disk Warning / Critical (MB/s) ... set by Trading Style.
  • CPU Alert (0–100, default 90), Latency Alert (0–10000 ms, default 200), Memory Alert (0–64 GB, default 2.5). Set any to 0 to disable.
  • High Alert Sound (default HighLagDetected.wav), Enable Audio Alert (on), Alert Webhook URL (blank).

Colors

  • Health Bar Font Color, No Lag, Tiny Lag, High Lag, Trend Icon Color.

Trend Graphs

  • Enable Trend Windows (on), Allow Trend Windows Over Text, Historical Average Definitions.
  • Short / Long Smoothing overlays ... show, length, color, stroke width each.
  • Standard Deviation Band ... show, window, color, opacity.
  • Per-metric trend (Show / Color / Scale) for CPU, Latency, Lag, Disk Usage, Available RAM, Data Rate, Disk Read, Disk Write, GPU Usage, GPU Temperature, Network Jitter, CPU Temperature (all off by default).
  • Annotations ... Threshold, Quiet Mode, Alert, and the Annotation Legend (all on).

Advanced

  • Enable Session Summary (on), Session Summary Path, Profile Name (Default), Update Frequency, Show Debug Output (off).
  • Enable Popup Alert (on), Alert Cooldown Period (30 s), Enable Quiet Mode (off), Quiet Mode Start / End.
  • Data Rate Tuning ... Use Adaptive Thresholds (on), Averaging Period (1–3600, default 30), Low/High Danger and Warning thresholds (KB/s), and the four adaptive factors.

Back to Table of Contents

XABCD Performance Indicator ... Documentation ... Version 1.7.0.20
A free tool from the XABCD suite. For support and updates, visit XABCDTrading.com