Market Watch — Runtime-Governed Trading Analytics

About This Project

Market Watch is a full-stack algorithmic trading system built to demonstrate professional software engineering practices in a high-stakes domain. It combines real-time market data integration, risk-managed trade execution, and comprehensive observability into a production-ready platform.

What This Demonstrates

🔒 Security Hardening

Token-based API auth, TLS termination, firewall isolation, secrets management

🎯 Execution Invariants

Universe isolation, state machine contracts, immutable event logs, audit trails

📊 Real-Time Observability

Agent health tracking, anomaly detection, latency profiling, risk alerts

⚙️ Production Deployment

VPS hosting, reverse proxy, systemd services, zero-downtime updates

🧪 Comprehensive Testing

710+ passing tests, integration coverage, universe guardrails validation

🚀 Live Market Integration

Alpaca API, real-time bars, top-gainers momentum strategy, RVOL filtering

Current Status Active Development

This system is in active development with production-grade infrastructure already in place. The core trading engine, risk management pipeline, and observability framework are operational. Current work focuses on Phase R2 integration (realism layer for cost basis, settlements, and tax accounting).

Recent Milestones

Phase A: Universe isolation hardening (LIVE/PAPER/SIMULATION separation)
Phase B: Latency tracking + anomaly detection (p50/p95 metrics, baseline monitoring)
Phase D: Analytics engine (P&L tracking, period returns, CSV/HTML exports)
Security: VPS hardening (nginx proxy, auth gates on all API routes, docs disabled in prod)
Testing: 710 tests passing with 4 skips

Feature Preview

The application provides a comprehensive real-time dashboard and API for monitoring trading activity, risk metrics, and system health.

📸 Screenshots Coming Soon

UI captures: Trades view • Risk & Limits • Analytics • Observability dashboard

Key Capabilities

Live Dashboard: Real-time trades, account metrics, position tracking, market index tickers
Risk Management: Position limits, circuit breakers, daily loss caps, sector exposure tracking
Analytics Engine: Realized/unrealized P&L, period returns, trade history exports, HTML reports
Agent Observability: Event classification (OK/WARN/FAIL), daily risk alert CSVs, anomaly detection
Configuration: Live-updatable runtime config via UI, per-universe persistence
WebSocket Updates: Real-time status broadcasts, sub-second latency for critical events

Access-Controlled Demo

🔐 Why is the demo behind authentication?

This application mirrors production security practices. All endpoints are token-protected to demonstrate proper access control implementation. The live instance runs actual market integrations and persists state — authentication ensures the system remains in a known-good configuration for demonstrations.

Request Demo Access

Demo credentials are available upon request for recruiters and prospective employers. The demo environment is read-only with all state-changing actions disabled via server-side enforcement.

To request access: Contact via email or GitHub with your name and company affiliation.

Enter Demo (Auth Required)

Request Access