Start your 30-day free trial — use code MONARCH at checkoutBetter measurements. Better tools.Cancel anytime.
Start your 30-day free trial — use code MONARCH at checkoutBetter measurements. Better tools.Cancel anytime.

Market Inteligence Systems User Manuels & Setup

Please read user manual for our products before utalizing them

Setup
Market Structure Sys
Liquidity System
Market Institutional Risk Sys

‍

Installing Your Market Intellignece System in NinjaTrader 8

Getting started only takes a few minutes. Follow the steps below to install and begin using your Market Monarch indicator.

Installation Steps

Step 1 — Download Your Indicator

After completing your purchase, download the indicator .zip file to your computer. Save it somewhere easy to find, such as your Downloads folder.

Do not extract or unzip the file — NinjaTrader imports the ZIP file directly.

Step 2 — Open NinjaTrader 8

Launch NinjaTrader 8 and wait for the Control Center to finish loading.

Step 3 — Import the Indicator

  1. From the Control Center, click Tools → Import → NinjaScript Add-On...
  2. Browse to the downloaded .zip file, select it, and click Open .
  3. If prompted, click Yes to begin the installation.

NinjaTrader may take a few moments to compile the indicator — this is completely normal.

Step 4 — Open a Chart

  1. From the Control Center, select New → Chart .
  2. Choose the instrument you'd like to trade.
  3. Select your preferred timeframe.
  4. Click OK to open the chart.

Step 5 — Apply the Indicator

  1. Right-click anywhere on your chart and select Indicators...
  2. Locate your Market Monarch indicator in the list, or use the search bar to find it quickly.
  3. Select the indicator, then click Add (or double-click it).
  4. Adjust any settings if desired.
  5. Click Apply , followed by OK .

Your indicator is now active and ready to use.

Adjusting Indicator Settings

You can modify your indicator's settings at any time:

  1. Right-click the chart and select Indicators...
  2. Choose your Market Monarch indicator.
  3. Make any desired changes.
  4. Click Apply , then OK to save them.

Updating Your Indicator

When a new version becomes available:

  1. Close any charts using the indicator.
  2. Navigate to Tools → Import → NinjaScript Add-On...
  3. Import the new .zip file.
  4. Confirm the update if prompted.
  5. Reopen your charts if necessary.

Troubleshooting

The indicator doesn't appear in the indicator list. Make sure the import completed successfully, restart NinjaTrader if necessary, and verify that you imported the original .zip file rather than an extracted folder.

An import error appears. Ensure you're running the latest version of NinjaTrader 8 and that you're importing the correct version of the indicator.

The indicator is installed but nothing appears on the chart. Confirm that the indicator has been added to the chart, check that you're using a supported instrument and timeframe, and verify that any display settings or plot colors haven't been disabled.

‍

‍

Market Structure System — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: Combines three independent analytical engines into one indicator, each with its own on-chart dashboard:

  1. MMSE — Market Structure Engine: How strong and trustworthy is the current trend/breakout?
  2. MEE — Exhaustion Engine: Is the current move getting stretched and due for a pause?
  3. MPE — Pressure Engine: Which side — buyers or sellers — currently has control?

All three auto-scale their lookback and smoothing based on your chart's timeframe, from 1-minute scalping charts up through Daily bars.

1. What Problem This Solves

Most single-purpose indicators tell you one thing — trend strength, or volume, or momentum — in isolation. Market Structure System puts three complementary reads side-by-side on the same chart: whether the trend is structurally sound, whether it's gotten overextended, and who's actually in control right now. Because all three auto-scale to whatever timeframe you're on, you don't need separate versions of the indicator for a 1-minute scalping chart versus a Daily swing chart.

3. The Three Engines (Plain English)

MMSE — Market Structure Engine

Looks at how directional and efficient recent price movement has been (using several complementary "is this a real trend or just noise" measurements) alongside volume and volatility behavior. Produces four component scores plus one overall composite score, each on a 0–100 scale:

  • Market Structure — overall trend character (trending vs. choppy vs. mean-reverting)
  • Trend Probability — how likely the current direction is to persist, including a read on whether pullbacks are likely to keep getting bought (or sold)
  • Breakout Quality — how structurally sound a breakout looks, and how likely it is to follow through
  • Participation — how much volume/volatility support is behind the current move
  • Composite — a single blended score summarizing all of the above, with a bonus applied when several underlying structural readings agree strongly with each other

MEE — Exhaustion Engine

Runs completely independently from MMSE, using its own inputs. It asks: has this move gone far enough, fast enough, and long enough that it's due for a pause? It combines:

  • Momentum Stretch — how far and how fast price has moved from its recent average
  • Participation Climax — whether volume/volatility is behaving in a "blow-off" climactic way
  • Distance From Value — how far price has strayed from session VWAP and a shorter-term anchored VWAP reference
  • Move Maturity — how long the current directional move has been running, and whether pullbacks within it are getting shallower (a classic early warning sign)

These four combine into an overall Exhaustion score.

MPE — Pressure Engine

