Skip to content

About

High-performance market analytics platform for real-time monitoring, technical indicators, and trading signal detection.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Quant Trading Platform

High-performance market telemetry monitor for Hyperliquid and Bitget, built in Rust.

Single-operator local deployment. The Trading Platform is built for a single operator and their team: one workspace, one operator identity (local), no per-route authentication, and no multi-client/SaaS model. Everything runs on your machine or a VM you control.

The Trading Platform processes high-resolution exchange telemetry and transforms raw data into real-time technical indicator visualizations. It computes 52 technical indicators across 8 functional groups (Trend, Momentum, Volume, Volatility, Structure, Regime, Institutional, Derivatives Data) with 101 signal-kind declarations across 12 SignalKind types (Divergence, Crossover, Threshold, Breakout, BandTouch, ZeroLineCross, CompressionRelease, LevelTest, TrendFlip, VolumeClimax, StackChange, PatternForming), 8 of which support bull/bear divergence detection. All computation runs in Rust, streaming live data to a Svelte 5 dashboard via WebSocket. The current UI build is observe-only (market monitoring); paper/live execution remains a backend/CLI/API capability. The platform is designed for traders and market analysis, providing a high-performance interface for monitoring market conditions, identifying technical signals, and interpreting real-time market behavior.

Quick Start Workflow

The system provides a unified helper script (manage.sh) at the root level to simplify building, running, and testing the entire workspace.

1. Common Workflow Commands

All key operations can be executed directly from the root directory:

# Make the manager script executable
chmod +x manage.sh

# 1. Install dependencies & build all components (Frontend + Backend)
./manage.sh build

# 2. Run the platform in the foreground (with live terminal logs)
./manage.sh run

# 3. Run the platform in the background (with silent logs writing to engine.log)
./manage.sh run-silent

# 4. Check status or stop the background execution
./manage.sh status
./manage.sh stop

# 5. Run all test suites (Rust unit/integrations + Svelte 5 Vitest)
./manage.sh test

# 6. Stop engine, clean builds, and permanently delete telemetry.db
./manage.sh destroy

Once running, navigate to http://127.0.0.1:3000 to access the dashboard.

Workspace Structure

The platform is a 10-crate Cargo workspace + Svelte 5 frontend. The six logical engines (DIE, MME, TAE, PME, PAE, BTE) are mapped onto these physical crates:

  • crates/core-domain — Stateless DTOs (MarketSnapshot, matrices), JSON-RPC, indicator value types.
  • crates/config-models — All *Config structs + load_config() / load_instances() readers.
  • crates/market-analyzer — 52 technical indicators, signals, multi-TF pipeline, decision support, liquidity math (MME).
  • crates/database-storage — SQLite schema, migrations, WAL telemetry logger, queries (DIE persistence layer).
  • crates/network-adapters — WS/REST clients (Hyperliquid, Bitget), NTP clock monitor, candle reconstruction, connection-quality tracker (DIE).
  • crates/portfolio-supervisor — Instance lifecycle, position sizing, safety veto, session state, risk/commission math (PME + TAE).
  • crates/performance-analytics — Dashboard stats compiler, strategy optimizer (PAE).
  • crates/backtesting-engine — Candle archive + backfill, deep-history MME-pipeline replay, recorded-decision replay, DS persistence (BTE).
  • crates/api-gateway — Axum HTTP router, WS broadcast server, HTTP handlers and request/response shapes.
  • crates/execution-daemon — Headless CLI binary that wires everything together (--web mode).
  • ui — Svelte 5 dashboard with interactive charting, real-time data, and market analysis tools.

Documentation

The complete institutional documentation set lives under docs/, organized into conceptual foundations, matrix data contracts, per-engine specifications, integration/API references, UI/UX layouts, and operations & compliance guides.

Document Audience Description
Global Architecture Developers Two-dimensional framework: 6 engines x sequenced analytical layers
Ontology Developers Formal ontology: engines, layers, matrices, 12 evaluation axes
Systemic Data Flow Developers Chronological data-flow sequences across all engines
Timeframe Model Developers Duration-keyed timeframe model: 14-duration pool (1s…1d) with a live-editable ACTIVE set
Matrices Developers Physical schemas and JSON contracts for the matrix family (MME + DIE + BTE)
Data Infrastructure Engine Developers Ingestion, reconstruction, persistence, and data-quality layer specs
Market Monitoring Engine Developers 7 layer specs, indicator guide, signal guide, per-indicator specs
Trade Automation Engine Developers Setup executor + unified execution engine specs (Observe default; paper/live backends)
Portfolio Management Engine Developers Position + Exposure + Capital + Portfolio layer specs
Performance Analytics Engine Developers Trade + Strategy + Risk + Performance layer specs
Backtesting Engine Developers Candle archive + backfill, historical runner, recorded replay, DS persistence
Integration & API Developers REST/WebSocket/JSON-RPC contracts and database schema
UI/UX Frontend Svelte 5 state management and dashboard layout specifications
Operations & Compliance Operators User manual, pre-trade risk controls, connection resilience/quality, clock monitor
AGENTS.md Maintainers Build instructions, runtime details, testing conventions

About

High-performance market analytics platform for real-time monitoring, technical indicators, and trading signal detection.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages