HOW TO USE MIRACLEBOT-1G

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

The bot scans markets every 5 minutes, identifies setups, applies 30+ risk gates, runs them through 9 supremacy modules (precognition layer), and places orders via YOUR broker connections — or, in Live Coaching Mode, narrates what it detects without placing orders.

Default mode: PAPER. Run paper trading indefinitely. Switch to live only when you decide to.

2. Subscription tiers

All tiers include the core scanning engine, 30+ risk gates, real-time charts, and the Transparency tab. Higher tiers unlock more execution flexibility and asset classes.

3. First-time setup (3 steps)

1. Subscribe at /pricing — Stripe checkout, choose your tier.
2. Connect Alpaca at /dashboard/settings. Sign up free at alpaca.markets, generate paper-trading keys, paste both. Mode: Paper for first week.
3. Enable Auto-Trading in the AUTO-EXECUTION section. Defaults are conservative (0.5% risk per trade, 3% max daily loss, 3 max positions). Adjust later.

4. Connecting brokers

Production-ready brokers (you can route orders to them):

• Alpaca — stocks + crypto + options. Paper or live. Free signup.
• Interactive Brokers — stocks + futures + global markets.
• TradersPost — webhook bridge to prop-firm Tradovate accounts (MFF, Topstep, Apex).
• Tradovate — futures direct API.
• NinjaTrader — futures direct API.
• TradeStation — stocks + futures.

Stubbed (not yet production-ready): Robinhood, Coinbase, Schwab, Webull. They're hidden from the routing dropdown until they're production-grade.

5. Per-asset broker routing

Settings → ASSET ROUTING. Each asset class can route to a different broker:

• Stocks → Alpaca / IBKR / None (disable)
• Crypto → Alpaca / None
• Futures → TradersPost (prop firms) / Tradovate / NinjaTrader / None

Example: stocks at Alpaca paper, crypto at Alpaca paper, futures at MFF via TradersPost — all simultaneously.

6. Prop firms (MFF, Topstep, Apex)

For futures via prop firms, route futures to TradersPost:

1. Sign up at traderspost.io and connect your prop-firm Tradovate account
2. Create a strategy in TradersPost (give it a name like "MFF MES Live")
3. Copy the webhook URL
4. Paste it in Settings → TRADERSPOST WEBHOOK BRIDGE
5. Set Manual Equity Override to your prop-firm account size (e.g. 50000 for MFF $50K)

7. Dashboard tour

Top nav:

• Terminal — main dashboard with Sentiment Barometer, equity, positions, P&L
• ★ Transparency — every decision the bot made, didn't make, predicted
• Trade ▾ — Scanner, Live Charts, Manual Trade, Strategy Studio, Backtest
• Portfolio ▾ — Positions, Analytics, TCA, Attribution, Audit Log, Why-Trade Explainer
• Research ▾ — Daily Futures brief, S/R Levels, Live Equity, Comeback
• Account ▾ — Settings, Prop Firms, Health Check, Go-Live Readiness
• Help ▾ — this guide, Support, Disclosures, Refund policy, Logout

8. Real-time charts

/dashboard/charts renders TradingView's free embedded widget — real-time tick data, all timeframes, 100+ indicators. Type any symbol (AAPL, BTC/USD, MES) and the chart updates live. Volume and VWAP overlays included.

Below the live chart, expand "Show historical bars" to see our internal Lightweight Charts view used for trade replay context.

9. Market sentiment barometer

Visible on the main dashboard. Visual gauge with needle position 0-100, mapped to 5 bands: EXTREME FEAR / FEAR / NEUTRAL / GREED / EXTREME GREED. Composed from SPY trend, VIX percentile, breadth, bot's own confidence. Refreshes every 2 min.

10. ★ The Transparency tab

The killer feature. Every decision the software made or didn't make, on one page:

• Confidence calibration scoreboard — Brier score, claimed vs actual win rate, drift
• 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 after 60 min
• Bot's daily diary — last 5 days of journal entries auto-written 4:05 PM ET
• Pre-mortems — predictions about how each trade would fail, scored after exit
• Live Coaching Mode indicator + link to settings

11. Live Coaching Mode

Toggle in Settings → AUTO-EXECUTION → Live Coaching Mode. Recommended for the first week as you learn how the software thinks.

12. The scanners

• Stocks scanner — 11 strategies: 8 long (momentum, gap_go, vwap_reclaim, mean_reversion, pivotal_break, smart_accum, macro_trend, wheel) + 3 short variants (pivotal_break_short, failed_pump_short, breakdown_short) — auto-selected by regime detector
• Unified scanner UI — all 13 tabs (8 long + 3 short + crypto + futures) plus 4 asset-class filters (Stocks/Crypto/Futures/Forex) — single state-of-the-art page at /dashboard/scanner
• Crypto scanner — momentum + mean-reversion across BTC/ETH/SOL/LTC and 10+ pairs (24/7)
• Futures scanner — 32 symbols across 7 categories (equity index / metals / energy / rates / FX / ags / softs)
• Pattern anticipation engine — FVG, BOS/CHoCH, order blocks, liquidity sweeps
• Forming detector — early-stage pattern signals before they confirm

13. Strategies + auto-mutation

Each strategy gets a daily letter grade (A/B/C/D/F) based on rolling 30-day Sharpe + win rate + max DD. F-graders are auto-disabled. On a 5-loss streak the strategy mutator proposes 3 parameter mutations, A/B tests them in paper, promotes the winner.

14. ★ Supremacy gates (precognition layer)

Eleven cutting-edge modules no other retail bot has:

1. Schrödinger Trade — tracks 4 simultaneous outcomes (breakout/fade/fakeout/chop), only fires on dominance
2. Memory Stop — stops placed where THIS symbol has reversed in last 30 days
3. Strategy Mutator — failing strategies evolve via A/B testing
4. Causal Graph — refuses entries matching dominant historical failure patterns
5. Liquidity Calendar — auto-shrinks during FOMC/CPI/NFP/opex windows
6. Risk Cone — 80% probability cone for next 60 min before each trade
7. Gate Self-Audit — bot grades its own gates' P&L contribution
8. Pre-Echo Detector — volume cluster reveals setups 5-15 min before they confirm
9. Macro Coherence — TLT + UUP + VIX + SPY must align before stock entry
10. Trend Exhaustion Detector — composite score (ADX/RSI/volume/candle climax/pivot proximity) — HIGH = skip trade, MED = halve size
11. MFF Rules Enforcer — client-side My Funded Futures rule enforcement at 80% of plan limits (daily-loss, trailing DD, max contracts, consistency rule)

15. 30+ risk gates

Every order passes through (in order): KillSwitch, Defence Grid, Risk Governor, Circuit Breaker, daily-loss check, news-trigger gate, Context Filter, Auto-Flattener, Stop Exits, Profit Lock, Forming Detector pattern check, HTF Confluence, Schrödinger Multi-Hypothesis, Causal Graph, Macro Coherence, Memory Stop, Liquidity Event, Pre-Echo, ATR-Stretch filter, Spread Gate, Liquidity Engine, Drawdown Shield (7 layers), Elite Protections (9 layers), Alpha Gates (4 layers), Kelly Sizer, Vol Adaptive Size. Each fails OPEN — a single broken feed never halts trading.

16. Profit-lock + adaptive stops

• Profit Lock L1 — at +3% gain, move stop to break-even
• Profit Lock L2 — at +5% gain, trail stop below price
• Profit Lock L3 — at +8% gain, partial close
• Profit Lock L4 — Chandelier exit (volatility-adjusted)
• Adaptive memory stop — tightens to recent reversal levels
• Mathematical -5% backstop — capital cannot drop more than 5% in any single day

17. Bot's daily diary

Auto-written every weekday at 4:05 PM ET. Reads today's trades + near-misses + tomorrow's calendar and composes a one-paragraph journal entry. View on Transparency tab.

18. Kill switch