Also fully independent, this asks: right now, are buyers or sellers more in control? It looks at where price is closing within its range, short-term momentum, range expansion, volume, and new-high/new-low behavior, separately for the buy side and the sell side. This produces:

  • Buy Pressure and Sell Pressure scores
  • Dominance — the difference between the two, from -100 (heavy seller control) to +100 (heavy buyer control)
  • Pressure Quality — whether the current pressure reading looks structurally backed or just noisy

4. Auto Timeframe Scaling

The indicator detects your chart's bar period and automatically adjusts its internal lookback and smoothing windows into one of five tiers, so you don't need to manually retune settings when switching charts:

Scalp

  • Typical Bar Period: 1 minute
  • Behavior: Longest relative lookback, heaviest smoothing — filters tick-level noise

Fast Intraday

  • Typical Bar Period: 2–5 minutes
  • Behavior: Shorter lookback than Scalp, moderate smoothing

Intraday

  • Typical Bar Period: 10–15 minutes
  • Behavior: Medium lookback, moderate smoothing

Swing

  • Typical Bar Period: 30–60 minutes
  • Behavior: Standard lookback, light smoothing (the original baseline tuning)

Position

  • Typical Bar Period: 2hr, 4hr, Daily+
  • Behavior: Compressed lookback, minimal smoothing

The current tier is shown at the top of the MMSE dashboard (e.g. [ SWING MODE ] ).

The Exhaustion and Pressure engines use their own small, fixed rolling window independent of this tiering system, so they remain responsive on any chart without waiting on MMSE's timeframe detection.

5. On-Chart Elements

MMSE Dashboard (top-left, toggle: Show Dashboard Overlay)

Shows the timeframe mode, then four bordered blocks — Market Structure, Trend Probability, Breakout Quality, and Participation — each with a 0–100 score, a plain-language classification (e.g. "STRONG TREND," "DEVELOPING," "MEAN REVERTING"), and for some, a short behavioral note (e.g. "Pullbacks likely bought"). A final line shows the overall Market State (e.g. "TREND ACCELERATION," "RANGE BOUND").

Chart Background Coloring (toggle: Show Background Coloring)

Tints the chart background using the same color scale as the dashboard, based on the Composite score — green tones for strong structure, red tones for weak/mean-reverting conditions.

Exhaustion/Pressure Dashboard (bottom-left, toggle: Show Exhaustion/Pressure Dashboard)

A second panel combining both MEE and MPE: - Exhaustion section: overall Exhaustion score/classification, plus the four component readings (Momentum Stretch, Participation Climax, Distance From Value, Move Maturity) and a plain-language exhaustion state (e.g. "ELEVATED STALL RISK," "FRESH MOVE"). - Pressure section: a visual "tug-of-war" bar showing Buy vs. Sell pressure side by side, the Dominance score with a plain-language Flow State (e.g. "ACCUMULATION," "SELLER CONTROL," "BALANCED"), and Pressure Quality.

Exhaustion Wave (toggle: Show Exhaustion Wave)

A smooth, gradient-filled curve drawn below price that rises and falls with the Exhaustion score. It uses a deliberately cool blue → cyan → near-white color scale (rather than the warm red/orange/green used elsewhere) so it's never visually confused with the MMSE structure background or dashboard colors at a glance.

6. Settings Reference

Parameters

ATR Period (30-min baseline)

  • Description: ATR period used as the baseline for the "Swing" (30–60 min) tier; automatically re-scaled for other timeframes
  • Default: 14

RVOL Period (30-min baseline)

  • Description: Volume baseline period used as the baseline for the "Swing" tier; automatically re-scaled for other timeframes
  • Default: 20

Display

Show Background Coloring

  • Description: Tints the chart background based on the Composite score
  • Default: On

Show Dashboard Overlay

  • Description: Shows the MMSE dashboard panel (top-left)
  • Default: On

Exhaustion & Pressure

Show Exhaustion/Pressure Dashboard

  • Description: Shows the combined MEE + MPE dashboard panel (bottom-left)
  • Default: On

Show Exhaustion Wave

  • Description: Draws the cool-toned gradient wave curve reflecting the current Exhaustion score
  • Default: On

Anchored VWAP Bars

  • Description: Number of bars back used for the Exhaustion Engine's shorter-term anchored VWAP reference
  • Default: 60

7. How to Read the Dashboards

  • Green shades (score 81–100 / 61–80) = strong, healthy readings — strong trend, strong pressure, fresh move.
  • Gold (41–60) = developing/transitional/moderate readings.
  • Orange/Red (0–40) = weak structure, choppy/mean-reverting conditions, or (on the Exhaustion side) elevated stall risk.
  • MMSE "Market State" line = a one-line summary combining all four MMSE pillars (e.g. "TREND ACCELERATION" vs. "RANGE BOUND").
  • Exhaustion score climbing into the 60s/80s = the current move is getting stretched; historically a higher-risk time to be initiating fresh positions in the direction of the move.
  • Dominance moving strongly positive or negative = one side (buyers or sellers) is clearly winning control right now; "BALANCED" means neither side has a clear edge.
  • Pressure Quality = a sanity check on the Dominance reading — a high Dominance reading with low Pressure Quality suggests the imbalance may be noisier/less structurally reliable than it looks.

