# quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading architecture

> Architecture diagram of the GitHub repository quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading
- Repository: https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading

## Overview

This is a reproducible research artifact for hybrid quantum-classical trade execution. Its runtime workflow starts with an order, runs a nonblocking tick loop using a fallback or latest published schedule, and solves schedules asynchronously; a separate evaluation workflow compares schedules on held-out market data and produces statistical results and figures. The graph also preserves the documented microstructure, solver, and IBM hardware-analysis branches. Some subsystem links are README-documented rather than visible in sampled implementation, so those links are identified as documented or left out when their caller is unknown.

Main entry points: [`experiments/real_data.py`](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/experiments/real_data.py) (Held-out data study), [`src/qexec/runtime/hft_pipeline.py`](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/hft_pipeline.py) (HFT pipeline), [`src/qexec/runtime/controller.py`](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/controller.py) (Hybrid controller), [`src/qexec/runtime/engine.py`](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/engine.py) (Tick execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Hybrid runtime"]
  node_controller["Hybrid controller<br/>[controller.py]"]
  node_tick_engine["Tick execution<br/>[engine.py]"]
  node_policy_slot["Latest policy slot<br/>[policy.py]"]
  node_async_optimizer["Async optimizer<br/>[optimizer.py]"]
  node_hft_pipeline["HFT pipeline<br/>[hft_pipeline.py]"]
  node_latency["Latency monitor<br/>[latency.py]"]
end

subgraph group_execution["Execution and markets"]
  node_market_data["Market data<br/>[binance.py]"]
  node_market_model["Market simulation<br/>[simulator.py]"]
  node_order_book["Order book<br/>[order_book.py]"]
  node_calibration["Impact calibration<br/>[calibration.py]"]
  node_strategies["Execution strategies<br/>[base.py]"]
  node_execution_engine["Execution engine<br/>[engine.py]"]
  node_cost_model["Execution costs<br/>[cost_model.py]"]
end

subgraph group_optimization["Optimization"]
  node_qubo["Schedule QUBO<br/>[qubo.py]"]
  node_hft_qubo["HFT QUBO<br/>[hft_qubo.py]"]
  node_schedule["Schedule encoding<br/>[schedule.py]"]
  node_sa_solver["Annealing solver<br/>[annealing.py]"]
  node_qaoa_solver["QAOA solver<br/>[qaoa.py]"]
end

subgraph group_research["Research and analysis"]
  node_microstructure["Microstructure analysis<br/>[analyzer.py]"]
  node_regime["Regime analysis<br/>[regime.py]"]
  node_real_data_study["Held-out data study<br/>[real_data.py]"]
  node_analysis["Execution statistics<br/>[statistics.py]"]
  node_hardware_analysis["IBM job analysis"]
end

subgraph group_reporting["Results and figures"]
  node_experiment_record[("Experiment records<br/>[experiment.py]")]
  node_figure_registry["Figure registry<br/>[registry.py]"]
  node_results_reader["Results reader<br/>[common.py]"]
  node_paper_figures["Paper figures<br/>[paper.py]"]
  node_dashboard["Streamlit dashboard<br/>[dashboard.py]"]
end

node_user(("Order initiator"))

node_user -->|"submits order"| node_controller
node_controller -->|"creates slot"| node_policy_slot
node_controller -->|"starts optimizer"| node_async_optimizer
node_controller -->|"starts execution"| node_tick_engine
node_tick_engine -->|"polls policies"| node_policy_slot
node_async_optimizer -.->|"publishes schedules"| node_policy_slot
node_async_optimizer -.->|"solves schedule QUBO"| node_qubo
node_qubo -.->|"solved by"| node_sa_solver
node_qubo -.->|"offline solver"| node_qaoa_solver
node_tick_engine -->|"repairs plan"| node_schedule
node_tick_engine -->|"records latency"| node_latency
node_hft_pipeline -->|"updates estimates"| node_microstructure
node_hft_pipeline -->|"updates estimates"| node_regime
node_hft_pipeline -->|"builds problem"| node_hft_qubo
node_hft_pipeline -->|"re-solves problem"| node_sa_solver
node_hft_pipeline -->|"publishes policy"| node_policy_slot
node_hft_pipeline -->|"records latency"| node_latency
node_market_data -.->|"supplies market data"| node_real_data_study
node_real_data_study -->|"loads calibration"| node_calibration
node_real_data_study -->|"runs evaluation"| node_execution_engine
node_real_data_study -->|"evaluates strategies"| node_strategies
node_real_data_study -.->|"uses cost model"| node_cost_model
node_execution_engine -->|"uses book"| node_order_book
node_execution_engine -->|"uses simulator"| node_market_model
node_execution_engine -->|"runs strategy"| node_strategies
node_strategies -->|"reads snapshots"| node_order_book
node_strategies -->|"uses VWAP"| node_market_model
node_calibration -->|"calibrates costs"| node_cost_model
node_real_data_study -.->|"compares outcomes"| node_analysis
node_real_data_study -->|"writes study outputs"| node_experiment_record
node_hardware_analysis -.->|"records analysis"| node_experiment_record
node_hardware_analysis -.->|"compares results"| node_sa_solver
node_figure_registry -->|"configures producers"| node_results_reader
node_paper_figures -->|"reads results"| node_results_reader
node_results_reader -.->|"reads output tables"| node_experiment_record
node_dashboard -->|"uses controller"| node_controller

click node_controller "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/controller.py"
click node_tick_engine "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/engine.py"
click node_policy_slot "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/policy.py"
click node_async_optimizer "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/optimizer.py"
click node_hft_pipeline "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/hft_pipeline.py"
click node_latency "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/latency.py"
click node_market_data "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/binance.py"
click node_market_model "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/simulator.py"
click node_order_book "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/order_book.py"
click node_calibration "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/calibration.py"
click node_strategies "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/strategies/base.py"
click node_execution_engine "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/engine.py"
click node_cost_model "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/cost_model.py"
click node_microstructure "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/microstructure/analyzer.py"
click node_regime "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/microstructure/regime.py"
click node_qubo "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/qubo.py"
click node_hft_qubo "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/hft_qubo.py"
click node_schedule "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/schedule.py"
click node_sa_solver "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/solvers/annealing.py"
click node_qaoa_solver "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/solvers/qaoa.py"
click node_real_data_study "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/experiments/real_data.py"
click node_analysis "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/analysis/statistics.py"
click node_hardware_analysis "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/experiments/hardware_analysis.py"
click node_experiment_record "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/experiment.py"
click node_figure_registry "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/registry.py"
click node_results_reader "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/common.py"
click node_paper_figures "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/paper.py"
click node_dashboard "https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/apps/dashboard.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_controller,node_tick_engine,node_policy_slot,node_async_optimizer,node_hft_pipeline,node_latency toneBlue
class node_market_data,node_market_model,node_order_book,node_calibration,node_strategies,node_execution_engine,node_cost_model toneAmber
class node_qubo,node_hft_qubo,node_schedule,node_sa_solver,node_qaoa_solver toneMint
class node_microstructure,node_regime,node_real_data_study,node_analysis,node_hardware_analysis toneRose
class node_experiment_record,node_figure_registry,node_results_reader,node_paper_figures,node_dashboard,node_user toneIndigo
```

## Components

### Hybrid runtime

- [Hybrid controller](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/controller.py): `src/qexec/runtime/controller.py`
- [Tick execution](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/engine.py): `src/qexec/runtime/engine.py`
- [Latest policy slot](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/policy.py): `src/qexec/runtime/policy.py`
- [Async optimizer](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/optimizer.py): `src/qexec/runtime/optimizer.py`
- [HFT pipeline](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/hft_pipeline.py): `src/qexec/runtime/hft_pipeline.py`
- [Latency monitor](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/runtime/latency.py): `src/qexec/runtime/latency.py`

### Execution and markets

- [Market data](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/binance.py): `src/qexec/market/binance.py`
- [Market simulation](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/simulator.py): `src/qexec/market/simulator.py`
- [Order book](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/order_book.py): `src/qexec/market/order_book.py`
- [Impact calibration](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/market/calibration.py): `src/qexec/market/calibration.py`
- [Execution strategies](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/strategies/base.py): `src/qexec/execution/strategies/base.py`
- [Execution engine](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/engine.py): `src/qexec/execution/engine.py`
- [Execution costs](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/execution/cost_model.py): `src/qexec/execution/cost_model.py`

### Optimization

- [Schedule QUBO](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/qubo.py): `src/qexec/optimization/qubo.py`
- [HFT QUBO](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/hft_qubo.py): `src/qexec/optimization/hft_qubo.py`
- [Schedule encoding](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/schedule.py): `src/qexec/optimization/schedule.py`
- [Annealing solver](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/solvers/annealing.py): `src/qexec/optimization/solvers/annealing.py`
- [QAOA solver](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/optimization/solvers/qaoa.py): `src/qexec/optimization/solvers/qaoa.py`

### Research and analysis

- [Microstructure analysis](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/microstructure/analyzer.py): `src/qexec/microstructure/analyzer.py`
- [Regime analysis](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/microstructure/regime.py): `src/qexec/microstructure/regime.py`
- [Held-out data study](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/experiments/real_data.py): `experiments/real_data.py`
- [Execution statistics](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/analysis/statistics.py): `src/qexec/analysis/statistics.py`
- [IBM job analysis](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/experiments/hardware_analysis.py): `experiments/hardware_analysis.py`

### Results and figures

- [Experiment records](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/src/qexec/experiment.py): `src/qexec/experiment.py`
- [Figure registry](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/registry.py): `figures/registry.py`
- [Results reader](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/common.py): `figures/common.py`
- [Paper figures](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/figures/paper.py): `figures/paper.py`
- [Streamlit dashboard](https://github.com/quantum-blade1/hybrid-quantum-classical-optimal-execution-engine-for-low-latency-trading/blob/main/apps/dashboard.py): `apps/dashboard.py`

### Other components

- **Order initiator**

## Connections

- Order initiator → Hybrid controller: submits order (evidence: `src/qexec/runtime/controller.py`)
- Hybrid controller → Latest policy slot: creates slot (evidence: `src/qexec/runtime/controller.py`)
- Hybrid controller → Async optimizer: starts optimizer (evidence: `src/qexec/runtime/controller.py`)
- Hybrid controller → Tick execution: starts execution (evidence: `src/qexec/runtime/controller.py`)
- Tick execution → Latest policy slot: polls policies (evidence: `src/qexec/runtime/engine.py`)
- Async optimizer → Latest policy slot: publishes schedules
- Async optimizer → Schedule QUBO: solves schedule QUBO
- Schedule QUBO → Annealing solver: solved by
- Schedule QUBO → QAOA solver: offline solver
- Tick execution → Schedule encoding: repairs plan (evidence: `src/qexec/runtime/engine.py`)
- Tick execution → Latency monitor: records latency (evidence: `src/qexec/runtime/engine.py`)
- HFT pipeline → Microstructure analysis: updates estimates (evidence: `src/qexec/runtime/hft_pipeline.py`)
- HFT pipeline → Regime analysis: updates estimates (evidence: `src/qexec/runtime/hft_pipeline.py`)
- HFT pipeline → HFT QUBO: builds problem (evidence: `src/qexec/runtime/hft_pipeline.py`)
- HFT pipeline → Annealing solver: re-solves problem (evidence: `src/qexec/runtime/hft_pipeline.py`)
- HFT pipeline → Latest policy slot: publishes policy (evidence: `src/qexec/runtime/hft_pipeline.py`)
- HFT pipeline → Latency monitor: records latency (evidence: `src/qexec/runtime/hft_pipeline.py`)
- Market data → Held-out data study: supplies market data
- Held-out data study → Impact calibration: loads calibration (evidence: `experiments/real_data.py`)
- Held-out data study → Execution engine: runs evaluation (evidence: `experiments/real_data.py`)
- Held-out data study → Execution strategies: evaluates strategies (evidence: `experiments/real_data.py`)
- Held-out data study → Execution costs: uses cost model (evidence: `experiments/real_data.py`)
- Execution engine → Order book: uses book (evidence: `src/qexec/execution/engine.py`)
- Execution engine → Market simulation: uses simulator (evidence: `src/qexec/execution/engine.py`)
- Execution engine → Execution strategies: runs strategy (evidence: `src/qexec/execution/engine.py`)
- Execution strategies → Order book: reads snapshots (evidence: `src/qexec/execution/strategies/base.py`)
- Execution strategies → Market simulation: uses VWAP (evidence: `src/qexec/execution/strategies/base.py`)
- Impact calibration → Execution costs: calibrates costs (evidence: `src/qexec/market/calibration.py`)
- Held-out data study → Execution statistics: compares outcomes (evidence: `experiments/real_data.py`)
- Held-out data study → Experiment records: writes study outputs (evidence: `src/qexec/experiment.py`)
- IBM job analysis → Experiment records: records analysis (evidence: `experiments/hardware_analysis.py`)
- IBM job analysis → Annealing solver: compares results
- Figure registry → Results reader: configures producers (evidence: `figures/registry.py`)
- Paper figures → Results reader: reads results (evidence: `figures/paper.py`)
- Results reader → Experiment records: reads output tables
- Streamlit dashboard → Hybrid controller: uses controller (evidence: `apps/dashboard.py`)