Settings → EMERGENCY CONTROLS → ACTIVATE KILL SWITCH. Cancels all open orders, closes all positions, sets trading_paused=1. Affects only YOUR subscriber row, not other subscribers. Audit-logged.

19. Audit log + replay

Every decision is SHA-256 hash-chained. Tamper-evident. View at /dashboard/audit. Click any past trade in Transparency to see the Time-Machine Replay (full decision tree synced with chart markers).

20. Self-healing infrastructure

6 background daemons (heartbeat, watchdog, integrity-monitor, derail-watchdog, nightly-autoheal, guardian-suite) plus a daemon-liveness checker that auto-pauses trading if any daemon dies. Every Python file has SHA-256 integrity verified every 60 seconds. If a file gets corrupted (truncated mid-write, bad disk), it's auto-restored from git HEAD within 60 seconds.

21. Troubleshooting

• Bot not trading? → Check Settings has Auto-Execute ON, Alpaca keys saved, market is open. Look at Transparency tab "Why I Didn't Trade" section.
• Charts blank? → Hard-refresh (Ctrl+Shift+R). If still blank, check browser console for TradingView script errors.
• Settings not saving? → Hard-refresh, click broker tab, fill fields, click SAVE SETTINGS. Reload to verify.
• Engine offline? → /dashboard/diagnostics → Health Check. Bot should auto-restart via watchdog within 60 seconds.
• Settings → Account → Health Check for the most thorough diagnostic.

22. FAQ & gotchas

• Does this guarantee profits? No. We are a software tool. Algorithmic trading involves substantial risk. Past performance is not indicative of 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. We are a software tool. The Transparency tab and Live Coaching narrations describe what the software detects — not advice.
• What if I get blown up? The bot has 30+ risk gates plus a mathematical -5% daily backstop. But ultimately YOU set risk limits and YOU bear outcomes.
• Refund policy? See /policy/refunds. 7-day trial then debit-only, no refunds (industry standard for SaaS).
• Why does the log sometimes say BLIND_MODE for futures? The bot currently bridges futures orders through TradersPost (webhook → Tradovate) while we finalize direct Tradovate vendor API credentials. In BLIND_MODE, the bot relies on broker-side stop/target brackets and the prop-firm's daily-loss rule as the real backstop. Direct API integration with real-time position tracking and L2 data lands when vendor credentials clear.
• How do I know my code is intact? The Integrity Monitor verifies SHA-256 hashes of every critical file every 60 seconds and auto-restores from git on tamper. Every deploy runs 280+ regression tests at prestart; the deploy is rejected if even one fails. You can audit this in the /dashboard/diagnostics tab.
• Can I see exactly what the bot did today? Yes — the Transparency tab is the bot's daily diary. Every entry, exit, near-miss, gate decision, and counterfactual is logged with timestamps and reasons. Live Coaching Mode narrates decisions in real-time as they fire.

★ STATE-OF-THE-ART ENGINEERING DISCIPLINE

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

• 280+ lock-in regression tests — every architectural fix is pinned by an explicit test. The suite runs at Render prestart on every deploy; failures block deployment automatically.
• Integrity Monitor — SHA-256 ledger of every critical file. Background thread (60-second interval) auto-restores truncated or tampered files from git show HEAD:. The bot heals itself.
• 6-check pre-commit gate — truncation check, .py syntax parse, marker hygiene, Jinja block validation, secret scan, static + contract checks. Refuses bad commits before they leave your machine.
• Fail-loud asserts — class bindings, broker health, regime invariants checked at module-import time. Silent regressions surface as crashes, not as quiet capital bleed.
• 9 self-healing daemons — heartbeat, watchdog, integrity monitor, derail watchdog, nightly autoheal, guardian suite, strategy executor, bot health diagnostic, daily marketing. All running 24/7 with restart resilience.
• Atomic commit discipline — every feature ships as one surgical commit with its own lock-in test. Easy rollback, clean git history, no surprise sweeps.
• Render prestart deploy gate — runs the full regression suite before gunicorn starts. The site cannot go live with a single failing test.