Remember: MMSE, MEE, and MPE are independent of each other. A strong MMSE trend reading does not guarantee low Exhaustion, and a high Exhaustion reading does not override or change what MMSE or MPE are showing — each panel should be read on its own terms, then combined by you into an overall picture.

8. Suggested Starting Points

  • New to the indicator: leave all four toggles on to see the full picture, then turn off whichever dashboard/visual you don't personally use.
  • Trend-following approach: lean on the MMSE dashboard's Composite/Market State first; use MPE's Dominance to confirm which side currently has control before entering with the trend.
  • Watching for exhaustion / reversal risk: keep an eye on the Exhaustion score and wave — a strong MMSE trend combined with a climbing Exhaustion score is often read as "still trending, but getting late in the move."
  • Different timeframes: you generally don't need to retune ATR Period or RVOL Period when switching charts — the auto-scaling tiers handle that. Those two settings only need adjusting if you want to shift the baseline tuning itself (they define the Swing-tier baseline that all other tiers scale from).

9. Troubleshooting

Dashboards don't appear at all

  • Likely Cause: Not enough historical bars loaded yet for MMSE's warm-up, or the relevant "Show ..." toggle is off
  • Fix: Load more chart history; confirm the corresponding Display / Exhaustion & Pressure toggle is on.

MMSE dashboard is blank/frozen but Exhaustion/Pressure dashboard works fine

  • Likely Cause: MMSE has a longer warm-up requirement (based on its auto-scaled lookback) than MEE/MPE, which use a small fixed window and start much sooner by design
  • Fix: This is expected — give MMSE more bars to warm up; it will populate once enough history is available.

Timeframe mode label seems wrong

  • Likely Cause: Uncommon bar types (e.g. tick or range bars) fall back to a default assumption for "minutes per bar"
  • Fix: This indicator is designed for time-based bars (minute/second/daily); tick or range bars may not auto-scale as intended.

Exhaustion Wave looks jumpy or oddly positioned

  • Likely Cause: The wave's vertical position is anchored to the session's low and its own recent range, so it should read smoothly within a session — a very early session (little range established yet) can look compressed at first
  • Fix: This should smooth out as more of the session builds; not a sign of a problem.

Composite/State seems to lag behind an obvious visual trend

  • Likely Cause: Multiple layers of EMA smoothing are applied deliberately to keep dashboard numbers from flickering bar-to-bar
  • Fix: This is by design — the dashboard favors stability over instant reaction; expect a short delay versus what your eyes see on the raw candles.

Colors on the Exhaustion Wave look similar to the MMSE background

  • Likely Cause: This shouldn't happen — the two use deliberately distinct color palettes (warm for MMSE, cool blue/cyan/white for Exhaustion) specifically so they're not confused
  • Fix: If this looks off, try removing and re-adding the indicator.

Quick Start Summary

  1. Add the indicator to your chart (named MMSE PRO in the indicator list; nicknamed Market Structure System ).
  2. Leave all four display toggles on initially to see the full picture: MMSE dashboard, background coloring, Exhaustion/Pressure dashboard, and Exhaustion Wave.
  3. Use the MMSE dashboard (top-left) to gauge overall trend structure and quality.
  4. Use the Exhaustion/Pressure dashboard (bottom-left) to gauge whether the move looks stretched (Exhaustion) and who's currently in control (Pressure/Dominance).
  5. Remember the three engines are independent — combine their readings yourself rather than expecting one to override another.
  6. No manual retuning is generally needed when switching timeframes; the indicator auto-scales its internal windows for you.

‍

‍

Liquidity System — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: A full Market/Volume Profile toolkit built around three questions: where is the important structure (volume-at-price levels), is price validating that structure over time, and who (buyers or sellers) built it. It combines volume profile (POC/VAH/VAL), a classic TPO (Time Price Opportunity) profile, rolling pivot-based support/resistance, Initial Balance-based Day Type / Open Type classification, and two on-chart dashboards.

1. What Problem This Solves

Market Profile / volume-at-price analysis usually requires several separate tools: a volume profile plugin, a TPO/Market Profile plugin, a separate support/resistance indicator, and manual tracking of Initial Balance and Day Type. Liquidity System combines all of this into one indicator with two clean dashboards, so you can see where value is being built, whether the structure is migrating in a meaningful direction, who's driving it, and the classic auction-theory context (Day Type, Open Type, Poor Highs/Lows, Single Prints) — all from one add.

3. The Core Engines (Plain English)

Structure Engine — WHERE is the important structure?

Builds a session volume-at-price histogram (a classic volume profile) and derives: - POC (Point of Control): the single price level with the most traded volume. - VAH / VAL (Value Area High / Low): the boundaries of the price range containing your chosen percentage (default 70%) of the session's volume, expanding outward from POC.

