Xtrend Algo V10
Strategy Documentation
Explore the trading modes, liquidity signals, risk controls, indicators, chart panel, ML options and real parameter groups — with annotated product screenshots and practical usage guidance.
Overview
Getting started
Use simulation and a supported live market-data connection before enabling automated orders. Xtrend has distinct layers: NinjaTrader detects and routes; the optional desktop Control Center exposes a localhost service; BookMap/Footprint/VWAP dependencies supply evidence. The desktop app does not load NinjaTrader assemblies or command the strategy.
- Import the vendor’s complete NinjaTrader export, including every required custom indicator. Compile in NinjaScript Editor. If types such as
XtrendBookMapare missing, stop and obtain the complete dependency export. - Open a chart for the intended instrument and connect a feed that supplies the data required by your selected features. Depth-driven features need valid bid/ask depth; a bar-only connection is not equivalent.
- Add the required indicators first, then add XtrendGoldEditionPlus as a strategy. Use a Simulation account for first use.
- Confirm the account, quantity, session/risk limits, order method, and
Combine Mode. Apply the strategy only after reviewing the NinjaTrader log/output. - For optional Flow AI, start the licensed desktop application. Its healthy state can be checked at the local service; an absent validated model is an expected state, not evidence of a working confirmation gate.
Exact menu clicks and all indicator dialogs require screenshot/runtime verification; source code alone cannot establish a customer’s NinjaTrader build or installed dependency set.
Every Strategy Setting
BookMap detector parameters — interpretation guide
| Signal | Example code default / reference | How to interpret it |
|---|---|---|
| Absorption | Minimum Displayed Queue: 2,000 contracts | Visibility alone is insufficient: matched trades, observed depletion and causal refresh must qualify. Effective thresholds can be synchronized by the strategy. |
| Exhaustion | Detection Threshold: 500 contracts | Uses a baseline, current thin queue, depletion percentage and time spent thin; trade-volume fields are diagnostic, not the qualification rule. |
| Iceberg | Minimum Trade Prints: 3 | Requires linked prints and replenishment evidence; not proof that a hidden order exists. |
| Whale | Burst threshold: 1,000 contracts | Aggregated classified prints must remain on the same side, close to the initial price, and inside the event-time window. |
| Liquidity Wall | Wall threshold: 50 contracts; nearby: 3 ticks; stable: 2 seconds | Size, proximity, stability, drift and disappearance grace must all be considered. CompareOnly retains the Legacy engine as live authority. |
| Spoofing Reversal | Disabled in the audited code defaults; minimum pull 70% | A quote-pull and price-reaction heuristic with execution reconciliation; does not identify manipulative intent. |
| Flash Magnet | Size ≥ 80; growth ≥ 40; relative depth ≥ 1.5×; persistence ≥ 150 ms | Requires an eligible nearby quote and subsequent movement toward that level inside its reaction window. |
Reference values above originate from the supplied source-audit parameter matrix, not from a verified active customer template. They should not be copied blindly as recommended settings.
Complete strategy parameter catalog
How to read this catalog
AI entry confirmation —
| Display name / platform label | Default; allowed | What it controls and dependencies |
|---|---|---|
Enable AI Confirmation / EnableAIConfirmation | not verified; Boolean | Enables Flow AI request handling. Entry blocking occurs only with AI Confirm Mode=GATE; otherwise it records/advises. Requires reachable local API and a validated Flow model for a valid prediction. |
AI Confirm Mode / AIConfirmMode | SHADOW; SHADOW, ADVISORY, GATE | Shadow/advisory do not block in FlowAiEntryAllowed; Gate evaluates the returned probability and fallback policy. |
AI Min Confirm Prob / AIMinConfirmProb | source-defined; 0–1 | Lower acceptance boundary used by the Flow request/gate. Higher is stricter. |
AI Strong Confirm Prob / AIStrongConfirmProb | source-defined; 0–1 | Strong acceptance threshold; higher is stricter. |
AI Neutral Prob / AINeutralProb | source-defined; 0–1 | Neutral probability boundary used with Neutral Allows Entry. |
AI Reject Below Prob / AIRejectBelowProb | source-defined; 0–1 | Probabilities below this are rejected in Gate behavior. |
AI Neutral Allows Entry / AINeutralAllowsEntry | source-defined; Boolean | In Gate mode, determines whether a neutral result may proceed. |
AI Learn From Results / AILearnFromResults | source-defined; Boolean | Allows asynchronous feedback after terminal ledger results; it does not train inline on the order path. |
AI Update Mode / AIUpdateMode | INSTANT_CANDIDATE; OFF, BATCH, INSTANT_CANDIDATE | Off suppresses feedback; other modes are sent to /flow_feedback. |
AI Model Scope / AIModelScope | GLOBAL_FLOW; GLOBAL_FLOW | Only exposed scope in this build. |
AI If Unavailable / AIIfUnavailable | ALLOW; ALLOW, BLOCK | Gate fallback when no valid/validated result exists. Allow preserves entry; Block rejects it. |
Show AI Confirmation / ShowAIConfirmation | source-defined; Boolean | Enables the source’s AI confirmation display/diagnostics. |
AI Request Timeout Ms / AIRequestTimeoutMs | source-defined; 25–2000 ms | Synchronous prediction timeout. A shorter timeout reduces waiting but increases unavailable outcomes. |
L2 Micro —
| Property | Default; allowed | Meaning |
|---|---|---|
L2 Micro Mode / L2MicroMode | Advisory; Off, Advisory, ML Feature, ConfirmEntries | Off disables engine. Advisory calculates/exports without blocking; ML Feature records evidence; ConfirmEntries requires fresh supporting L2 evidence. |
Depth Levels / L2MicroDepthLevels | 5; 1–20 | Bid and ask levels included; higher uses more depth. |
Maximum L2 Age (ms) / L2MicroFreshnessMs | 1000; 100–10000 | Old evidence is stale and cannot confirm. Lower is stricter. |
Confirmation Probability / L2MicroConfirmThreshold | 0.60; 0.50–0.95 | Minimum directional probability only in ConfirmEntries. Higher is stricter. |
Minimum L2 Evidence / L2MicroMinimumEvidence | 0.25; 0–1 | Minimum coverage/maturity/spread-quality composite for confirmation. |
Show L2 Micro Diagnostics / ShowL2MicroDiagnostics | false; Boolean | Rate-limited Output-window diagnostics. |
Enable L2 Entry Research Log / EnableL2EntryResearchLog | false; Boolean | Optional JSONL record for successful automated entries; not a trade gate. |
L2 Research Log Path / L2ResearchLogPath | empty; folder path | Destination for optional L2 entry telemetry. |
L2 learning and research —, research partials
| Property | Default; allowed | Meaning |
|---|---|---|
Enable L2 Candle Learning / EnableL2CandleLearning | false; Boolean | Writes one learning row per completed candle only when logging/depth prerequisites are met. |
Future Label Horizon Bars / L2LearningHorizonBars | 5; 2–50 bars | Later completed bars used for the future-move label. |
L2 Snapshot Interval (ms) / L2LearningSnapshotIntervalMs | 250; 25–5000 | Minimum time between stored depth snapshots. |
Minimum Depth Snapshots / L2LearningMinimumDepthSnapshots | 3; 1–1000 | Candles below this count are rejected. |
Require L2 Depth / L2LearningRequireDepth | true; Boolean | Excludes candles without valid bid/ask depth. |
Include Candles Without BM Signal / L2LearningIncludeNoBmBars | true; hidden legacy | Source says BM rows now require selected BM sources; displayed value is legacy compatibility. |
Legacy Label Move Threshold (ticks) / L2LearningLabelMoveTicks | 1; 0–100 | Hidden legacy; adaptive barriers are now used instead. |
Enable Aggressive Flow Research / EnableAggressiveFlowResearch | not verified; Boolean | Research capture, not an entry authority. |
Collect Flow Diagnostics / CollectAggressiveFlowDiagnostics | not verified; Boolean | Diagnostic collection only. |
Enable Trade Velocity Research / EnableTradeVelocityResearch | not verified; Boolean | Research capture only. |
Collect 1 Second Research Buckets / CollectTradeVelocitySeconds | not verified; Boolean | One-second velocity buckets. |
Collect Velocity Diagnostics / CollectTradeVelocityDiagnostics | not verified; Boolean | Diagnostic collection. |
Enable Pulling & Stacking Research / EnablePullingStackingResearch | not verified; Boolean | Research capture only. |
Collect 1 Second Research Buckets / CollectPullingStackingSeconds | not verified; Boolean | One-second pulling/stacking buckets. |
Collect Pulling & Stacking Diagnostics / CollectPullingStackingDiagnostics | not verified; Boolean | Diagnostic collection. |
Context and ledger
| Property | Default; allowed | Meaning |
|---|---|---|
Enable ML Trade Ledger / EnableMLTradeLedger | false; Boolean | Writes immutable decision/result records after successful submissions. |
ML Trade Ledger Path / MLTradeLedgerPath | empty; path | Empty resolves to %LOCALAPPDATA%\\XtrendAlgoV10\\ledger; explicit parents are normalized with MLLedger. Paths outside desktop root are persisted but Flow feedback rejects them. |
Enable Context / EnableContextDetector | true; Boolean | Captures Context V1.1; description explicitly states it does not alter routing/risk/BM/L2/ML decisions. |
Context Mode / ContextMode | Shadow; Off, Shadow/Research, ML Feature (source enum) | Off suppresses telemetry. Confirm Entries is explicitly unavailable in the supplied description; treat non-telemetry authority as unverified. |
Context Confirm Min Confidence / ContextConfirmMinConfidence | 0.70; 0–1 | Only relevant to any Confirm Entries path; source cautions this is a conservative gate. |
Context Confirm If Unavailable / ContextConfirmIfUnavailable | ALLOW; ALLOW/BLOCK | Source says relevant only in Confirm Entries mode. |
Enable Context Ledger Telemetry / EnableContextLedgerTelemetry | true; Boolean | Controls the auxiliary context field only; does not turn ledger on. |
| VWAP / Order Flow / L2 / Session Evidence | true each; Boolean | EnableVWAPContext, EnableOrderFlowContext, EnableL2Context, EnableSessionContext: record unavailable/null when off; source says trading behavior is unchanged. |
BookMap integration, diagnostics, and legacy ML
The remaining exposed strategy controls are source-owned integration properties in the strategy build, . Full source-visible names, defaults, and status are preserved in the coverage report. High-impact controls: UseBMLiquidityWall=true, SpoofingReversal=false, WallEngineMode=Legacy, BMExecutionEngine=Legacy, BMFastLimitMode=Marketable, BMFastRequireReference=true, and WallRequireFreshAtEntry=true. Auto-adjust defaults: disabled; Balanced; lookback 120, minimum 30, update 5 seconds, strength 60%, smoothing 25%, maximum change 50%, freeze on active signal/position true.
MLServerUrl defaults to http://127.0.0.1:8888; MLPredictPath to /predict_ensemble; MLTrainPath to /online_update. The currently supplied backend returns NO_LEGACY_MODEL_RUNTIME for legacy prediction, so customers must not assume the older EnableOnlineTraining, MLTrainPositiveOnly, EnableMLReverse, OnlineTrainingMode, or MLUseGPU properties provide an active production model path.
Signal Encyclopedia
Three evidence streams: Depth updates show displayed bid/ask liquidity; Last trades show executed transactions; price bars contextualize movement. Depth decreases alone do not establish cancellations, and a named liquidity signal does not identify a particular participant.
Complete signal encyclopedia
Signal lifecycle
detected event → indicator series/confirmation snapshot → strategy eligibility and risk/ML/Flow gates → submitted order → fill/result. Only the final two are orders. The strategy reads BookMap series including Absorption, Exhaustion, Iceberg, Whale, Liquidity Wall, Spoof, and Flash-related values; detector mechanics are summarized from an additional source audit; this customer guide does not disclose proprietary formulas.
| Signal | What the strategy can verify | Data and limitation |
|---|---|---|
| Core Long / Core Short | Core signals are timestamped and can combine with BM signals through EntryCombineMode. | Core detector conditions are in strategy logic; chart appearance requires runtime verification. |
| Absorption | Uses a confirmed BookMap snapshot and entry freshness/optional Footprint confirmation. | Bid/ask/depth and BookMap dependency required; a mark is not a trade. |
| Exhaustion | Strategy consumes ExhaustionSignal and confirmation/freshness settings. | Detector uses visible baseline, depletion, and thin-state persistence. See updated signal notes below. |
| Iceberg | Strategy consumes IcebergSignal, refresh/count/volume evidence. | Heuristic displayed liquidity behavior; not proof of hidden orders. |
| Spoof reversal | Dedicated SpoofSignal is used when SpoofingReversal is enabled; directions can be gated/reversed by configuration. | Do not call it market manipulation; it is a heuristic. |
| Liquidity Wall | LiquidityWallSignal can use fast-track placement and optional Footprint sequence. | Requires BookMap; WallEngineMode Compare Only is research, not separately approved live logic. |
| Flash Magnet | Strategy-facing Flash configuration, freshness, candle-direction and reverse options exist. | Detector observes depth growth, relative baseline, persistence and attraction toward the candidate level. |
| Whale | Strategy consumes tape/size-like Whale evidence and optional adaptive threshold. | Indicates a detected large-trade pattern, not identity or intent. |
| Footprint/context/L2 | Footprint V2 shadow, context and L2 values can filter/record according to modes. | Some are explicitly research/telemetry-only. |
| Flow AI | A synchronous prediction can gate an eligible entry only in GATE mode. | Needs local server plus VALIDATED_MODEL; fallback policy decides unavailable behavior. |
Explore the BookMap Liquidity Visual Lab
Watch seven animated BM liquidity-signal examples with a moving Depth of Market, highlighted liquidity levels, price action, Time & Sales, a Volume Profile, and step-by-step signal conditions.
Launch Interactive BM Visual Lab ↗Educational synthetic market data only. Not live NinjaTrader data, historical replay, or a guarantee of signal accuracy or trading results.
Seven BM Liquidity Signals
Absorption
Bid support / ask resistance
Exact-level aggressive prints + observed depletion followed by replenishment. A large static quote on its own is not enough.
What can invalidate it: Reject when linked prints or a genuine depletion→reload event are missing.
Exhaustion
Thin liquidity at a touched level
A previously established queue weakens by enough percentage and remains thin long enough.
What can invalidate it: Reject if the level is not sufficiently thin or recovers before the stability requirement.
Iceberg
Repeated replenishment
Multiple matching prints attack a resting level while the visible queue reloads. This suggests, but cannot prove, reserve liquidity.
What can invalidate it: Reject when prints do not link in time, refresh evidence is missing, or the level is no longer valid.
Whale
Trade-burst aggregation
A same-side cluster of Last prints accumulates volume near a burst anchor price inside a fixed time window.
What can invalidate it: Reset after an opposite-side print, excessive price drift or the time-window expiry.
Liquidity Wall
Nearby size + stability
An unusually large displayed bid or ask remains nearby long enough without unacceptable drift or disappearance.
What can invalidate it: Reject if its size, proximity, stability or presence fails.
Spoofing Reversal
Displayed pull + reaction
Observe a stable quote, then a significant reduction, price reaction and limited matched executions. It is a pattern heuristic, not proof of intent.
What can invalidate it: Reject when the pull is insufficient, executions dominate, or the reaction arrives too late.
Flash Magnet
Depth growth + price attraction
A nearby level grows rapidly, exceeds relative-depth and persistence requirements, then attracts price within the reaction interval.
What can invalidate it: Reject if the quote is missing, growth too small, or required attraction never occurs.
Open all seven signals in the Interactive BM Visual Lab →
Visual signal laboratory
Each animation below represents a different market-data sequence. The motion is tied to the meaning of the signal: absorption shows execution against a holding queue; exhaustion shows participation fading; iceberg shows repeated refills; Whale shows a clustered tape burst; Wall shows persistent depth; Spoof shows display → pull → reaction; Flash Magnet shows rapid depth growth followed by price attraction.
These are educational diagrams built to explain the logic to customers. They are not live market recordings, profitability examples, or a disclosure of proprietary detector formulas.
Absorption
Heavy execution reaches a price level, but resting liquidity repeatedly holds or reloads and price fails to travel proportionally.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Absorption | On | Master switch for the BM absorption detector. | Off removes this signal from BM entry eligibility. |
| Minimum Displayed Queue | 50 | Minimum visible resting liquidity considered meaningful at the level. | Higher values demand a larger displayed queue; lower values make the detector more sensitive. |
| Flip Side | Off | Controls whether the interpreted trade direction is inverted. | Enable only when you intentionally want the opposite directional mapping. |
| Near-Edge Fraction | 0.35 | Defines how close activity must be to the relevant edge in the legacy path. | Smaller/larger values tighten or widen the accepted edge zone. |
| Reaction Ticks | 1 | Minimum price response used by the legacy reaction check; 0 disables that check. | Higher values require a larger reaction before qualification. |
| Link / Window Sec | 5 | Time window used to connect queue and execution evidence. | Shorter windows demand tighter timing; longer windows tolerate slower sequences. |
| Minimum Hits | 1 | Minimum number of qualifying interaction events. | Higher values require repeated evidence before the signal can qualify. |
| Minimum Executed Volume | 200 | Minimum traded volume required around the level. | Higher values filter out lighter interactions. |
| Queue Hold % | 50 | How much of the displayed queue must remain/hold during the event. | Higher values demand stronger persistence of displayed liquidity. |
| Minimum Refresh Count | 2 | Minimum replenishment/refresh observations. | Higher values demand more evidence that liquidity is refilling. |
| Reload Tolerance (contracts) | 20 | Tolerance used when comparing queue reloads. | Larger tolerance accepts more variation between refreshes. |
| Signal Hold Sec | 5 | How long a qualified signal remains available. | Longer hold keeps the signal eligible for more time; shorter hold requires faster entry. |
| Require Fresh At Entry | On | Requires the signal to still be fresh when the order is considered. | Turning it off allows older qualified evidence to remain usable. |
| Entry Max Distance (ticks) | 6 | Maximum distance allowed between current price and the detected absorption level. | Smaller values require entry closer to the detected level. |
| True Entry Logs | On | Records qualified/submitted absorption events for review. | Does not strengthen the signal; it only adds audit/analysis records. |
| Recent Diagnostic Buffer | On | Keeps recent absorption diagnostics available for export. | Useful for research and support; does not alter the entry logic. |
| Diagnostic Export Window | 3 | Controls the recent diagnostic window used when exporting. | A larger value includes a broader recent diagnostic slice. |
Exhaustion
The move begins with meaningful activity, then the available liquidity/activity thins and follow-through fades.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Exhaustion | On | Master switch for exhaustion detection. | Off prevents exhaustion from creating a BM candidate. |
| Threshold | 120 | Primary size/activity threshold used by the exhaustion path. | Higher values demand stronger initial activity before depletion matters. |
| Minimum | 50 | Lower bound for the thin/depleted state. | Lower values require a more extreme reduction; higher values accept less thinning. |
| Baseline Lookback Sec | 10 | Time used to establish normal recent liquidity/activity. | Longer lookback smooths the baseline; shorter lookback reacts faster. |
| Minimum Depletion % | 35 | Minimum percentage reduction versus the baseline. | Higher percentages demand more obvious exhaustion. |
| Minimum Thin / Stable Sec | 1 | How long the thin state should remain stable. | Higher values reduce brief one-tick depletion events. |
| Reaction Ticks | 1 | Optional price reaction requirement; 0 disables it. | Higher values require more visible reaction. |
| Signal Hold Sec | 2 | Lifetime of the qualified exhaustion signal. | Short hold makes the entry more timing-sensitive. |
| Use Adaptive Thin Cap | Off | Allows the thin threshold to adapt to recent conditions. | On can make the threshold respond to changing depth/activity. |
| Require Fresh At Entry | On | Requires current exhaustion evidence at entry time. | Off can allow older evidence. |
| Entry Max Distance (ticks) | 3 | Maximum distance from the exhaustion level. | Smaller values force tighter proximity. |
| True Entry Logs | On | Stores qualified exhaustion entry records. | Logging only; no direct signal-strength effect. |
| Recent Diagnostic Buffer | On | Stores recent exhaustion diagnostics for review/export. | Research/support feature, not an entry filter. |
| Diagnostic Export Window | 3 | Amount of recent diagnostic context exported. | Higher values preserve more recent context. |
Iceberg
Repeated executions occur near the same price while displayed liquidity replenishes, creating more cumulative execution than one visible queue would suggest.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Iceberg | On | Master switch for iceberg-style replenishment detection. | Off disables iceberg as a BM entry source. |
| Minimum Trade Prints | 80 | Minimum number of qualifying prints/interactions. | Higher values require more repeated trade evidence. |
| Minimum Executed Volume | 350 | Minimum cumulative executed volume near the level. | Higher values demand more actual traded volume. |
| Price Tolerance (ticks) | 1 | Allowed price variation while linking executions to one iceberg event. | Higher tolerance groups activity across a wider price band. |
| Min Reload Excess (contracts) | 30 | Minimum excess replenishment beyond expected displayed liquidity. | Higher values demand stronger refill evidence. |
| Flip Side | On | Inverts the default directional interpretation. | Use according to the desired response mapping for this detector. |
| Max Trade Gap Sec | 2 | Maximum gap allowed between linked executions. | Smaller values require a tighter sequence of prints. |
| Min Stable Sec | 3 | Minimum stability time for the detected level. | Higher values reject short-lived levels. |
| Signal Hold Sec | 1 | How long the iceberg signal remains eligible. | Short values demand immediate reaction/entry. |
| Min Refresh Count | 5 | Minimum number of observed reloads. | Higher values demand more clear replenishment cycles. |
| Reloads To Bypass Stable Sec | 5 | Enough reloads can satisfy the event even when the full stability time is not reached. | Higher values make that bypass harder to achieve. |
| Min Executed % Of Max Display | 150 | Executed volume required relative to the largest displayed size. | Higher percentages demand more execution than the visible peak size. |
| Displayed Size Hold Slack % | 80 | Tolerance for how much displayed size can vary while still treated as the same level. | Higher slack tolerates more queue-size fluctuation. |
| Disappear Grace Sec | 2 | Grace period for a briefly missing level. | Longer grace allows short disappear/reappear sequences to remain linked. |
| Max Level Update Age Sec | 1 | Maximum acceptable age of level data. | Lower values require fresher depth updates. |
| Require Level At Entry | On | Requires the replenishing level to still exist when entry is considered. | Off allows entry after the level is no longer displayed. |
| One Entry Per Iceberg Event | On | Prevents repeated entries from the same detected event. | Off can permit multiple entries if other guards allow them. |
| Entry Max Distance (ticks) | 2 | Maximum distance from the iceberg level. | Smaller value requires tighter location. |
| Show Live Line | On | Displays the active iceberg level on the chart. | Visual only. |
| True Entry Logs | On | Records qualified iceberg entries. | Logging only. |
Whale
A cluster of unusually large prints forms inside a short time and price band, indicating a concentrated burst of tape activity.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Whale | On | Master switch for large-print / burst detection. | Off disables Whale candidates. |
| Threshold | 300 | Primary aggregate size threshold shown in the panel. | Higher values require larger bursts. |
| Use Adaptive Threshold | Off | Lets the size threshold adjust to recent activity. | On can scale sensitivity with changing volume conditions. |
| Burst Window (ms) | 300 | Time window used to aggregate prints into one burst. | Shorter values require tighter clustering. |
| Burst Price Tolerance (ticks) | 2 | Maximum price spread allowed inside the burst. | Higher values group prints across a wider price area. |
| Entry Proximity (ticks) | 5 | Maximum distance from the burst level for entry. | Smaller values require tighter proximity. |
| Signal Hold Sec | 6 | How long the Whale event remains eligible. | Longer values give more time to act on the event. |
| Reject Strong Opposing Bar | On | Blocks a Whale candidate when a strong bar is moving against the signal. | Off ignores this bar-direction safety check. |
| Opposing Body Min (ticks) | 2 | Minimum opposing candle body considered strong enough for rejection. | Higher values require a stronger opposing candle before blocking. |
| Min Seconds Between Trades | 3 | Debounce between Whale-triggered trade opportunities. | Higher values reduce repeated Whale entries. |
| Skip Debounce | Off | Allows the detector to bypass normal debounce when enabled. | On increases re-trigger responsiveness. |
| Flip Side | Off | Inverts the interpreted direction of the Whale event. | Use only when intentionally reversing the default mapping. |
| Show Live Whale Line | On | Draws the active Whale reference level. | Visual only. |
| Recent Diagnostic Buffer | On | Keeps recent Whale diagnostic context. | Research/support only. |
| Diagnostic Export Window | 3 | Controls how much recent diagnostic context is exported. | Higher values include a wider recent window. |
| True Entry Logs | On | Stores qualified Whale entry events. | Logging only. |
Liquidity Wall
A large resting depth level stands out versus nearby depth, remains stable long enough and stays close enough to current price to matter.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Wall Engine Mode | Legacy | Selects the wall detection engine/mode exposed by the panel. | Changing mode changes which wall workflow is used; use only supported modes in your build. |
| Use BM Liquidity Wall | On | Master switch for Liquidity Wall detection. | Off disables Wall candidates. |
| Threshold | 120 | Minimum displayed depth required for a wall. | Higher values require a larger resting level. |
| Proximity (ticks) | 3 | Maximum distance from current price where the wall is relevant. | Smaller values focus on walls closer to price. |
| Stable Sec Req | 3 | Minimum time the wall should remain stable. | Higher values reject short-lived large orders. |
| Max Drift Ticks | 1 | Maximum price movement of the tracked wall while still considered the same event. | Higher values tolerate more movement. |
| Disappear Grace (sec) | 1 | Grace period if the wall briefly vanishes. | Longer grace tolerates temporary disappearance. |
| Signal Hold Sec | 2 | How long a qualified wall remains eligible. | Longer hold gives more time for entry after qualification. |
| Min Relative To Avg Depth | 1.5 | Wall size required relative to normal surrounding depth. | Higher values demand a more exceptional wall. |
| Depth Stale Sec | 1 | Maximum age of depth information accepted. | Lower values require fresher order-book data. |
| Require Fresh At Entry | On | Requires the wall evidence to still be current at entry. | Off can allow an older qualified wall. |
| Direction Mode | NORMAL | Controls directional interpretation of the wall. | Alternative modes can reverse or alter direction mapping if available. |
| True Entry Logs | On | Records qualified Wall entries. | Logging only. |
| Recent Diagnostic Buffer | On | Keeps recent Wall diagnostics. | Research/support only. |
| Diagnostic Export Window | 3 | Controls the recent diagnostic window exported. | Larger values preserve more context. |
Spoofing Reversal
A large displayed order is tracked, persists, then a significant portion is pulled before much of it executes; a fast price reaction can qualify the reversal heuristic.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Spoofing Reversal | On | Master switch for the spoof-reversal heuristic. | Off disables Spoof candidates. |
| Threshold | 80 | Minimum displayed size used to begin tracking a potential spoof event. | Higher values focus on larger displayed liquidity. |
| Proximity (ticks) | 6 | Maximum distance from price where the displayed order matters. | Smaller values restrict tracking to levels closer to price. |
| Stable Sec Req | 2 | Minimum time the large displayed order should remain before a pull can qualify. | Higher values require more persistence before disappearance. |
| Max Drift Ticks | 2 | Maximum movement allowed while tracking the same displayed order. | Higher values tolerate more price-level drift. |
| Disappear Grace (sec) | 1 | Time allowed for the tracked order to disappear and still belong to the same event. | Longer values tolerate slower pull sequences. |
| Min Pull % | 60 | Minimum percentage of displayed liquidity that must be removed. | Higher values require a more substantial withdrawal. |
| Reaction Ticks | 1 | Minimum price reaction after the pull. | Higher values demand stronger follow-through. |
| Reaction Sec | 1 | Time window in which the reaction should occur. | Smaller values require a faster response. |
| Max Executed % | 50 | Maximum share allowed to execute before disappearance; helps separate pulling from genuine filling. | Lower values require that less of the order trade before it disappears. |
| Signal Hold Ms | 1000 | How long the spoof event stays eligible. | Longer values keep it available for more time. |
| Require Fresh At Entry | On | Requires the event to still be fresh at entry time. | Off allows older events. |
| Entry Max Distance (ticks) | 3 | Maximum price distance from the event level. | Smaller values require closer entries. |
| True Entry Logs | On | Stores qualified spoof-reversal entries. | Logging only. |
| Recent Diagnostic Buffer | On | Keeps recent spoof diagnostics. | Research/support only. |
| Diagnostic Export Window | 3 | Controls the recent diagnostic context exported. | Higher values include more recent context. |
Flash Magnet
Displayed depth expands sharply near price, persists long enough and is followed by a timely attraction/reaction of price toward that level.
How to read this signal
Parameters in the Xtrend panel
| Parameter | Example shown | What it means | What changing it does |
|---|---|---|---|
| Use BM Flash Magnet | On | Master switch for Flash Magnet detection. | Off disables Flash Magnet candidates. |
| Min Ticks From Price | 1 | Nearest allowed distance between the flash level and current price. | Larger values ignore flashes that appear too close. |
| Max Ticks From Price | 8 | Farthest allowed distance for the flash level. | Smaller values focus only on nearby flashes. |
| Min Size | 100 | Minimum displayed size required for the event. | Higher values demand a larger depth event. |
| Min Size Increase | 5 | Minimum rapid increase in displayed size. | Higher values require a sharper jump. |
| Relative To Avg Depth | 1 | Required size relative to recent average depth. | Higher values require the flash to stand out more from normal depth. |
| Maximum Attraction Confirmation | 3000 | Maximum confirmation window shown by the panel for price-attraction/reaction behavior. | Smaller values require a faster confirmation sequence. |
| Min Persistence Ms | 50 | Minimum time the new depth must remain present. | Higher values reject ultra-brief flashes. |
| Minimum Attraction Ticks | 2 | Minimum price movement toward the flash level used as attraction evidence. | Higher values require a larger approach. |
| Require Candle Direction | Off | Requires candle direction to agree with the configured Flash logic. | On adds directional candle confirmation. |
| Signal Hold Ms | 3000 | How long a qualified Flash event remains available. | Longer values give more time after detection. |
| Require Fresh At Entry | On | Requires fresh Flash evidence when entry is considered. | Off allows an older event. |
| Entry Max Distance (ticks) | 8 | Maximum distance from the flash level at entry. | Smaller values require price to remain closer to the event. |
| Debug | Off | Enables additional diagnostic detail. | Use for troubleshooting, not normal customer operation. |
| Recent Diagnostic Buffer | On | Keeps recent Flash diagnostics. | Research/support only. |
| Diagnostic Export Window | 3 | Controls the recent diagnostic window exported. | Higher values include more context. |
| True Entry Logs | On | Records qualified Flash entries. | Logging only. |
| Reverse Flash Magnet | On | Reverses the default directional interpretation when enabled. | Use only when the intended strategy configuration calls for reversed Flash direction. |
Shared BM controls that affect the seven signals
These settings are not one detector by themselves. They change how the seven signals are ranked, routed or adapted after a detector qualifies.
BM signal coordination
- Use BookMap Signals — master switch for BM signal participation.
- Q History Len / BM Hist Len — history windows used by BM evaluation and stability logic.
- Stable Evaluations Required — number of consistent evaluations before accepting an updated BM state.
- Min Seconds Between BM Signal — global spacing between accepted BM events.
- Show Accepted BM Markers — displays accepted BM markers on the chart.
Signal priority
- Priority Absorption
- Priority Exhaustion
- Priority Iceberg
- Priority Whale
- Priority Liquidity Wall
- Priority Spoof
Priorities resolve competing BM candidates. They do not make a weak detector stronger; they decide which qualified event wins when several are available.
BM order routing
- Order Mode — chooses the BM order style.
- Breakout Offset (ticks) — offsets breakout-style placement.
- Limit Offset (ticks) — adjusts limit placement relative to the reference level.
- Cancel if Runs Away (ticks) — cancels a working entry when price moves too far away.
- Abs Near-Edge Fraction — absorption-specific near-edge placement control in the related order path.
- Per-signal ATM templates — lets Absorption, Exhaustion, Iceberg, Whale, Wall, Spoof and Flash use their own ATM template when enabled.
BM Auto Adjust
- Enable BM Auto Adjust — turns adaptive BM tuning on/off.
- Profile — selects the adjustment profile such as Balanced.
- Lookback Samples / Minimum Samples — controls the evidence window and minimum sample count.
- Update Every (sec) — adjustment frequency.
- Adjustment Strength % / Smoothing % / Maximum Change % — controls how strongly and how quickly parameters can move.
- Freeze On Active BM Signal and Freeze With Order / Position — prevent parameter movement during sensitive live states.
- Show Diagnostics — exposes adjustment diagnostics for review.
L1 Fast Execution
- Execution Engine and Limit Placement — select the fast-entry path and passive/marketable placement style.
- Breakout Offset and Maximum Spread — control acceptable placement/spread conditions.
- Maximum L1 Age (ms) — rejects stale top-of-book data.
- Entry TTL (ms) — maximum lifetime of a working fast entry.
- Cancel Run-Away (ticks) — abandons a working entry if price escapes.
- Require BM Reference — requires a valid BM reference level for that path.
Diagnostics and exports
- True-entry logs and recent diagnostic buffers are for analysis/support.
- They do not increase signal strength and should not be described as trading filters.
- Customer documentation should show the feature name, not a developer PC path. Installation/export folders are documented separately.
Trading Modes
Trading modes
EntryCombineMode (; active logic ) controls core-versus-BookMap eligibility.
| Mode | Eligible pathway | Practical consequence |
|---|---|---|
| CoreOnly | Core candidate only | BookMap evidence is not an autonomous entry source. |
| BMOnly | BookMap candidate only | Core signals do not create the eligible pathway. |
| CoreOrBM | Either qualifying candidate | Broadest eligibility; all normal safety/risk/ML/L2 guards remain. |
| CoreAndBM | Both required | Most restrictive; requires compatible direction/timing as resolved by strategy logic. |
Risk & Orders
Risk and order management
The actual order owner is NinjaTrader strategy code. Before enabling, verify quantity, account, session and protection settings in the installed runtime. A rejected candidate is not necessarily a risk failure: it may have failed signal freshness, data, mode, ML, L2, position/order, or routing guards.
Verified execution facts: PlaceEntryUnifiedGated owns final submission; Flow AI runs before a submitted entry; terminal results write ledger records after submission/fill lifecycle; legacy versus L1Fast BookMap execution is selectable. L1Fast plans from fresh best bid/ask; Passive uses bid for buys/ask for shorts, while Marketable uses ask for buys/bid for shorts while retaining a limit cap ().
The accessible audit does not establish active implementation of break-even, trailing stop, max trades/day, prop-firm drawdown, partial-fill recovery, connection-loss recovery, or exact currency/tick semantics. Treat all as runtime verification required, not product claims.
Chart Controls
Chart and Control Center controls
The separate desktop Control Center is source-verified as a local client: it starts/queries the local API, displays health/status, and cannot command NinjaTrader. Panel configuration/performance data are local runtime files. Closing its panel requests shutdown only of the backend it owns.
Safety rule for any runtime-tested CXL/FLAT control: use simulation first, identify exact account/instrument scope, record whether confirmation appears, and verify action through NinjaTrader order/position state—not a button color alone.
XtrendBookMap
The supplied source-audit review includes XtrendBookMap and describes its market-depth and Last-trade detector event paths. Each BM signal applies its own conditions for size, proximity, executed prints, refreshes, timing, or price reaction. Indicators must be installed with compatible dependencies and a feed capable of supplying required market-depth data. Exact screenshot labels and active runtime values still need confirmation in NinjaTrader.
What is verified: the strategy reads its signal series and snapshots for Absorption, Exhaustion, Iceberg, Whale, Liquidity Wall, Spoof, and Flash-related context; depth availability is material. Missing dependency source is an installation/release blocker. Obtain the matching indicator .cs source/export, then re-run the property inventory before publishing this chapter.
XtrendFootprint
The subsequent indicator-source audit included XtrendFootprint and verified that the strategy uses Footprint-derived evidence in selected confirmation paths. This does not establish that every optional Footprint confirmation is enabled in a customer template, nor does it verify the installed chart display.
Verified strategy integration: optional BM Wall, Spoof, and Absorption confirmation can require Footprint readiness and evaluate source-defined attack/rejection or momentum conditions. When Block If Data Missing is true, missing required footprint history blocks that enabled confirmation pathway. .
XtrendVWAP
The subsequent indicator-source audit included XtrendVwap; nevertheless, the only setting directly supported by the existing configuration catalog here is EnableVWAPContext=true: off records VWAP context as unavailable/null and source says trading behavior is unchanged (). Do not infer the exact session reset, plot layout, bands or trade-routing impact from a screenshot; validate the installed indicator settings and strategy integration before making a trading claim.
Machine Learning
Machine learning and Flow AI
Two paths exist. Legacy ML properties point to /predict_ensemble, but the supplied V10 backend reports NO_LEGACY_MODEL_RUNTIME; do not configure it as a functioning production confirmation model. Flow AI is the current documented integration: NinjaTrader posts immutable candidate snapshots to /predict_flow; inference requires a validated artifact; prediction itself does not read or train on ledger files.
In GATE, invalid/no model responses follow AI If Unavailable: ALLOW preserves the entry, BLOCK rejects it. SHADOW and ADVISORY do not block through FlowAiEntryAllowed. Feedback happens asynchronously after a terminal result, only when learning is on and update mode is not Off. Ledger records must be under %LOCALAPPDATA%\\XtrendAlgoV10\\ledger for the desktop learner to accept them.
L2 Micro Mode: Off disables; Advisory calculates without blocking; ML Feature records evidence without blocking; ConfirmEntries requires fresh evidence that meets probability/evidence thresholds. Context is explicitly telemetry/research-only in its description; do not market it as an active entry confirmer without a separate runtime proof.
Practical Workflows
Educational examples
These are workflow examples, not recommendations or profitability claims.
- Simulation core-only: Select CoreOnly, leave optional gates off, verify a detected core event versus submitted order in NinjaTrader logs.
- BM-only research: Ensure depth/BookMap dependency is installed, use BMOnly, enable one signal family, and review diagnostics without assuming chart events trade.
- Core + BM confirmation: Use CoreAndBM; begin with default freshness behavior. Expect fewer eligible candidates because both sides must qualify.
- L2 confirmation experiment: Set L2 Micro Mode to ConfirmEntries; 5 depth levels, 1000 ms freshness, 0.60 threshold and 0.25 evidence are code defaults. Compare blocks in simulation.
- Flow AI confirmation: Start licensed local desktop service, confirm
VALIDATED_MODEL, enable AI Confirmation and GATE, and decide deliberately whether unavailable should ALLOW or BLOCK. Test both outcomes in simulation. - Manual monitoring: Keep automated strategy disabled; use indicator visual events strictly as research and practice interpreting stale/missing data.
Troubleshooting
Troubleshooting
| Symptom | Check | Safe resolution |
|---|---|---|
| Strategy or indicator does not compile | Missing XtrendBookMap/Footprint/VWAP types in compile output | Install matching full export; do not replace types with placeholders. |
| Desktop starts but says DISCONNECTED | NinjaTrader may be absent/not running | This is normal; launch/enable strategy separately. |
| Flow AI blocks/allows unexpectedly | AI mode, validated model state, timeout, unavailable policy | Test Gate/ALLOW/BLOCK in simulation; inspect local status. |
| No Flow model | /status.flowAi reports no validated model | Train/deploy through approved process; do not claim fallback prediction exists. |
| L2 confirmation blocks entries | Feed/depth freshness/evidence thresholds | Verify depth subscription; relax only in simulation after understanding data quality. |
| Ledger feedback rejected | Ledger path outside configured desktop root | Leave path empty or use the LocalAppData ledger root. |
| Port conflict | Another process owns 8888 | Stop/reconfigure the conflicting service through approved support workflow. |
| Signals but no orders | Mode, freshness, data, L2/ML/risk/order guards | Compare event, candidate and submitted-order timestamps/logs. |
| License failure | Network/key/machine binding | Verify credentials/connectivity and contact support; strategy/desktop activation parity needs acceptance testing. |
Customer FAQ
How does the Interactive Visual Lab relate to the real strategy?
It is an educational visualization of the documented signal concepts using synthetic events. It is not a live NinjaTrader data stream, a strategy tester, a reconstruction of source calculations, or a profitability demonstration.
Does a liquidity event guarantee an order or a fill?
No. Detector acceptance, strategy entry eligibility, order submission and actual fill are separate stages with additional gates and exchange/broker outcomes.
Does a Spoofing or Iceberg label prove market manipulation or hidden orders?
No. These are names of heuristic patterns inferred from displayed depth and executed trades; market data alone cannot prove intent or identity.
Should I copy the defaults printed in this guide?
No. Confirm the effective values in the installed chart and strategy template, especially for parameters synchronized by the strategy.
Customer FAQ
Does a chart signal mean an order was placed? No. Detection, eligibility, submission, and fill are separate stages.
Does the desktop app trade for NinjaTrader? No verified desktop-to-NinjaTrader command path exists.
Can I use Flow AI without a model? The app starts, but Gate behavior follows AI If Unavailable; a validated model is required for a valid Flow prediction.
Why are BookMap features unavailable? They require the matching custom indicator and suitable market-data/depth feed.
Does Context change trades? The exposed description says it captures telemetry and does not change entry/routing/risk/BM/L2/ML decisions.
Can I rely on the old ML endpoint? No; supplied backend reports no legacy model runtime.
What is the safest first test? A simulation account with one feature family, logging, and a clear separation between visual events and orders.
