Release v0.0.1 · versacomp/mtrade

[0.0.1] — 2026-03-06

Initial public release.

Flet (Python/Flutter) desktop application with route-based navigation
OAuth2 and username/password authentication against tastytrade REST API
Sandbox / Production environment toggle on the login screen, with a persistent nav bar badge showing the active environment
Dark / light theme toggle with preference persisted to ~/.mtrade/preferences.json
Obsidian + Sapphire colour scheme (#0F172A app bar, BLUE_500 seed)
Active-route highlighting and async nav button handlers to eliminate screen flicker between views

WebSocket candle streamer (api/dxlink_streamer.py) implementing the full DXLink protocol: SETUP → AUTH → CHANNEL_REQUEST → FEED_SUBSCRIPTION
Exponential back-off reconnection (5 s base, 60 s ceiling, ±10 % jitter, up to 10 attempts)
Automatic demo-mode fallback after all retries are exhausted
KEEPALIVE frames every 30 seconds
Connection status indicator (CONNECTED / RECONNECTING / OFFLINE / DEMO) in the nav bar

Real-time 1-minute candlestick chart for 40+ futures instruments across Equity Index, Metals, Energy, Interest Rates, FX, and Agricultural sectors
Liquidity grab reversal signal detection: 3-candle swing structure, wick-sweep + 30 % close-back threshold
Key institutional levels: 4-hour high/low and previous-day high/low (4HH, 4HL, PDH, PDL)
Three-tier signal quality system: Prime (RSI divergence + trend aligned), Filtered (divergence only), Weak (no divergence)
Wilder RSI-14 divergence detection with dots on the RSI sub-panel
SMA 200 pro-trend filter with chart background tint (green above / red below)
ADX-14 range rotation filter: ADX < 25 + level within 25 % of rolling 20-period band
Chart overlays: SMA 50 (orange), SMA 200 (green/red), 20-period range bands, key level lines, volume profile with Point of Control
RSI and ADX sub-panels with OB/OS reference lines and dashed ADX threshold
Interactive pan (click-drag) and zoom (scroll wheel) with "Jump to live" edge button
48-hour rolling candle cache per symbol, seeded from disk before stream connects
Multi-symbol support with quick-access chips (MES, MNQ, M2K, MYM, MGC)
Persistent per-symbol candle and trade cache under ~/.mtrade/
Alert system: overlay badge flash, snack-bar notification, audible beep (Windows)
Background stream persistence — stream continues running when navigating away from the view

Live trading toggle with confirmation dialog before enabling
Real order placement via POST /accounts/{acct}/orders (Market entry + Stop SL + Limit TP)
Order cancellation via DELETE /accounts/{acct}/orders/{id}
Live trading locks and disables the sim toggle; red throbbing LIVE TRADING badge
Badge persists and restores correctly after view navigation

KPI dashboard: Win Rate, Profit Factor, Expectancy, Max Drawdown, Sharpe, Recovery Factor, W:L Ratio, Total P&L
Equity curve canvas coloured by trade sign with peak/trough markers
Signal source breakdown table and ratcheting-stop exit breakdown card
Full back-test engine over 48-hour cached history with no look-ahead bias
Independent Trend Filter and Range Filter toggles for back-test comparison

config.py — centralised environment configuration with get_api_base(), get_oauth_credentials(), sandbox/production toggle
api/oauth.py — OAuth2 refresh-token exchange with multi-endpoint fallback
api/tastytrade_client.py — REST client with GET, POST, DELETE; futures symbol resolution; quote tokens; candle history
Application-wide rotating file logger (mtrade_api.log, 5 MB × 3)
User preferences persistence (~/.mtrade/preferences.json)
MIT License, SECURITY.md, CHANGELOG.md, .env.example, comprehensive .gitignore
README with Quick Start, sandbox setup guide, strategy documentation, and risk disclaimer