The indicator tracks this twice : a Developing profile for the current, still-forming session, and a frozen Settled snapshot of the prior completed session. This lets you compare today's forming value area against where value settled yesterday.

Migration Engine — IS price validating the structure?

Checks whether the POC has been moving in the same direction as price over your chosen lookback, and whether that movement is large enough (relative to ATR) to be meaningful. Only when both direction and magnitude agree does the engine register genuine "structural migration" — the idea being that a real trend should be backed by the volume structure actually shifting with it, not just price drifting while volume stays anchored where it was.

Delta Engine — WHO built the structure?

Uses a money-flow-style calculation (the same core idea as Chaikin Money Flow) accumulated per price level, so you get a sense of whether the volume traded at/near the current price was more buyer-driven or seller-driven.

HVN / LVN Node Classification

Classifies the price level at the current close as a High Volume Node (HVN) , Low Volume Node (LVN) , or Normal, by comparing its volume to a local rolling average of nearby price levels. HVNs tend to act as magnets/support-resistance; LVNs tend to be areas price moves through quickly.

Support / Resistance Engine

Independent of the volume-based structure above — this tracks classic pivot-based swing highs/lows over a rolling, multi-day window, aging out older levels as new ones are confirmed. Drawn as rays starting exactly at the pivot bar, not full-chart lines.

TPO (Time Price Opportunity) Profile

The classical Market Profile construction: the session is divided into fixed time brackets ("letters"), and a price level's TPO count is how many distinct brackets touched it — not volume. This can tell a different story than the volume profile: a price level hit by one huge fast volume spike can look "thin" on TPO but "wide" on volume, and vice versa for a level the market slowly rotated through across many brackets.

Initial Balance, Day Type & Open Type

The Initial Balance (IB) is the high/low range established in the first N minutes of the session (default 60). Once the IB window closes, the indicator classifies: - Day Type: how much the session extended beyond the IB range (e.g. "TREND," "NORMAL VARIATION," "NEUTRAL"). Note: this is a simplified classification and deliberately does not attempt to detect "Double Distribution" days. - Open Type: a simplified 3-way read of how the open behaved relative to the IB (e.g. "DRIVE," "TEST/ROTATE," "AUCTION"). Note: this is a simplified 3-way version of the classical 4-way Open Type taxonomy.

Poor Highs / Poor Lows & Single Prints

Using the same TPO bracket data, the indicator flags whether the session's high or low was touched by only one bracket (a "clean" rejection) or two-plus brackets (a "poor" extreme — more likely to be revisited later). It also counts Single Prints — price levels touched by exactly one TPO bracket, a classic sign the market moved through too quickly to build real two-sided interest there.

4. On-Chart Elements

Structure Dashboard (top-left, toggle: Show Structure Dashboard)

Shows: - Developing POC/VAH/VAL, Value Area width (in ATR terms, classified Narrow/Normal/Wide) - Settled (prior session) POC/VAH/VAL - Current Zone status (Above Value / Inside Value / Below Value) and distance from POC in ATR units - Nearest Resistance/Support pivot levels and their distance from price - Value Area migration vs. the settled session (Higher Value / Lower Value / Overlapping, with overlap %) - Poor High / Poor Low status and Single Print count - Session diagnostics (bar count, reset count, POC volume concentration %) - A compact color legend tying each chart line color to its meaning

Signal Dashboard (bottom-left, toggle: Show Migration/Delta Dashboard)

Shows the Migration Engine score/classification, the Delta Engine score/classification, current Node state (HVN/LVN/Normal), and the Day Type / Open Type classification for the session.

Chart Drawings

  • Developing POC/VAH/VAL: solid yellow (POC) and dashed blue (VAH/VAL) lines — today's active structure, drawn prominently.
  • Settled POC/VAH/VAL: solid orange (POC) and dashed sandy-brown (VAH/VAL) lines — yesterday's reference structure, deliberately muted so it recedes behind today's.
  • Support/Resistance: red rays (resistance) and green rays (support), each starting at its actual pivot bar.
  • Volume Profile shape (optional): a full histogram silhouette drawn to the right of price, developing (blue) and/or settled (orange), with an optional overlap highlight where both profiles share volume at the same price.
  • TPO Profile shape (optional): a mirrored histogram silhouette meeting the volume profile at a shared seam line, with Single Print levels specially highlighted in cyan.

5. Settings Reference

1 - Structure Engine

Value Area Percent

  • Description: Percentage of session volume captured by VAH/VAL, expanding from POC. 0.70 is the standard convention.
  • Default: 0.70

Show Developing Levels

  • Description: Draws today's still-forming POC/VAH/VAL
  • Default: On

Show Settled Levels

  • Description: Draws the prior session's frozen POC/VAH/VAL
  • Default: On

Force Calendar Day Reset

  • Description: Additionally resets the developing profile on any calendar date change (on top of the normal session reset). Caution: for instruments trading overnight across midnight, this will artificially split that session at midnight.
  • Default: Off

2 - Migration Engine

Migration Lookback (Bars)

  • Description: How many bars back to compare current POC/price against
  • Default: 20

