How ling5477/nexus-quant works
NexusQuant is a quantitative-trading platform with market-data ingestion, strategy research and validation, paper/shadow evidence, exchange adapters, and operator-facing monitoring. A representative user workflow is to ingest historical market data, inspect strategy runs and validation evidence, then review paper/shadow consistency and operational incidents. The README explicitly limits live-trading authority: shadow trading is not enabled, and the historical OKX pilot does not authorize general live trading. The graph combines sampled service behavior with subsystem names evident in the tree; wiring for unsampled modules is intentionally omitted.
Main entry points: ValidationOperationsRuntimeEvidenceOverviewQueryService.java Runtime evidence · MarketdataIngestionService.java Ingestion service · MarketdataController.java REST API · BinanceHistoricalKlineAdapter.java Binance adapter
Components 19
API and accounts
- REST API
backend/nq-api/src/main/java/com/guidinglight/nexusquant/marketdata/api/web/MarketdataController.java - Exchange accounts
backend/nq-core/src/main/java/com/guidinglight/nexusquant/account/application/service/ExchangeAccountQueryService.java
Market data
- Ingestion service
backend/nq-core/src/main/java/com/guidinglight/nexusquant/marketdata/application/service/MarketdataIngestionService.java - Catalog and quality
backend/nq-api/src/main/java/com/guidinglight/nexusquant/marketdata/api/web/InstrumentCatalogController.java
Research and validation
- Strategy run queries
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/StrategyRunQueryService.java - Backtest facts
backend/nq-backtest/src/main/java/com/guidinglight/nexusquant/research/application/backtest/BacktestFactQueryService.java - Strategy validation
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/evaluationgate/service/StrategyValidationOverviewQueryService.java - Shadow workflow
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/shadowvalidation/service/ShadowValidationWorkflowOverviewQueryService.java - Consistency evidence
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/consistencyevidence/service/ConsistencyEvidenceOverviewQueryService.java - Shadow drilldown
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/shadowrun/service/PaperShadowConsistencyDrilldownQueryService.java
Operations evidence
- Runtime evidence
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/validationoperations/runtimeevidence/ValidationOperationsRuntimeEvidenceOverviewQueryService.java - Incident overview
backend/nq-core/src/main/java/com/guidinglight/nexusquant/monitoring/application/incident/IncidentReplayOverviewQueryService.java - Incident review
backend/nq-core/src/main/java/com/guidinglight/nexusquant/monitoring/application/incidentreview/service/IncidentReplayReviewOverviewQueryService.java - Artifact preview
backend/nq-core/src/main/java/com/guidinglight/nexusquant/strategy/application/pyartifactpreview/service/PythonEvaluationArtifactPreviewOverviewQueryService.java - Pilot control
backend/nq-api/src/main/java/com/guidinglight/nexusquant/livecontrol/api/PilotScopeControlPlaneController.java
Exchange adapters
- Binance adapter
backend/nq-adapter-binance/src/main/java/com/guidinglight/nexusquant/adapter/binance/marketdata/BinanceHistoricalKlineAdapter.java - OKX adapter
backend/nq-adapter-okx/src/main/java/com/guidinglight/nexusquant/adapter/okx/marketdata/OkxHistoricalKlineAdapter.java
Other components
- Platform user
- Exchange venues
Connections 21
- Platform user → REST API: requests
- Platform user → Exchange accounts: manages
- REST API → Ingestion service: creates and queries
- Ingestion service → Binance adapter: fetches bars
- Ingestion service → OKX adapter: fetches bars
- Binance adapter → Exchange venues: market data
- OKX adapter → Exchange venues: market data
- Platform user → Catalog and quality: reviews catalog
- Platform user → Strategy run queries: queries runs
- Platform user → Backtest facts: queries backtests
- Platform user → Strategy validation: reviews evidence
- Platform user → Shadow workflow: reviews workflow
- Platform user → Shadow drilldown: inspects run
- Platform user → Incident overview: reviews incidents
- Platform user → Incident review: reviews findings
- Platform user → Artifact preview: previews artifact
- Platform user → Pilot control: controls pilot scope
- Runtime evidence → Shadow workflow: loads evidence
- Runtime evidence → Consistency evidence: loads evidence
- Runtime evidence → Incident review: loads evidence
- Runtime evidence → Artifact preview: loads evidence