HOW TO USE MIRACLEBOT-1G

1. What MiracleBot-1G is (and isn't)

The engine scans the market on a schedule, identifies setups, applies 30+ risk gates, runs them through a multi-hypothesis context layer, and — only if you turn it on — places orders via YOUR broker connection. In Live Coaching Mode it narrates what it detects without placing anything.

Default mode: PAPER. Run paper trading as long as you like. Switch to live only when you decide to.

2. Subscription tiers

All tiers include the core scanning engine, 30+ risk gates, the Transparency tab, the Find Your Edge Lab, and the live System Status panel. Higher tiers unlock the advanced scanner and more execution flexibility.

3. First-time setup (3 steps)

1. Create your account at /pricing. During launch, all tiers are free.
2. Connect Alpaca at /dashboard/settings. Sign up free at alpaca.markets, generate paper-trading keys, paste both. The dashboard, scanners, System Status, and Find Your Edge Lab all come alive once your keys are in.
3. Enable Auto-Trading in the AUTO-EXECUTION section — or leave it OFF and just use the research tools. Defaults are conservative (0.5% risk per trade, 3 max positions).

4. Connecting brokers

Stocks & ETFs run on Alpaca — it's both the data feed (real-time IEX) and the execution venue, paper or live, free signup. That's the primary path for the cloud platform.

Futures live in the NinjaTrader add-on (see section 21), which runs inside NinjaTrader on your machine — not the cloud engine.

Additional broker connections (Interactive Brokers, TradeStation, Tradovate) remain available as subscriber options in Settings for those who want them. Stubbed/not-yet-production brokers (Robinhood, Coinbase, Schwab, Webull) are hidden from the routing dropdown until they're production-grade.

5. Per-asset routing (stocks vs futures)

Settings → ASSET ROUTING. Each asset class routes independently:

• Stocks → Alpaca (paper or live) / IBKR / None (disable)
• Futures → handled by the NinjaTrader add-on; or route to Tradovate if you use a prop firm

Example: stocks on Alpaca paper through the cloud engine, futures driven by the NinjaTrader add-on on your desktop — the two run side by side.

6. Dashboard tour

The main dashboard (Terminal) now shows, top to bottom: the Catalyst Radar (upcoming market-moving events), the Live System Status panel (clone hive, bias/regime, guardian, self-learning), the Sentiment Barometer, your equity, positions, and P&L. Top nav:

• Terminal — main dashboard (System Status, Catalyst Radar, sentiment, equity, positions)
• ★ Find Your Edge — honest analysis of your own trading results
• ★ Transparency — every decision the bot made, didn't make, predicted
• Trade ▾ — Scanner (Basic/Advanced), Charts, Manual Trade, Strategy Studio, Backtest
• Portfolio ▾ — Positions, Analytics, Journals, Audit Log
• Research ▾ — Daily Futures brief, S/R Levels, Live Equity
• Account ▾ — Settings, Health Check, Go-Live Readiness
• Help ▾ — this guide, Support, Disclosures, Logout

7. ★ Find Your Edge Lab

At /dashboard/find-your-edge. This is the flagship tool. It takes your trades — from both your manual journal and the bot's ledger — and analyzes them with the same math professionals use:

• Scorecard — win rate, expectancy (in $ and R), profit factor, SQN, max drawdown, worst losing streak
• Where you have an edge / where you're leaking — your results sliced by setup, instrument, direction, time, size, and market regime
• Monte-Carlo stress test — typical and worst-5% drawdown, and risk of ruin, from thousands of resamples of your own trades
• Discipline & Behavior — revenge/tilt after losses, overtrading, plan-adherence value, and size-escalation after losses

8. ★ Live System Status panel

On the main dashboard. Live readings for each intelligence subsystem, so you can see they're actually running once your API credentials are in:

• Clone Hive — how many strategy "clones" are registered and active
• Bias / Regime — the current market regime read (trending / ranging / volatile) with the SPY return and realized-volatility inputs behind it
• Guardian suite — which protection daemons are online
• Self-learning — which pattern/outcome loops are feeding

The Bias/Regime read computes for everyone (it has a built-in fallback), so the panel populates even before your first trade.

9. ★ Catalyst Radar

A strip at the top of the dashboard showing the next high-impact market events — FOMC, CPI, NFP, PCE — with the date, time (ET), impact level, and a live countdown ("in 3 days"). Around the biggest prints the bot sizes down or stands aside, and the radar is your heads-up to do the same.

10. Scanners — Basic vs Advanced

There are two views of the same scan, deliberately different:

• Basic scanner — a clean research view: the qualifying symbols, their setups and key levels. No one-click charting, no extra-information window. Built for a quick read of what's in play.
• ★ Advanced scanner (/dashboard/scanner) — everything: conviction scoring on each setup, news/catalyst enrichment on the top actionable names, the click-to-open research window (section 11), long and short tabs, and TradingView chart links.

Stock strategies span momentum, gap-and-go, VWAP reclaim, mean-reversion, pivotal break, smart-accumulation and macro-trend on the long side, plus short variants (pivotal-break-short, failed-pump-short, breakdown-short). The regime detector decides which are appropriate for current conditions.

11. ★ Stock Research window

On the Advanced scanner, click any symbol that fits criteria and a research window opens beside it with real data — no fabrication, and if a figure isn't available it says N/A rather than guessing:

• 52-week high and low, and where price sits in that range
• Whether the company is actually profitable
• Relative volume vs its own average
• Recent headline / catalyst from free news sources
• A quick background screen (float, price band, near 52-week high, etc.)
• A "View chart" link that opens TradingView in a new tab

Data is pulled from Finnhub (if you've added a free key) with a yfinance/Yahoo fallback, so it works even with no API key.

12. Long & short execution

The engine fires both long and short setups accurately — for shorts it flips the bracket (stop above, target below) and routes a sell-to-open. Shorting is gated behind an enable-shorts setting that is OFF by default; turn it on in Settings when you want short signals to execute. Long-only users are unaffected.

13. Charts & order flow

/dashboard/charts embeds TradingView's free widget — real-time data, every timeframe, 100+ indicators, VWAP and volume overlays. Type any symbol and it updates live.

The Order Flow — Stocks page shows tape/level activity for equities. For a full futures depth-of-market (DOM / SuperDOM), use the NinjaTrader add-on — futures order flow lives inside NinjaTrader.

14. ★ The Transparency tab

Every decision the software made or didn't make, on one page:

• Confidence calibration — claimed vs actual outcomes and drift, so you can see how well-calibrated the bot is (a transparency read, not a performance claim)
• Live strategy status pills — every strategy's state (armed, cooling, halted)
• Why I Didn't Trade — every gate-rejected entry of the last 50
• Counterfactuals — what would have happened on blocked trades
• Bot's daily diary — journal entries auto-written at 4:05 PM ET
• Pre-mortems — predictions of how each trade could fail, scored after exit

15. Live Coaching Mode

Toggle in Settings → AUTO-EXECUTION → Live Coaching Mode. Recommended for your first week.

16. Journals (yours + the bot's)

• My Journal (/dashboard/my-journal) — log your own discretionary trades, with a Bot / Me / Bot+Me split so you can compare. This is what powers much of the Find Your Edge Lab.
• Bot Journal (/dashboard/bot-journal) — the bot's own realized trades.

The Find Your Edge Lab reads both, so it gives you a real picture from day one.

17. Strategies + auto-mutation

Each strategy carries a rolling grade from its recent results. Weak graders are auto-disabled. On a losing streak the strategy mutator proposes parameter mutations, A/B tests them in paper, and promotes the better one. You can also toggle each strategy ON/OFF yourself.

18. Context gates (multi-hypothesis layer)

A set of context modules that filter and size entries:

1. Schrödinger Trade — tracks breakout/fade/fakeout/chop simultaneously, acts only on dominance
2. Memory Stop — stops placed where this symbol has recently reversed
3. Causal Graph — avoids entries matching dominant historical failure patterns
4. Liquidity Calendar — shrinks size around FOMC/CPI/NFP/opex windows
5. Gate Self-Audit — the bot grades its own gates' contribution
6. Macro Coherence — bonds, the dollar, VIX and SPY must align before a stock entry
7. Trend Exhaustion — composite score; HIGH = skip, MED = halve size

These are context filters, not a promise of profit.

19. 30+ risk gates

Every order passes through a layered gate chain: KillSwitch, Defence Grid, Risk Governor (daily-loss and consecutive-loss caps), Circuit Breaker, Auto-Flattener, Stop Exits, Profit Lock, Schrödinger multi-hypothesis, Causal Graph, Macro Coherence, Memory Stop, spread/liquidity checks, Drawdown Shield, Kelly Sizer and Vol-Adaptive sizing. The Risk Governor is persistent across the session and is notified on every fill, so its caps actually fire.

20. Profit-lock + adaptive stops

• Profit Lock L1 — at a set gain, move stop to break-even
• Profit Lock L2 — trail the stop below price
• Profit Lock L3 — partial close into strength
• Profit Lock L4 — volatility-adjusted (Chandelier) exit
• Adaptive memory stop — tightens to recent reversal levels
• Risk gates + broker-side brackets — designed to limit drawdown; they cannot guarantee a maximum loss. YOU set the limits and bear all outcomes.

21. Futures via the NinjaTrader add-on

Alpaca does not offer futures, so the cloud engine is stocks-only. Futures are handled by the MiracleBot-1G NinjaScript add-on that runs inside NinjaTrader on your own machine — the strategies, scanners, and a real futures SuperDOM live there. See the /ninjatrader page for the product and download.

If you trade futures through a prop firm, the Tradovate broker option remains available in Settings as a subscriber choice.

22. Kill switch & emergency controls

Settings → EMERGENCY CONTROLS → ACTIVATE KILL SWITCH. Cancels your open orders, closes your positions, and sets trading_paused=1. It affects only YOUR account, not other subscribers, and is audit-logged.

23. Audit log + replay

Every decision is SHA-256 hash-chained and tamper-evident. View at /dashboard/audit. Click any past trade in Transparency to see the full decision tree synced with chart markers.

24. Troubleshooting

• Bot not trading? → Check Auto-Execute is ON, Alpaca keys saved, market open. Read the Transparency tab's "Why I Didn't Trade".
• Scanner or panels slow to load? → They fetch live data on open; give it a few seconds, then hard-refresh (Ctrl+Shift+R).
• Charts blank? → Hard-refresh; check the browser console for TradingView script errors.
• Find Your Edge says "No trades yet"? → Log trades in My Journal or let the bot trade — the Lab needs a few trades before it speaks.
• Most thorough check → Settings → Account → Health Check.

25. FAQ & gotchas

• Does this guarantee profits? No. It is an information tool that helps you research and analyze your own trading. Trading involves substantial risk. Past performance does not indicate future results.
• Do you trade with my money? No. We never custody funds. You connect YOUR broker accounts; orders route via YOUR credentials; you bear all outcomes.
• Can you give me investment advice? No. The Transparency tab, Coaching narrations, and Find Your Edge Lab describe and analyze — they do not advise.
• What does the Find Your Edge Lab actually do? It analyzes your own trades with professional-grade statistics and is honest about sample size, so you can discover where you genuinely do well and where you leak — and build from there.
• Is everything really free right now? During launch, yes — all tiers are open so you can explore the whole platform before paid tiers turn on.
• How do futures work? Through the NinjaTrader add-on on your own machine (section 21). The cloud platform is stocks-only on Alpaca.
• How do I know my code is intact? The Integrity Monitor verifies SHA-256 hashes of every critical file continuously and auto-restores from git on tamper. Every deploy runs the full regression suite at prestart and is rejected if even one test fails.

★ STATE-OF-THE-ART ENGINEERING DISCIPLINE

Every change to this codebase passes through an institutional-grade gate chain before it can touch production:

• Lock-in regression suite — every architectural fix is pinned by an explicit test. The suite runs at deploy prestart; failures block deployment automatically.
• Integrity Monitor — SHA-256 ledger of every critical file; a background thread auto-restores truncated or tampered files from git show HEAD:. The bot heals itself.
• Single-source modules — one module per job; dead/legacy copies are explicitly tagged and the deploy gate keeps them from ever being wired back into the live path.
• Pre-commit gate — truncation check, syntax parse, marker hygiene, Jinja validation, secret scan, contract checks.
• Self-healing daemons — heartbeat, watchdog, integrity monitor, derail watchdog, nightly autoheal, guardian suite and more, running 24/7 with restart resilience.
• Atomic commit discipline — each feature ships as one surgical commit with its own lock-in test: easy rollback, clean history.