Migration Magnitude ATR Multiple

  • Description: Minimum POC movement (in ATR units) over the lookback required to count as significant
  • Default: 0.5

3 - Delta / Node Engine

HVN/LVN Local Window (Ticks)

  • Description: Ticks on each side of current price used for the local average volume comparison
  • Default: 10

HVN Multiple

  • Description: Current price bucket is classified HVN when its volume exceeds this multiple of the local average
  • Default: 1.5

LVN Multiple

  • Description: Current price bucket is classified LVN when its volume is below this multiple of the local average
  • Default: 0.5

4 - Shared

ATR Period

  • Description: Used by the Migration Engine's magnitude gate and the Value Area Width / Distance From POC diagnostics
  • Default: 14

Engine Smoothing (Bars)

  • Description: EMA smoothing applied to both Migration and Delta scores
  • Default: 3

5 - Display

Show Structure Dashboard

  • Description: Top-left panel
  • Default: On

Show Migration/Delta Dashboard

  • Description: Bottom-left panel
  • Default: On

6 - Support/Resistance

S/R Pivot Lookback (Bars)

  • Description: Bars required on both sides for a bar to register as a swing high/low; larger = fewer, more significant pivots
  • Default: 10

Max S/R Levels (Each Side)

  • Description: How many of the most recent confirmed pivots to keep (older ones age out)
  • Default: 4

Show S/R Levels

  • Description: Draws the rolling pivot-based levels
  • Default: On

7 - Volume Profile Shape

Show Developing Volume Profile

  • Description: Draws the full developing session histogram shape (not just POC/VAH/VAL lines). No cap on bucket count — a real performance cost, accepted deliberately; turn off if it causes lag.
  • Default: Off

Show Settled Volume Profile

  • Description: Draws the full settled (prior) session histogram shape. Same performance tradeoff.
  • Default: Off

Profile Max Width (Bars)

  • Description: How many bars wide the single largest (POC) bucket is drawn; all others scale proportionally
  • Default: 30

Dev Volume Profile Color / Opacity

  • Description: Color and opacity of the developing profile shape
  • Default: DodgerBlue / 40

Settled Volume Profile Color / Opacity

  • Description: Color and opacity of the settled profile shape
  • Default: Orange / 40

Highlight Dev/Settled Overlap

  • Description: Opt-in: highlights, in a third color, the portion of each price level present in both profiles. Requires both Dev and Settled profile shapes enabled.
  • Default: Off

Overlap Color / Opacity

  • Description: Color/opacity of the overlap highlight
  • Default: White / 60

8 - TPO Profile

Show Developing TPO Profile

  • Description: Draws the developing session's TPO histogram shape (width = distinct time brackets touching each price, not volume). Same no-cap performance tradeoff as the volume profile.
  • Default: Off

Show Settled TPO Profile

  • Description: Draws the prior session's TPO histogram shape
  • Default: Off

TPO Bracket Size (Minutes)

  • Description: Length of each time bracket, from session start. 30 minutes is the classic convention.
  • Default: 30

TPO Profile Max Width (Bars)

  • Description: How many bars wide the largest TPO bucket is drawn
  • Default: 30

TPO Gap From Volume Profile (Bars)

  • Description: Optional cosmetic buffer between the volume profile's edge and TPO's edge; 0 means they share the exact same seam line
  • Default: 0

Dev TPO Color / Opacity

  • Description: Color/opacity of the developing TPO shape
  • Default: MediumPurple / 40

Settled TPO Color / Opacity

  • Description: Color/opacity of the settled TPO shape
  • Default: DarkViolet / 40

9 - Day Type / Open Type

Initial Balance Minutes

  • Description: Length of the Initial Balance window from session start. 60 minutes is the classical convention; Day Type and Open Type are both built from this window.
  • Default: 60

6. How to Read the Dashboards

  • Value Area Width classified "NARROW (TRENDING)" = a tight value area, often associated with directional/trending days.
  • Value Area Width classified "WIDE (BALANCE)" = a wide value area, often associated with balanced, range-bound days.
  • Zone: "ABOVE VALUE (VAH)" (green) = price trading above the developing value area — often read as bullish/strength.
  • Zone: "BELOW VALUE (VAL)" (red) = price trading below the developing value area — often read as bearish/weakness.
  • Zone: "INSIDE VALUE" (gold) = price trading within the accepted value area — more balanced/rotational.
  • Migration Engine score climbing = the volume structure (POC) is genuinely moving with price, not just price drifting on its own — generally reinforces confidence in a trend.
  • Delta Engine "BUY BIAS" / "SELL BIAS" = the volume traded at/near the current price level leaned more buyer- or seller-driven.
  • Node: "HVN" = current price sits at a high-volume node — often acts as a magnet or support/resistance.
  • Node: "LVN" = current price sits at a low-volume node — often a level price moves through quickly.
  • Day: "TREND" = the session has extended well beyond its Initial Balance in one direction.
  • Day: "NEUTRAL" = the session extended in both directions beyond the IB.
  • Open: "DRIVE" = a strong, directional open with no cross-back through the open price.
  • Open: "TEST/ROTATE" = the IB crossed back through the open price at least once.
  • Poor High/Low labeled "POOR (n)" = that session extreme was touched by 2 or more TPO brackets — a less decisive rejection, more likely to be tested again later.
  • Single Prints count > 0 = there are price levels the market moved through too quickly to build real two-sided interest — visually highlighted in cyan within the TPO shape if it's enabled.

