PERCENTCHANGECHART - ADDON
Addon for NinjaTrader 8
Multi-Tab Percent Change Comparison Tool
================================================== ==============================
Provided by NinjaTrader Live
"https://www.youtube.com/@NinjaTrader/streams"
Version 2.0 • March 2026

================================================== ==============================
OVERVIEW
PercentChangeChart is a NinjaTrader8 addon that opens a standalone multi-tab window for comparing the
percent change of multiple symbols from a user-defined anchor date. It normalizes price data across
instruments with different price levels, letting you instantly see which markets are outperforming or
underperforming over any time horizon. This is not a charting indicator - it is an addon.

To Open this PercentChangeChart Addon - Click NEW in the Control Center - and it is located at the bottom. (see pic below)

Traders use percent change charts to compare the relative performance of different instruments over a
specific period of time. By normalizing price movement as a percentage rather than displaying raw price
values, these charts allow traders to evaluate performance over different time horizons objectively,
regardless of differences in price levels.

Up to 12 symbols per Tab is allowed (to load Stock or ETF symbols
add an * asterisk before each symbol e.g. *MSFT, *NVDA,

================================================== ==============================
GETTING STARTED
1. Download and import the PercentChangeChart.cs file into NinjaTrader 8
2. Open the tool from Control Center → New → Percent Change Chart (It will be at the bottom of the new Menu)
3. Three default tabs load automatically:
• Indices (ES, NQ, RTY, YM)
• Energy (CL, NG, HO, RB)
• Metals (GC, SI, HG, PL)
4. Modify symbols, anchor date, or bar type as needed, then click
the red Update button
5. Use the ⚙ (cog) button to open Properties, or ? for Help / FAQ
6. Press {UPDATE} to bring in fresh data

================================================== ==============================
KEY FEATURES
MULTI-TAB INTERFACE
───────────────────
• Each tab holds an independent set of symbols with its own anchor date and bar type settings
• Add tabs by clicking the + tab; close tabs with ✕ (minimum one tab)
• Double-click a tab name to rename it; drag tabs to reorder
• Tab configurations persist across sessions via PercentChangeChartTabs.xml

AUTOMATIC FRONT-MONTH RESOLUTION
─────────────────────────────────
• Enter root symbols (ES, NQ, CL, GC) and the tool automatically resolves to the current front-month futures contract

STOCK AND ETF SUPPORT
─────────────────────
• Prefix stocks and ETFs with an asterisk: *AAPL, *SPY, *QQQ
• Stocks bypass front-month resolution and use the symbol directly

GLOBAL PROPERTIES
─────────────────
• All tabs share a single set of visual properties (theme, fonts, colors, legend settings)
• Changes made via the cog button apply to every tab immediately
• Click "Set as Default" to save properties to PercentChangeChartDefaults.xml for future windows

INTERACTIVE CHART
─────────────────
• Hold left mouse button on the chart to display a crosshair with detailed tooltip showing bar data for all symbols
• Tooltip includes date/time, open, close, and percent change at the selected bar
• Chart auto-scales Y-axis with nice tick intervals and draws a dashed zero line

================================================== ==============================
TOOLBAR CONTROLS

Control Description
Bar Type Select bar period: Minute, Day, Week, or Month
Value Bar interval value (e.g., 5 for 5-min, 1 for daily)
Anchor Date Zero-percent baseline date. Type MM/DD/YYYY or use the Cal button for a calendar popup
Symbols Comma-separated symbol list (up to 12). Use * prefix for stocks/ETFs
Update Load/reload data for all symbols on the current tab
⚙ (Cog) Open the Properties dialog (applies to all tabs)
? (Help) Open the Help / FAQ dialog

================================================== ==============================
PROPERTIES
All properties are shared across tabs. Open the Properties dialog
from any tab's cog button.

THEME
• Dark (default) or Light — controls chart background, border,
and symbol color palettes

LINES
• Line Thickness: 1–10 (default 2)
• Zero Line Thickness: 1–10 (default 1)
• Zero Line Color: any named color (default Gray)

SCALE
• Font Size: 6–24 (default 13)
• Font Bold: True/False (default True)
• Font Color: any named color (default Silver)

LEGEND
• Font Size: 8–24 (default 17)
• Font Bold: True/False (default True)
• Show Full Symbol: True = "ES 03-26", False = "ES" only
• Show Last Price: display current price (L: value)
• Show Anchor Price: display baseline price (A: value)
• Show TPC: Today's Percent Change (Close vs PrevClose)
• Position: Top Right, Top Left, Bottom Right, Bottom Left, Top Center

PRICE TABS
• Show Price Tabs: colored percent-change labels on right Y-axis
• Font Color: text color inside the price tab (default Black)

================================================== ==============================
UNDERSTANDING THE LEGEND
The legend displays real-time performance data with color-coded
indicators. Symbols are automatically sorted from best to worst
performer (highest to lowest percent change from anchor). The sort
order is locked at load time and does not shuffle during the session.

Legend Format (all fields enabled):
NQ +4.25% L:22362.63 A:21450.00 TPC:+0.87%
ES +2.18% L:6110.25 A:5980.00 TPC:+0.42%
YM +1.05% L:44260.00 A:43800.00 TPC:-0.15%
RTY -0.33% L:2232.60 A:2240.00 TPC:-0.52%

Field Descriptions:
Symbol Root or full contract name (Show Full Symbol setting)
Pct Change Cumulative percent change from anchor date open price
L: Most recent closing price
A: Open price on the anchor date (zero-percent baseline)
TPC: Today's Pct Change = (Close − PrevClose) / PrevClose

================================================== ==============================
CONFIGURATION FILES

The addon creates two XML files in the NinjaTrader user data directory.
Both are created on demand and use built-in defaults if absent.

PercentChangeChartTabs.xml
PercentChangeChartDefaults.xml

================================================== ==============================
TROUBLESHOOTING

NO DATA DISPLAYED
• Check symbols — verify all symbols are valid and have data
• Check anchor date — must fall on a trading day with available data;
the tool looks for the Daily Open price on this exact date
• Load history — ensure NinjaTrader has loaded historical data back to the anchor date
• Check data connection — confirm your data feed is active

SYMBOL NOT RESOLVING
• Invalid symbol — check spelling (CL, NG, not Cl or ng)
• Data provider — ensure your feed supports the instrument
• Manual entry — if auto-detection fails, enter the full contract (e.g., ES 03-26)

PERCENT VALUES SEEM INCORRECT
• Use "Merged Unadjusted" data — go to Tools → Settings → Market
Data and verify. Adjusted data shifts historical prices and will produce inaccurate percent change calculations.

PROPERTIES NOT APPLYING TO ALL TABS
• Properties are shared globally. Changes via the cog button apply to all tabs when you click Apply or OK.
• If a tab looks different, click Update to reload its data.

Q: Comments or suggestions?
────────────────────────────
Email: [email protected]

================================================== ==============================
SUPPORT & FEEDBACK
Email: [email protected]
Watch NinjaTraderLive: https://www.youtube.com/@NinjaTrader/streams

================================================== ==============================
DISCLOSURE
Futures trading and strategy trading involves substantial risk and the
potential for loss of capital. All NinjaScript code contained herein is
provided by NinjaTrader, LLC and is for educational and demonstrational
purposes only.

This addon is provided "as-is" without warranty of any kind. Trading
futures and other financial instruments involves substantial risk of
loss and is not suitable for all investors. Always verify critical
information through multiple sources.

• Test thoroughly in simulation before live trading
• The developer assumes no liability for trading losses
• You alone are responsible for your own trading decisions

You can find additional disclosure information on the NinjaTrader.com
website.​