The orderbook,
fully operational.
Everything you need to drive 3D NEXUS META V8.5 — from your first connection to autonomous execution across 18+ markets.
Every panel, every signal engine, every broker bridge and the MT5 Dual Bridge, documented and pre-chewed. Read top-to-bottom for onboarding, or jump straight to the module you're configuring.
Quick Start — Live in 60 Seconds
3D NEXUS META is a single, self-contained application. For crypto and prediction markets there is nothing to install — it streams live data the moment it loads. Futures and forex add a small local bridge (covered later). Two ways to run it:
Run online
Open nexus-meta-auth.3dnexusmeta.workers.dev, sign in with your license (or start the 3-day free trial), and the cockpit boots. Works in any modern Chromium browser — Chrome, Edge, Brave.
Run the desktop app
The desktop build is the same cockpit wrapped as a native window. It removes browser tab limits, keeps your layout pinned, and is the smoothest host when you run local broker bridges on the same machine.
🚀 Your first session
Sign in & load
Authenticate on the launch page. A purple loading ring with INITIALIZING NEXUS META… appears, then the 3D surface materialises.
Pick an exchange
In the Controls panel (top-left under Info), the Exchange dropdown defaults to Binance PERPS (USD-M). Leave it for crypto, or choose any of the other venues.
Choose a pair
Type into Trading Pair search (BTC, ETH, SOL…) and select a symbol. The surface rebuilds for that instrument instantly.
Confirm the feed is live
The status dot in Info turns green and shows Connected. Best Bid / Best Ask / Spread / Volume start ticking. You're reading live order flow.
Orient the camera
Left-drag to orbit, scroll to zoom, right-drag to pan. Lost? Press R to reset, F for fullscreen.
Anatomy of the Cockpit
The cockpit is a 3D scene surrounded by floating glass panels. Every panel is independent — drag it, resize it, fade it, or minimise it. Your layout is saved automatically and restored on the next session.
🪟 The panel roster
Every panel can be summoned, moved and saved. Here is what each one does — deep dives follow in their own sections.
| Panel | What it shows | Section |
|---|---|---|
| Info | Connection status, Best Bid/Ask, Spread, Volume, Trade count, Delta, current symbol, layout RESET | 02 |
| Controls | Exchange, MT5 bridge URL, Trading Pair, Price Levels, Time Depth, Height Scale, Update Rate, Tick Size, Visualization mode, Camera presets | 04 |
| Power Gauge | Vertical cumulative Delta meter with ±threshold bands | 06 |
| Nexus Swarm | 5 AI agents + Consensus Overlord; Cerebras / Groq keys | 10 |
| Nexus AI Oracle | Live pattern-detection feed + voice commentary toggle | 06 |
| API Credentials | Binance / Bitget keys (for live trading) | 13 |
| Execute | Manual order ticket: type, leverage, size, price, BUY/SELL | 14 |
| Time & Sales | Live trade tape, 6 columns + Tape Bomb alerts | 06 |
| Scalp Signals | Directional signal feed with confidence + TP/SL | 07 |
| Quant Metrics | VPIN · Kyle's Lambda · Hawkes regime | 09 |
| Prediction Oracle | Multi-horizon probabilistic forecast + L2 predictors | 08 |
| Futures Intent | V8.5 pipeline health, instrument profiles, book intent, regime | 12 |
| Settings Hub ⚙ | Central control for surface, features, effects, layout presets | 19 |
✋ Moving & managing panels
⠿ Drag
Grab the dotted DRAG handle at the top of any panel and move it anywhere. Positions persist between sessions.
↘ Resize
Pull the handle in the bottom-right corner to resize. Useful for stretching Time & Sales or shrinking the Swarm.
◑ Opacity
The opacity slider on each panel fades it from 10–100%, so it never hides the surface behind it.
↺ Reset
The RESET button in Info (or Reset Positions in Settings) snaps every panel back to its default home.
🎚 Layout presets & UI zoom
The Settings Hub → Layout → Preset row offers one-tap arrangements that reposition the whole panel set for a given workflow. Independently, the + / − zoom widget (bottom-right of the screen, or Ctrl + / Ctrl − / Ctrl 0) scales the entire UI between 50% and 150% — handy on 4K monitors or when screen-sharing.
Controls & Keyboard Shortcuts
The 3D scene is navigated with the mouse; everything else has a hotkey. Memorise the navigation row first — the rest become muscle memory.
🖱 Mouse navigation
| Input | Action |
|---|---|
| Left-drag | Orbit the camera around the surface |
| Scroll | Zoom in / out |
| Right-drag | Pan the camera |
| Hover a level | Crosshair HUD shows price, size, side & depth at the cursor |
⌨ Keyboard shortcuts
| Key | Action |
|---|---|
| R | Reset camera to default orbit |
| F | Toggle fullscreen |
| C | Toggle the camera-preset selector |
| O | Toggle the Prediction Oracle panel |
| Shift O | Collapse Oracle to compact view |
| Q | Toggle the Quant Engine |
| P | Toggle Footprint Crown + Delta Pillars |
| Ctrl + / − / 0 | UI zoom in / out / reset to 100% |
| Esc | Close the active overlay / modal |
🎮 FPS fly-through
The FPS camera preset (see Visual Modes) puts you inside the orderbook. Once active, fly with W A S D, ascend/descend with Q E, and steer with the mouse. Switch to any other preset to exit.
Data Sources & Connectivity
One cockpit, 18+ live data sources — crypto (CEX & DEX), futures, forex, RWA stocks and prediction markets. Crypto venues stream straight into the browser; futures and forex route through a local bridge. Everything is selected from the Controls → Exchange dropdown.
🔌 The Exchange dropdown
These venues are available directly in the in-app selector. Switching exchange reconnects the feed and repopulates the symbol list automatically.
| Venue | Type | Notes |
|---|---|---|
| Binance SPOT | Crypto CEX · spot | Browser-native, no keys needed to view |
| Binance PERPS (USD-M) | Crypto CEX · perps | DEFAULT |
| Bybit PERPS (Linear) | Crypto CEX · perps | Linear USDT contracts |
| OKX SWAP (USDT-M) | Crypto CEX · swap | USDT-margined swaps |
| Coinbase Advanced | Crypto CEX · spot | USD pairs |
| KuCoin SPOT | Crypto CEX · spot | |
| Bitfinex SPOT | Crypto CEX · spot | |
| MEXC SPOT | Crypto CEX · spot | Wide altcoin coverage |
| Hyperliquid PERPS (DEX) | On-chain · perps | True on-chain perp depth |
| Gate.io TradFi | RWA · stocks/FX/indices | Tokenised TradFi instruments |
| MT5 Local | Futures / CFD | Via Python bridge → §16 |
| CQG Futures | Futures | WebAPI bridge → §17 |
🔎 Choosing your instrument
BTC, NQ, EUR) to filter the symbol list, then pick one. A ⟳ loading… badge shows while symbols fetch.⚙ Feed tuning
Update Rate
10 ms – 2000 ms. Lower is more real-time but heavier on the GPU; raise it on slower machines to keep frame-rate smooth.
Height Scale
0.1× – 15×. Exaggerates the vertical relief of the liquidity surface so walls and voids pop visually.
Visual Modes, Cameras & Skins
The same order flow, rendered seven different ways. Switch any mode live from Controls → Visualization — no reload. Then frame it with eight camera presets and wrap it in one of four aesthetic skins.
🌌 The 7 visualization modes
SURFACE
The flagship 3D liquidity skin. Every bid & ask is a living surface; footprint cubes float above with executed volume; delta pillars below show net pressure.
TUNNEL
Fly through a tunnel where bid & ask walls rise like skyscrapers. Cinematic perspective on liquidity as you sail down the tape.
FOOTPRINT
A classic footprint chart elevated to 3D: bid×ask volume per price level, colour-coded delta, exhaustion arrows pointing to absorption zones.
X-RAY
See through the book. ADDS / CXL counters, Fresh vs Aged liquidity, a Max-Liq tracker — designed to expose institutional layering.
CANYON
Cumulative bid & ask depth form canyon walls facing each other across the price valley; the front slice shows larger raw BID/ASK size labels.
2D MAP
Reuses the Bookmap heatmap, forces it visible, hides 3D clutter and frames the plane like a native Bookmap view — WALL2, price scale and trade dots.
BUBBLE MAP
Liquidity rendered as a constellation of bubbles — a spatial, at-a-glance read of where size is clustered across the book.
🎥 The 8 camera presets
Open the camera selector (bottom-right of the screen, or C). Each preset smoothly animates to a fixed viewpoint:
| Preset | Vantage point |
|---|---|
| 🌍 ORBIT | Default orbital camera — free orbit around the surface |
| 🗺 TOP DOWN | Bird's-eye view from directly above |
| ▣ FRONT | Head-on view of the live wall |
| ◨ SIDE | Side profile of the depth surface |
| 🔭 DEEP | Inside the depth tunnel, looking down the tape |
| 🎯 SNIPER | Ultra-zoom on the live wall (narrow FOV) |
| 🎬 CINE | Cinematic wide-angle for recording |
| 🎮 FPS | First-person — fly with WASD + mouse |
🎨 The 4 aesthetic skins
NEXUS CYBER
The original gamified neon look — purple/cyan/green, scanlines, vignette, glitch. The battle cockpit. Default.
TERMINAL PRO
Bloomberg-style professional dark terminal — gold/green/mono, precision typography. The serious institutional setup.
AURORA DEEP
Bioluminescent deep-ocean aesthetic — teal/blue with a custom cursor trail. Elegant and quiet.
PRO MODE
A soft-blue, boardroom-ready academic skin: no scanlines, no vignette. Toggleable — ideal for screen-shares and polished recordings.
Reading the Surface
Before automation, learn to read what's in front of you. The surface and its support panels expose every dimension of microstructure: resting liquidity, executed flow, net pressure and the speed of the tape.
📊 Surface elements
Footprint Crown
Live bid×ask volume bars stand at the surface front, with delta pillars showing net executed pressure per level. Toggle with P or in Settings.
Bookmap Heatmap
A canvas heat-texture painted across the wall using an LUT colour ramp — the resting-liquidity history. Pair with the Trade Velocity Band at the front to read speed-of-tape live.
Volume Profile 3D + VPOC
Session volume-at-price rendered as horizontal bars on the right; a gold laser line marks the VPOC (point of control), with a buy/sell imbalance bar.
Persistent Trade Bubbles
Every execution spawns a bubble that rides the surface as time scrolls, leaving a permanent trail of exactly where trades landed against the book.
Whale Wall Detector
Massive limit orders trigger holographic overlays, screen flashes and audio cues — you feel the wall before price reaches it.
Liquid Metal Surface
An optional physical shading mode that gives the liquidity surface a reflective, fluid finish. Toggle in Settings.
📋 Time & Sales tape
The full live trade tape, with six columns of microstructure data per print:
| Column | Meaning |
|---|---|
| Time | Millisecond-precise execution timestamp |
| Price | Execution price |
| Size | Trade size |
| Side | BUY (market buy) · SELL (market sell) · BOMB (tape bomb) |
| Impact | Dollar value of the trade — see instantly what's moving the market |
| Vol Profile | Inline bar showing each trade relative to the rolling average |
Rows are colour-coded by side; gold rows are Tape Bombs — institutional sweeps flagged when execution rate exceeds ~80% of the adaptive maximum with at least 8 trades/sec. Hit ⏸ PAUSE to freeze the tape for review without losing data.
⚡ Power Gauge & Crosshair
Power Gauge (Delta)
A vertical meter of cumulative delta (net buy − sell pressure). The green/red fill rises from the midline; the ±20% / ±80% threshold bands mark when pressure becomes significant.
Crosshair HUD
Hover anywhere on the surface to read the exact price, size, side and depth at the cursor — precision inspection without leaving the 3D view.
🗣 Nexus AI Oracle feed
The Oracle panel streams plain-language pattern callouts — icebergs, spoofs, absorptions, whale walls — as they're detected. Toggle 🔊 VOICE to have them spoken aloud via the browser's speech engine, so you can watch the surface while the cockpit narrates the market to you.
Scalp Signal Engine
The Scalp Signal Engine watches the order flow for six microstructure patterns and fires directional signals — drawn as 3D arrows on the surface, listed in the Scalp Signals panel, and (optionally) routed to execution. Each signal is confidence-scored and carries a TP/SL.
🎯 The 6 signal patterns
Absorption
Large passive orders soaking up aggressive market flow — the silent tell before a reversal. Confirmed across multiple book ticks.
Iceberg
Hidden orders reloading behind the spread, detected by cycle analysis across consecutive snapshots.
Exhaustion
Aggression drying up at a level — the move is running out of fuel.
Delta Spike
A sharp surge in cumulative delta — a burst of one-sided aggression.
Smart Money
Whale accumulation/distribution: persistent bid walls holding while price rises, hidden absorption at key levels, stacking patterns retail can't see.
Oracle Prediction
Fires when 4+ Prediction Oracle horizons align with confluent L2 predictors. Confidence is pre-modulated by the regime engine.
🧭 Reading a signal
Each entry in the Scalp Signals panel carries: the pattern, a direction (BUY/SELL), a confidence %, and suggested TP / SL levels with a validity window. The same signal is mirrored on the surface as a 3D arrow at the relevant price, with a sound alert. The panel keeps running counts and statistics so you can judge each pattern's recent reliability.
You can export the signal journal from the panel for offline review, and configure which patterns are active and how sensitive they are in the signal settings.
Prediction Oracle V2
The flagship forecasting module. The Oracle runs seven L2 predictive models on the live book and projects the probability of price movement across six simultaneous horizons — from 5 seconds to 2 minutes. Toggle it with O; collapse to compact with Shift O.
🔬 The 7 L2 predictors
| Predictor | What it measures |
|---|---|
| OFI (Order Flow Imbalance) | Cont (2014) model — net pressure from book additions/cancellations, weighted per horizon |
| Microprice + Displacement | True fair value (volume-weighted), not the naive midprice |
| OBI-5 | Order-book imbalance at 5 levels of depth |
| OBI-20 | Order-book imbalance at 20 levels of depth |
| Cancel Imbalance | Detects pulled liquidity before it moves price |
| Hawkes Lambda | Self-exciting trade-clustering intensity |
| Depth Slope & Spread Acceleration | Regime-momentum predictors |
🌡 Regime detection
An automatic regime label — NORMAL / ELEVATED / TOXIC — scales the Oracle's confidence per horizon. The regime is driven by the Quant Engine, so the Oracle automatically becomes more cautious as informed-flow risk rises.
Quant Engine — VPIN · λ · Hawkes
Three institutional microstructure metrics run live in the browser. They don't just display — they actively modulate your signal confidence and auto-trader cooldowns, and feed the Prediction Oracle's regime detector. Toggle with Q.
QUANT object stays in place as a mirror — zero API change.🧮 The three metrics
VPIN
Volume-Synchronized Probability of Informed Trading. >65% dampens signals; >80% = TOXIC, where only momentum signals fire.
Kyle's λ
How strongly signed order flow predicts price moves (R²). High R² = informed traders dominating → confidence is reduced by up to 40%.
Hawkes BR
Branching ratio — the fraction of trades caused by other trades. <0.45 CALM → 0.85+ CASCADE.
⚙ How it modulates your trading
- VPIN kill switch: in a TOXIC regime, all signals except
delta_spikeare suppressed. - Kyle Lambda penalty: high R² cuts signal confidence by up to 40%.
- Hawkes CASCADE: shortens cooldowns in momentum markets so you don't miss the run.
- CALM market: applies a ~15% confidence boost — signals are more reliable in quiet flow.
- Spread alert: when VPIN crosses the danger threshold, you're prompted to widen entries.
- Feeds the Oracle: the composite regime label scales Prediction Oracle horizon weights.
Each metric has a live sparkline so you can watch regime shifts happen. The composite regime output (e.g. ELEVATED · +1.0×) is what flows downstream into the Oracle and Auto-Trader.
Nexus Swarm — 5 AI Agents
An autonomous AI swarm reads the order flow alongside you. Each agent is a specialist; the Consensus Overlord synthesises them into one live probability verdict. It runs on Cerebras (primary) with automatic Groq fallback.
🤖 The agents
Delta Hunter
Tracks cumulative delta and flags divergences with price. Output: BULL / BEAR / NEUTRAL + confidence.
Iceberg Assassin
Identifies hidden liquidity refilling behind the spread. Output: DETECTED / SUSPECTED / CLEAR + price level.
Spoof Warden
Detects manipulation from order-to-cancel ratios. Output: SPOOFING / SUSPICIOUS / CLEAN + side.
Absorption Sage
Monitors passive absorption ahead of directional moves. Output: ACCUMULATION / DISTRIBUTION / EXHAUSTION.
The Overlord aggregates all four agents plus the Prediction Oracle V2 output plus the Quant Engine regime into a single live probability verdict, an urgency level, and a short cinematic summary. It is the final word — e.g. 82% BULL — BID LIQUIDITY SURGES.
🔑 Activating the swarm
Get a Cerebras key
Create an API key at Cerebras (format csk-…). This is the primary inference provider — sub-second responses.
(Optional) Get a Groq key
Add a Groq key (gsk_…) as fallback. If Cerebras hits its rate cap, the swarm auto-fails-over so you never lose AI coverage.
Paste & activate
Enter the keys in the Nexus Swarm panel and press ACTIVATE. The five agent cards come online and begin posting verdicts; the provider row shows which engine is live.
Signal Intelligence Engine (SIE)
The SIE closes the loop on the signals pipeline. It is a quality gate that learns which signals actually work and filters out the ones that don't — before they reach your screen, the surface, the voice, or execution.
🧠 How it learns
- Triple-barrier outcome tracking: every fired signal is followed to one of three outcomes (target hit / stop hit / timeout), labelling whether it was actually good.
- Per-symbol online logistic regression: a lightweight model updates continuously from those outcomes — it adapts to the instrument you're trading right now, not a static rulebook.
- Quality gate: incoming signals are scored by the model; low-quality ones are filtered before they propagate to the UI, map, voice, or auto-execution.
🔬 The Signal Lab
The SIE injects a Signal Lab into the Scalp Signals panel, where you can watch the engine's live quality scoring and learning state. The result: over a session, the signals that survive to your screen are the ones the model has learned are worth acting on for that symbol.
Futures Intent Engine V8.5
The headline module of V8.5. Crypto and futures behave very differently — futures books are deeper, slower and more deliberate. The Futures Intent Engine retunes the entire cockpit per instrument, surfaces a live pipeline-health readout, and adds intent-aware tools so signals behave correctly on NQ, ES, GC or DAX, not just BTC.
🎛 Instrument profiles
Pick a profile from the Futures Intent panel and the engine reconfigures depth targets, signal confidence floors, Oracle hold times, cooldowns and flip limits to match that market's microstructure:
| Profile | Tuned for | Behaviour |
|---|---|---|
| AUTO | Adaptive default | Balanced settings; lets the engine decide |
| BTC / CRYPTO | Fast crypto perps | Shorter holds, quicker flips, lower confidence floor |
| NQ FUTURES | Nasdaq 100 | Deep book target, high confidence floor, slow flips, displacement confirmation |
| ES FUTURES | E-mini S&P 500 | Long Oracle holds, signals paused during compression |
| GC GOLD | Gold futures | Deliberate cadence, displacement-confirmed entries |
| FDAX / DAX | German index | Wide-range tuning for fast index futures |
🛠 Intent tools
Pipeline Health
A live readout of the data → signal → execution chain. Spot a stalled feed, a starved predictor or a broken hop at a glance. An optional Auto-Repair attempts to recover the pipeline on its own.
Book Intent Mode
Sets how the engine interprets resting liquidity — e.g. BALANCED — biasing the read toward passive intent vs. aggressive displacement.
Aggressor Normalizer
Normalises buy/sell aggressor classification (AUTO by default) so delta and pressure read correctly across feeds with different conventions.
Oracle Anti-Flicker
Caps how fast the Oracle prediction can flip, killing the rapid BUY↔SELL strobing that deep, slow books would otherwise cause.
Pressure Clock
A timing readout for building/releasing book pressure — when is intent accumulating vs. spent.
Cancelled-Liquidity Ghosts
Pulled orders leave fading "ghost" marks on the surface, so you can see liquidity that was there — spoofs and vanished walls become visible after the fact.
Signal Guard
Blocks signals during low-quality conditions (e.g. compression) for the profiles that require displacement confirmation.
Compact Prices & Round Levels
Compact price formatting plus emphasis on psychologically important round levels — built for the large tick values of index and metal futures.
API Credentials
The cockpit reads public market data with no keys at all — open it and a live book streams instantly. Keys are only needed when you want to place real orders on a crypto exchange directly from NEXUS. The API Credentials panel holds those keys, and they live in your browser session only.
🔑 The two crypto venues
Open the API Credentials panel, select the Binance tab, and paste:
When you create the key on Binance, the only permissions NEXUS needs are:
- Enable Reading — account & positions.
- Enable Spot & Margin Trading — for spot order tickets.
- Enable Futures — for perpetual (USD-M) trading and the auto-trader.
Select the Bitget tab. Bitget keys come as a trio:
Grant read + trade permissions; leave withdrawals disabled. Bitget exposes both perpetuals and RWA markets that NEXUS can route to.
🛡 How your keys are stored
Never persisted
Keys are held in sessionStorage — they vanish when you close the tab. They are never written to a server, a database or a cookie.
Your machine signs
Requests are signed in your browser. Anthropic / MetaQuantUniverse never see or store your secret.
Rotate & scope
Use a dedicated trading-only key, rotate it periodically, and start on testnet before going live.
Manual Trading
The Execute panel is a full order ticket welded onto the orderbook. You see the wall, you click, you fill — no alt-tabbing to a separate terminal. It routes to whichever venue is active: a crypto exchange via your keys, or a futures broker via a bridge.
🧭 The three order types
Fill now
Crosses the spread and fills immediately at the best available price. No price field. Use when speed beats price.
Name your price
Rests in the book until price reaches your level. You become the liquidity — set the Price field. Use to enter passively at a wall you can see on the surface.
Trigger entry/exit
Activates once price trades through your trigger. Pair with Reduce Only for a manual protective stop.
🏷 Venue awareness
The panel shows a badge for the active venue so you always know where an order will land. A Binance Perps order, a Bitget order and an order routed to your MT5 bridge all flow through the same ticket — only the destination changes. Configure crypto venues in API Credentials; configure futures venues in the bridge sections.
Auto-Trading Engine V7
The auto-trader closes the loop: a qualified signal becomes a live order, complete with a real two-step take-profit and stop-loss, position management and hard risk limits. It is the most powerful — and most dangerous — part of NEXUS. Read this whole section before you arm it.
🔁 The execution loop
A signal must clear the SIE quality gate and your confidence floor before it ever reaches the engine. Then:
⚙ Core parameters
| Setting | What it does |
|---|---|
| Signal types | Choose which of the 7 signal types may trade (absorption, iceberg, exhaustion, delta spike, smart money, oracle, tape bomb) |
| Min confidence | Confidence floor a signal must exceed to fire an order |
| TP / SL ticks | Take-profit and stop-loss distance, in ticks from the real fill price |
| Trade size | Quantity per auto order |
| Max positions | Cap on concurrent open positions |
| Cooldown | Forced wait between auto orders to stop over-trading |
🧨 Risk & behaviour modes
Daily P&L Limits
Set a max daily profit and/or loss. When hit, the engine auto-flattens all positions and disables itself for the rest of the day. Your single most important safety setting.
Smart Martingale
Optionally steps size up after a loss to recover. Powerful and high-variance — it can blow an account fast. Leave OFF unless you fully understand the math and have a hard Daily Loss limit set.
Reverse Mode
Inverts signal direction — every BUY becomes a SELL and vice-versa. Useful for fading a strategy in chop, or testing signal polarity.
Toxicity suppression
When the Quant Engine flags VPIN > 65%, the engine suppresses non-momentum entries — it won't fade a toxic, one-sided flow.
🔌 Where it runs
The auto-trader executes on Binance Perps and Bitget via your API keys, and on futures via the bridges: MT5 (single & dual), Rithmic and Tradovate. The two-step TP/SL works identically across all of them.
MT5 Dual Bridge V9
This is how NEXUS trades futures and CFDs. The MT5 Bridge is a small Python program that runs on your Windows machine, connects to one or two MetaTrader 5 terminals, and streams the Level-2 order book to the cockpit over a local WebSocket — then routes your orders back to MT5. It's the single most important integration for futures traders, so this section spoon-feeds every step.
🗺 How the data flows
🔀 Single vs. Dual mode
The bridge runs in one of two modes. Pick based on whether your broker's MT5 gives you real depth-of-market.
Single mode
One MT5 terminal does both data and execution. Perfect when your broker provides L2 DOM and you trade on that same account. One terminal, one login.
Dual mode
Two terminals: Station A (DATA) streams deep L2 from a broker with real DOM (e.g. AvaFutures), while Station B (EXEC) places orders on the account you actually trade (e.g. IC Markets). Best book + your broker of choice.
📦 Step 1 — Install
You need Python on Windows and the two libraries the bridge depends on. Open a terminal in the bridge folder and run:
# MetaTrader5 is Windows-only — run this on the same PC as MT5 pip install MetaTrader5 websockets # or, if a requirements.txt ships with the bridge: pip install -r requirements.txt
MetaTrader5 Python package only runs on Windows, because it talks to the MT5 desktop terminal. Run the bridge on the same machine as MT5. Keep that terminal logged in and running.▶ Step 2 — Launch the bridge
Double-click the script or run it from the terminal. By default it opens a small control window (Tkinter GUI) titled “3D NEXUS META — MT5 Bridge V9”:
# launch with the GUI (default) python mt5_nexus_bridge_dual.py # headless / no window python mt5_nexus_bridge_dual.py --no-gui # force single-terminal mode on a specific symbol python mt5_nexus_bridge_dual.py --single --symbol ES # custom port + verbose logging python mt5_nexus_bridge_dual.py --port 5555 --debug
The bridge auto-scans your machine for MT5 installations (it looks for terminal64.exe), so in most cases it finds your terminal with no path configuration. It also auto-detects each symbol's tick size and point value.
| CLI flag | Effect |
|---|---|
--no-gui | Run headless, no control window |
--single | Force single-terminal mode (one MT5 for data + exec) |
--symbol <SYM> | Subscribe to a symbol on launch |
--port <N> | WebSocket port (default 5555) |
--signals-file <path> | Path for the signals CSV (MQL5 overlay integration) |
--debug | Verbose logging |
🔗 Step 3 — Connect NEXUS
ws://localhost:5555 (match the port if you changed it).ES, NQ, GC) and the 3D book comes alive.0.0.0.0, so the online cockpit on the same LAN — or the desktop build on the same PC — can both reach it. Keep the URL pointing at the machine running the bridge.🧬 Symbol mapping
Brokers name the same contract differently — your data terminal might call it EPM26 while your exec terminal wants ES. The bridge resolves this with a 3-level fallback, trying progressively more generic names until one matches:
# front-month code → root → generic → index alias
EPM26 → EP → ES → SP500
es is not ES. If a symbol won't resolve, add an explicit mapping (the bridge accepts an add_mapping command and exposes the current table) and double-check exact casing in MetaTrader's Market Watch.📋 Supported instruments
The bridge ships with built-in tick-size / point-value handling for the major futures and a few FX/metal CFDs:
ES · MES · NQ · MNQ · YM · MYM · RTY · M2K
E-mini and Micro index futures.
CL · GC
Crude oil and gold futures.
EURUSD · 6E · XAUUSD · BTCUSD
Euro FX & future, spot gold, and crypto CFD where offered.
🛑 Safety systems
The bridge is the layer closest to your money, so it carries several independent safety mechanisms:
Four ways to stop everything
Trigger an instant kill via Ctrl+Shift+K in the GUI, an OS signal (SIGUSR1), an HTTP call to the kill endpoint on port + 1 (e.g. :5556/kill), or a WebSocket kill command. Any one halts order flow.
Max orders / minute
A hard cap (default 10) on orders per minute. A runaway strategy or fat-fingered loop can't machine-gun your broker.
Stale-data recovery
Detects a frozen feed and automatically re-subscribes and reconnects with backoff, so a dropped tick stream heals itself instead of silently going stale.
Sequenced keepalive
Heartbeats carry sequence numbers so both sides can detect a gap or a stalled link immediately.
🏗 Under the hood
MT5 Worker Thread
All MetaTrader calls run on a dedicated worker thread so they never block the async event loop — the book keeps streaming even while orders are processed.
Signal Pipeline V2
Signals are written to nexus_signals_live.csv atomically (temp file + os.replace), capped and rotated, ready to be read by the bundled NexusSignalsOverlay_v2.mq5 indicator that draws them on your MT5 chart.
⚙ Dual-mode config
Dual mode reads a small JSON file (nexus_dual_config.json) describing each terminal. Fill in the path, login and server for your DATA station and your EXEC station:
{
"data_path": "C:\\Program Files\\AvaTrade MT5\\terminal64.exe",
"data_login": 12345678,
"data_server": "AvaTrade-Real",
"exec_path": "C:\\Program Files\\ICMarkets MT5\\terminal64.exe",
"exec_login": 87654321,
"exec_server": "ICMarkets-Live"
}
🩺 Troubleshooting
Check that (1) the bridge window is open and shows your terminal connected, (2) the Exchange dropdown is set to MT5 Local, (3) the URL is ws://localhost:5555 with the right port, and (4) Windows Firewall isn't blocking Python. Run with --debug to see the handshake.
The contract name doesn't match MT5. Open Market Watch, right-click → Show All, and copy the exact symbol (case-sensitive). If your broker uses a front-month code, rely on the fallback (EPM26→EP→ES) or add an explicit mapping. Confirm the symbol is actually visible in Market Watch first.
Your broker may not provide true L2 DOM on that account. This is exactly what Dual mode solves — stream depth from a DATA terminal that has real DOM while executing elsewhere.
Confirm the EXEC terminal allows algo trading (the “Algo Trading” button must be green), the account isn't read-only/investor-password, you haven't tripped the kill switch, and you're under the max-orders-per-minute rate limit. Check the bridge log for the broker's rejection reason.
That's Watchdog V2 doing its job — it detected stale data and auto-resubscribed. Frequent freezes usually mean an unstable broker connection or the MT5 terminal being starved of CPU; give it a dedicated machine for serious use.
Other Bridges
MT5 is the most-used path, but NEXUS speaks to a whole stable of professional futures and DeFi venues. Each is a small local bridge or a direct connection that hands the cockpit an L2 book and takes orders back. Pick the tab for your platform.
Sierra Chart — DTC bridge
Connects over the DTC protocol. Enable the DTC server inside Sierra Chart (default server port 11099) and run the NEXUS Sierra bridge, which exposes the book to the cockpit at ws://localhost:5559. You get full L2 DOM and trading on Sierra's data.
ws://localhost:555911099Rithmic — R|API+ bridge
A native connection to Rithmic, the low-latency futures infrastructure used across CME, CBOT and NYMEX. Delivers professional-grade depth and order execution — and the auto-trader runs on it directly.
CQG — WebAPI bridge
Selectable straight from the in-app Exchange dropdown as CQG Futures (WebAPI). The CQG path is hard-isolated (V1.6) so its connection lifecycle can't interfere with crypto feeds or other bridges running alongside it.
Dukascopy — JForex4 bridge
Bridges the JForex4 platform for Dukascopy's FX and CFD liquidity, handing the cockpit a live book from the Swiss bank's feed.
FXCM — Socket / REST
Connects to FXCM over its socket + REST API for FX market data and trading inside the 3D book.
Hyperliquid — execution bridge
Hyperliquid perps are available directly in the Exchange dropdown for live data, and an execution bridge lets you trade this on-chain perp DEX from the cockpit — fully decentralised, no custodial keys on a centralised venue.
Polymarket — CLOB
Connects to the Polymarket CLOB (Central Limit Order Book) so prediction-market liquidity can be visualised and traded with the same 3D engine. A different asset class entirely — event probabilities instead of price — rendered the NEXUS way.
Aggregate Multi-Exchange V2
Liquidity for a crypto pair is scattered across many venues. Aggregate mode fuses several books into one consolidated orderbook, so you see the true market depth — not just one exchange's slice of it.
🧩 What it merges
Up to five venues are combined into a single surface:
🛡 Integrity safeguards
Naively summing books is dangerous — a stale or mis-priced feed would poison the merge. V2 defends the consolidated book with:
Staleness guard
A venue whose data hasn't updated within ~5 s is dropped from the merge so dead feeds can't ghost-fill the book.
Divergence alerts
If one venue's price drifts more than ~0.3% from consensus, you're warned — a flag for arbitrage, a feed glitch, or a depeg.
Trade de-duplication
Trades within ~100 ms and ~5% size are treated as the same print, so the tape and delta aren't double-counted.
Basis correction
Per-venue basis is corrected before merging so spot and perp prices line up into one coherent book, with per-venue metrics and a generation counter for audit.
Settings Hub ⚙
Almost everything visual lives behind the ⚙ gear. The Settings Hub is the central control room — tune the surface, toggle features and effects, and manage your layout. It's grouped into four tabs.
The core look and responsiveness of the 3D book:
Controls for the trade and liquidity bubbles floating on the surface:
Master switches for the big visual and intelligence layers. Turn things off to lighten the scene or focus your read:
Footprint Crown
The per-level delta crown on the surface.
Bookmap Heatmap
Resting-liquidity heat trail behind the book.
Liquid Metal Surface
The reflective metallic shader on the book.
Quant Engine
Enable VPIN / Kyle / Hawkes (see 09).
Prediction Oracle
Enable the multi-horizon forecast (see 08).
Oracle Voice
Spoken commentary — modes for ALL / CONSENSUS / OFF.
Stock Heatmap
Heatmap styling tuned for equity-style books.
Scanlines · Vignette · Sound
Cyberpunk CRT scanlines, edge vignette, and UI sound — atmosphere toggles.
Manage your workspace:
Troubleshooting & FAQ
The quick answers to the things people hit most often. For bridge-specific issues, see the troubleshooting block in 16.
⚡ Getting started & access
No — for crypto and prediction markets just open the cockpit in your browser and a live book streams immediately. You only install the small Python bridge if you want to trade futures via MT5 (or use one of the other futures bridges). A desktop build is also available if you prefer a standalone app.
A modern Chromium browser — Chrome, Edge or Brave. NEXUS leans on WebGL and the Web Speech / Web Audio APIs, which are most reliable there. Keep your GPU drivers current for the smoothest 3D.
No. Keys are only for placing real crypto orders from the Execute panel. Everything else — visualization, Oracle, Quant, Swarm, signals — runs on public data with no keys.
🖥 Performance & display
Raise the Update Rate (e.g. to 100–250 ms), reduce Price Levels and Time Depth, and switch off heavy effects — Liquid Metal Surface, Bookmap Heatmap, Scanlines and Vignette. The 2D MAP mode is the lightest if you just need the read.
Open the Settings Hub → Layout and hit Reset Positions. To recover the whole view, press R for a full reset, or Ctrl+0 to reset UI zoom.
Browsers block audio until you interact with the page — click once inside the cockpit. Then check Sound and Oracle Voice in Settings → Features, and your OS/tab volume. Voice needs the Web Speech API (use Chrome/Edge).
🤖 Intelligence & trading
The Swarm needs a Cerebras key (with Groq as fallback) pasted into the Nexus Swarm panel. Keys are session-only. If agents go quiet under load, you may be hitting the provider's rate cap — it resets shortly. See 10.
Deep, slow futures books cause strobing. Set the right Futures Intent profile and enable Oracle Anti-Flicker — it caps how fast the prediction can flip. On crypto, that's expected liveliness.
Likely a gate doing its job: the Quant Engine may be in a TOXIC regime (VPIN > 80%) damping signals, the SIE may be filtering low-quality candidates, Signal Guard may be blocking during compression, or you're inside a cooldown. Check the Quant Metrics and Pipeline Health readouts.
Treat it as live and supervised. Always set Daily P&L Limits (which auto-flatten and disable the engine when hit), rehearse on testnet / demo, keep Smart Martingale OFF until you understand it, and know your four kill-switch methods. See 15.
📚 Going deeper
Companion guides on the MetaQuantUniverse site:
Full User Guide ↗
The complete online reference manual.
Profitability Guide ↗
How to actually trade with the cockpit.
Dual MT5 Bridge Guide ↗
Step-by-step two-terminal setup.
Prediction Oracle Guide ↗
Every predictor and horizon explained.