7. Suggested Starting Points

  • New to the indicator: start with just the two dashboards on (both enabled by default) and the developing/settled level lines — leave the Volume Profile and TPO shapes off at first, since both carry a real, deliberate performance cost with no cap on bucket count.
  • Want the full visual profile shapes: turn on Show Developing/Settled Volume Profile and/or Show Developing/Settled TPO Profile once you've confirmed performance is acceptable on your machine/chart; reduce Profile Max Width (Bars) if the shapes feel too wide.
  • Auction theory / Market Profile traders: pay particular attention to the Structure Dashboard's Value Area migration line, Poor High/Low status, and Single Print count, plus the Signal Dashboard's Day Type/Open Type — these are the classical Market Profile reads this indicator is built to surface.
  • Trend confirmation: combine a rising Migration Engine score with a Delta Engine reading in the same direction, and a Zone status of "Above/Below Value" in that direction, for a fuller picture than any one signal alone.

8. Troubleshooting

Dashboards don't appear

  • Likely Cause: Not enough bars loaded yet, or the relevant "Show ... Dashboard" toggle is off
  • Fix: Load more chart history; confirm Show Structure Dashboard / Show Migration/Delta Dashboard are on.

Settled levels/dashboard show "n/a"

  • Likely Cause: No completed session yet in your loaded chart history
  • Fix: Load more chart history so at least one full prior session is available.

Volume Profile or TPO shape causes noticeable lag

  • Likely Cause: Both are drawn with no cap on the number of price-level buckets, by deliberate design
  • Fix: Turn off Show Developing/Settled Volume Profile and/or the TPO equivalents if performance is a concern; the dashboards and level lines work independently of these shapes.

Volume Profile / TPO shapes don't appear where expected

  • Likely Cause: These are drawn into the empty space to the right of the current bar (negative bars-ago) — a mechanic the indicator's author notes is the least verified part of the drawing logic
  • Fix: Try adjusting Profile Max Width (Bars) / TPO Profile Max Width (Bars) ; ensure your chart has empty space to the right of the current bar to display into.

TPO and Volume Profile shapes visually blend together at the seam

  • Likely Cause: They're intentionally drawn to meet flat-edge-to-flat-edge at the same seam line by default
  • Fix: Increase TPO Gap From Volume Profile (Bars) slightly for a visible hairline separation.

Day Type / Open Type show "IB FORMING..." all session

  • Likely Cause: The Initial Balance window hasn't elapsed yet
  • Fix: This is expected until Initial Balance Minutes worth of the session has passed; classification only makes sense once the IB range is fully established.

Dashboard appears to freeze / stop updating

  • Likely Cause: The indicator includes a self-healing mechanism for a rare stuck-update case; it should recover on its own after a few bars
  • Fix: If it doesn't recover, try removing and re-adding the indicator.

Overlap highlight doesn't appear

  • Likely Cause: Highlight Dev/Settled Overlap requires both Show Developing Volume Profile and Show Settled Volume Profile to be enabled, plus a completed prior session
  • Fix: Confirm all three conditions are met.

Quick Start Summary

  1. Add the indicator to your chart (named LiquidityPRO in the indicator list; nicknamed Liquidity System ).
  2. Leave both dashboards on to start: Structure (top-left) and Migration/Delta (bottom-left).
  3. Use the Structure Dashboard for POC/VAH/VAL, Zone status, and auction-theory context (Poor Highs/Lows, Single Prints, Value Area migration).
  4. Use the Signal Dashboard for Migration Engine (is structure validating price?), Delta Engine (who's driving it?), Node state, and Day Type/Open Type.
  5. Turn on the Volume Profile and/or TPO profile shapes only if you want the full visual histogram — both carry a real performance cost by design.
  6. Use Support/Resistance rays alongside the volume-based levels for a second, independent reference set.

‍

Market Institutional Risk System — User Guide

Type: NinjaTrader 8 Indicator (custom NinjaScript) What it does: Runs six independent risk/market-condition engines every bar (Volatility, Market Efficiency, Choppiness, Trend Conviction, Volume Risk, Statistical Risk), then combines them through a Master engine into two separate headline scores — a Risk score and an Opportunity score — plus an overall risk category, a market classification, and a suggested position size. Results are shown in an on-chart dashboard and a color-coded "heat ribbon" along the bottom of the price panel, and can optionally be exported to CSV for deeper review in Excel.

Important — please read: This is explicitly a Phase 1 / provisional build. Several planned engines (Market Structure, Velocity, Liquidity/Execution, News) are not yet built, and the Master engine's internal weightings are hand-assigned starting points that have not yet been calibrated against real forward outcomes. The indicator discloses this honestly through a built-in confidence penalty — the Confidence reading you see is deliberately reduced to reflect the current incompleteness. Treat this as a decision-support tool to combine with your own judgment, not a finished, validated system.

1. What Problem This Solves

Instead of checking five or six separate indicators (a volatility read, a trend-strength read, a volume read, etc.) and mentally combining them yourself, this indicator runs all of them together every bar and combines them into one clear picture: how risky are current conditions, how much genuine opportunity is present. Critically, Risk and Opportunity are tracked as two separate axes — a market can be both high-risk and high-opportunity at the same time, and the indicator won't hide that by collapsing everything into a single number.

3. The Six Component Engines (Plain English)

Volatility Risk

  • What It Measures: Blends several different volatility measurements (ATR, standard deviation of returns, and a few other statistical volatility estimators), each ranked against its own recent history, into one 0–100 risk read. Regimes: Low / Medium / High / Extreme.

Market Efficiency

  • What It Measures: Uses measures of return persistence and pattern complexity to judge whether price is moving in a genuinely directional, trending way, behaving more randomly, or acting chaotically/erratically. Regimes: Trending / Random / Mean-Reverting / Chaotic.

Choppiness

  • What It Measures: Measures how much price is oscillating back and forth rather than moving cleanly, combining a choppiness-style range measure, trend strength, and how often direction flips. Regimes: Smooth Trend / Healthy Trend / Neutral / Choppy / Highly Choppy.

Trend Conviction

  • What It Measures: Judges how strong and structurally sound the current trend is — including a simple check for whether the trend appears to be decelerating (an early exhaustion warning). Regimes: Weak / Developing / Healthy / Strong / Exhausted.

Volume Risk

  • What It Measures: Looks at relative volume, volume steadiness, and how much price range is being produced per unit of volume, to judge whether participation looks healthy, thin, institutional-like, retail-like, or exhausted/climactic. Regimes: Healthy / Thin Market / Institutional / Retail / Exhaustion.

Statistical Risk

  • What It Measures: Combines drawdown, skew, "fat-tailedness" (kurtosis), volatility clustering, and how unusual the most recent return is, into a broader statistical risk read. Regimes: Low / Moderate / High / Extreme.

Each engine also reports its own Confidence — how much history/data it had available when producing its score.

4. The Master Engine — Risk & Opportunity Axes

The Master engine takes all six component results and produces:

  • Risk Score (0–100): built from three grouped factor families — a combined Volatility/Statistical family, a Trend/Structure family (based on Choppiness, plus an escalation when Trend Conviction shows "Exhausted" or Efficiency shows "Chaotic"), and a Participation family (based on Volume Risk, dampened when participation looks healthy/institutional, and floored high when it shows exhaustion).
  • Opportunity Score (0–100): built independently from Trend Conviction, Market Efficiency, "smoothness" (the inverse of Choppiness), and a participation-quality read — deliberately not derived from the Risk score, so the two can genuinely disagree.
  • Overall Risk Category: Very Safe / Low Risk / Moderate Risk / High Risk / Extreme Risk, based on the Risk score.
  • Quadrant: combines Risk and Opportunity into one of four quadrants — High Opportunity/Low Risk, High Opportunity/High Risk, Low Opportunity/High Risk, or Low Opportunity/Low Risk.
  • Market Classification: a proxy directional read (Bullish / Bearish / Sideways / Compression / Expansion / Transition), built from a price-slope regression combined with the Volatility and Trend Conviction regimes. This is explicitly a placeholder for a proper swing-structure-based classification that isn't built yet.
  • Confidence: the average confidence of the six component engines, reduced by an explicit incompleteness penalty reflecting the engines and factor families not yet built.

5. On-Chart Elements

Dashboard (toggle: Show Dashboard)

A HUD strip across the top of the chart showing the Master engine's headline outputs: Risk (with a colored gauge bar), Opportunity (with a colored gauge bar), Quadrant, market State/Classification, Suggested Size, and Confidence.

Component Engine Row (toggle: Show Component Engines)

An optional second row beneath the main dashboard, breaking out each of the six component engines with its abbreviation, score, current regime, and a small magnitude bar.

Master Ribbon (toggle: Show Master Ribbon)

A two-lane color "heat tape" running along the bottom of the price panel, one cell per bar: the upper lane shows Opportunity (green intensity — brighter green means higher opportunity), and the lower lane shows Risk (a green → amber → red ramp). This lets you see how Risk/Opportunity have evolved underneath the price action, not just their current values.

NinjaScript Output / CSV Export

Every bar's full results (all six engines plus the Master engine) are printed to the NinjaScript Output window, and — if enabled — exported to a CSV file for detailed review in Excel, rebuilt fresh from full history on every chart load.

6. Settings Reference

Parameters

Volatility Short Period

  • Description: Lookback for the Volatility Risk engine
  • Default: 14

Efficiency Period

  • Description: Lookback for the Market Efficiency engine
  • Default: 50

Choppiness Period

  • Description: Lookback for the Choppiness engine
  • Default: 20

Trend Conviction Period

  • Description: Lookback for the Trend Conviction engine
  • Default: 30

Volume Risk Period

  • Description: Lookback for the Volume Risk engine
  • Default: 20

Statistical Risk Period

  • Description: Lookback for the Statistical Risk engine
  • Default: 50

Master Engine

Dashboard

Show Dashboard

  • Description: Toggles the main HUD strip
  • Default: On

Show Component Engines

  • Description: Toggles the second row breaking out all six engines
  • Default: On

Dashboard Height (px)

  • Description: Total height of the dashboard strip
  • Default: 120

Show Master Ribbon

  • Description: Toggles the Risk/Opportunity heat tape along the bottom of the price panel
  • Default: On

Ribbon Lane Height (px)

  • Description: Height of each of the two ribbon lanes
  • Default: 16

‍

7. How to Read the Dashboard

  • Risk gauge (green → red): green/low = calmer, safer conditions; red/high = elevated risk from volatility, choppiness, exhaustion, or thin/exhausted participation.
  • Opportunity gauge (green intensity): brighter green = cleaner, more tradeable directional conditions with supportive participation; dim = little edge currently present.
  • Quadrant: the fastest way to get the combined picture at a glance — "High Opportunity / Low Risk" is the most favorable reading; "Low Opportunity / High Risk" the least.
  • State/Classification: a directional label (Bullish/Bearish) or a condition label (Compression, Expansion, Sideways, Transition) — remember this is a proxy read, not confirmed swing structure.
  • Size: a starting-point suggestion only, scaled by both Risk Category and Opportunity — always apply your own risk management on top of this.
  • Confidence: reflects both how much history the component engines have, and an explicit penalty for the engines/factor-families not yet built. A lower Confidence reading doesn't mean something is broken — it's the indicator being upfront about its current scope.
  • Master Ribbon colors underneath price: lets you visually correlate past Risk/Opportunity conditions with what price actually did afterward — useful for building your own intuition about how this indicator behaves on your instrument before relying on it.

8. Suggested Starting Points

  • New to the indicator: watch the dashboard and ribbon alongside your normal chart reading for a while before using the Suggested Size for anything — get a feel for how Risk/Opportunity line up with what you already know about the instrument.
  • Use the CSV export if you want to study how the Master engine's readings would have lined up with actual subsequent price behavior — this is explicitly what the export was built to support, since the internal weightings are not yet calibrated against real outcomes.
  • Don't rely solely on Market Classification for directional bias yet — treat it as one input among several, given it's a proxy pending a proper structure engine.
  • Sizing: treat the Suggested Size as a ceiling-and-scaling starting framework, not a recommendation — combine it with your own account risk rules.

9. Troubleshooting

Dashboard/ribbon don't appear

  • Likely Cause: Not enough bars loaded yet (a warm-up period is required for the more data-hungry engines), or the relevant "Show ..." toggle is off
  • Fix: Load more chart history; confirm Show Dashboard / Show Master Ribbon are on.

Dashboard renders blank or seems to silently fail

  • Likely Cause: Render-thread errors are logged once to the NinjaScript Output window rather than crashing silently
  • Fix: Check Control Center → New → NinjaScript Output for a "MMIRE dashboard render error" message.

CSV file doesn't appear

  • Likely Cause: Enable CSV Export is off, or the export folder couldn't be created
  • Fix: Confirm the toggle is on; check the NinjaScript Output window for the printed export path or any folder/file error message.

CSV file seems to reset unexpectedly

  • Likely Cause: This is by design — the file is deleted and rebuilt fresh from full history every time the indicator loads/reloads
  • Fix: Copy or rename the CSV elsewhere if you want to preserve a specific export before reloading the indicator.

Confidence reading seems low even in calm, clear conditions

  • Likely Cause: The Master engine applies an explicit penalty reflecting its currently partial engine set (several planned engines aren't built yet)
  • Fix: This is expected and intentional — it is not a sign of a data problem.

Market Classification doesn't match your own read of the trend

  • Likely Cause: Classification is a slope/regime-based proxy, not confirmed swing structure
  • Fix: Treat it as supporting context rather than a standalone trend signal until a dedicated structure engine is available.

Dashboard looks cramped or cut off

  • Likely Cause: Dashboard Height (px) may be too small for two-row mode
  • Fix: Increase Dashboard Height (px) , or turn off Show Component Engines to use the single-row layout.

Quick Start Summary

  1. Add the indicator to your chart (named MMIRE in the indicator list; nicknamed Market Institutional Risk System ).
  2. Leave the dashboard, component row, and ribbon on to see the full picture at first.
  3. Read the Risk and Opportunity gauges together via the Quadrant label for the fastest combined read.
  4. Use the Master Ribbon to see how Risk/Opportunity have evolved underneath recent price action.
  5. Treat Suggested Size as a starting framework, not a recommendation, and always apply your own risk rules on top.
  6. Remember this is a provisional, partially-built system — the Confidence reading and the notes above are there to keep that front and center, not hidden.