# pushkarkumarvats/omniquant architecture

> Architecture diagram of the GitHub repository pushkarkumarvats/omniquant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pushkarkumarvats/omniquant
- Repository: https://github.com/pushkarkumarvats/omniquant

## Overview

OmniQuant is a quantitative trading research and simulation platform. A representative workflow ingests market data, derives features and alpha signals, then supports portfolio/risk decisions and simulated execution; the FastAPI gateway exposes backtests and data operations, while dashboards present results. The README also documents a native Rust OMS, FIX and execution algorithms, alternative-data research, messaging, and persistence. Edges are limited to relationships visible in excerpts, SOURCE INDEX references, or README statements; unverified subsystem wiring is omitted.

Main entry points: [`src/integration.py`](https://github.com/pushkarkumarvats/omniquant/blob/main/src/integration.py) (System Integration), [`src/data_pipeline/ingestion.py`](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/ingestion.py) (Data Ingestion), [`src/execution/native_gateway/oms_bridge.py`](https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/native_gateway/oms_bridge.py) (OMS Bridge), [`src/api/main.py`](https://github.com/pushkarkumarvats/omniquant/blob/main/src/api/main.py) (FastAPI Gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research &amp; Alpha"]
  node_features["Feature Engineering"]
  node_microfeatures["Microstructure Features"]
  node_altdata["Alternative Data<br/>[alt_data.py]"]
  node_models["ML Alpha Models<br/>[boosting_model.py]"]
  node_strategies["Trading Strategies"]
end

subgraph group_data["Market Data"]
  node_ingestion["Data Ingestion<br/>[ingestion.py]"]
  node_connectors["Realtime Connectors"]
  node_pipeline["Data Processing<br/>[arrow_pipeline.py]"]
  node_timeseries[("Timeseries Database<br/>[timeseries_db.py]")]
  node_featurestore[("Feature Store<br/>[feature_store.py]")]
end

subgraph group_trade["Trading &amp; Execution"]
  node_backtest["Event Backtester<br/>[event_simulator.py]"]
  node_matching["Matching Engine<br/>[matching_engine.py]"]
  node_orderbook["Simulated Order Book<br/>[orderbook.py]"]
  node_optimizer["Portfolio Optimizer<br/>[optimizer.py]"]
  node_riskmanager["Portfolio Risk<br/>[risk_manager.py]"]
  node_riskengine["Pretrade Risk Engine<br/>[risk_engine.py]"]
  node_dropcopy["Drop Copy Reconciliation<br/>[drop_copy.py]"]
  node_algorithms["Execution Algorithms<br/>[algorithms.py]"]
  node_fix["FIX Engine<br/>[fix_engine.py]"]
  node_omsbridge["OMS Bridge<br/>[oms_bridge.py]"]
  node_rustoms["Rust Native OMS<br/>[lib.rs]"]
  node_referenceoms["Reference OMS<br/>[reference_oms.py]"]
end

subgraph group_platform["Platform Services"]
  node_transport["Message Transport<br/>[transport.py]"]
  node_channels["Typed Channels<br/>[channels.py]"]
  node_integration["System Integration<br/>[integration.py]"]
end

subgraph group_interfaces["User Interfaces"]
  node_gateway["FastAPI Gateway<br/>[main.py]"]
  node_web["Next.js Dashboard<br/>[index.tsx]"]
  node_streamlit["Research Dashboard<br/>[app.py]"]
end

node_user(("Researcher / Operator"))
node_externaldata(("Market Data Sources"))

node_user -->|"requests"| node_gateway
node_user -->|"views"| node_web
node_user -->|"explores"| node_streamlit
node_gateway -->|"resolves / fetches"| node_ingestion
node_gateway -->|"runs backtest"| node_backtest
node_externaldata -->|"supplies data"| node_ingestion
node_ingestion -->|"provides input"| node_features
node_ingestion -->|"provides input"| node_microfeatures
node_features -->|"builds predictors"| node_models
node_microfeatures -->|"builds predictors"| node_models
node_models -.->|"generates alpha"| node_strategies
node_strategies -->|"drives simulation"| node_backtest
node_backtest -->|"dispatches orders"| node_matching
node_matching -->|"submits orders"| node_orderbook
node_user -->|"configures portfolio"| node_optimizer
node_optimizer -.->|"risk assessment"| node_riskmanager
node_riskengine -.->|"pretrade gate"| node_omsbridge
node_omsbridge -->|"bridges FFI"| node_rustoms
node_omsbridge -->|"falls back to"| node_referenceoms
node_algorithms -.->|"routes execution"| node_fix
node_fix -.->|"interfaces OMS"| node_omsbridge
node_dropcopy -.->|"reconciles fills"| node_riskengine
node_integration -->|"creates transports"| node_transport
node_integration -->|"starts channels"| node_channels
node_channels -->|"publishes messages"| node_transport
node_integration -->|"connects database"| node_timeseries
node_integration -->|"configures stores"| node_featurestore
node_web -.->|"uses API"| node_gateway
node_pipeline -.->|"persists data"| node_timeseries
node_altdata -.->|"enriches research"| node_models

click node_gateway "https://github.com/pushkarkumarvats/omniquant/blob/main/src/api/main.py"
click node_web "https://github.com/pushkarkumarvats/omniquant/blob/main/frontend/src/pages/index.tsx"
click node_streamlit "https://github.com/pushkarkumarvats/omniquant/blob/main/src/dashboard/app.py"
click node_ingestion "https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/ingestion.py"
click node_connectors "https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/real_time_connectors.py"
click node_pipeline "https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/arrow_pipeline.py"
click node_timeseries "https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_platform/timeseries_db.py"
click node_features "https://github.com/pushkarkumarvats/omniquant/blob/main/src/feature_engineering/technical_features.py"
click node_microfeatures "https://github.com/pushkarkumarvats/omniquant/blob/main/src/feature_engineering/microstructure_features.py"
click node_featurestore "https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_platform/feature_store.py"
click node_altdata "https://github.com/pushkarkumarvats/omniquant/blob/main/src/research/alt_data.py"
click node_models "https://github.com/pushkarkumarvats/omniquant/blob/main/src/alpha_models/boosting_model.py"
click node_strategies "https://github.com/pushkarkumarvats/omniquant/tree/main/src/strategies"
click node_backtest "https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/event_simulator.py"
click node_matching "https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/matching_engine.py"
click node_orderbook "https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/orderbook.py"
click node_optimizer "https://github.com/pushkarkumarvats/omniquant/blob/main/src/portfolio/optimizer.py"
click node_riskmanager "https://github.com/pushkarkumarvats/omniquant/blob/main/src/portfolio/risk_manager.py"
click node_riskengine "https://github.com/pushkarkumarvats/omniquant/blob/main/src/risk_ops/risk_engine.py"
click node_dropcopy "https://github.com/pushkarkumarvats/omniquant/blob/main/src/risk_ops/drop_copy.py"
click node_algorithms "https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/algorithms.py"
click node_fix "https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/fix_protocol/fix_engine.py"
click node_omsbridge "https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/native_gateway/oms_bridge.py"
click node_rustoms "https://github.com/pushkarkumarvats/omniquant/blob/main/native/oms-core/src/lib.rs"
click node_referenceoms "https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/native_gateway/reference_oms.py"
click node_transport "https://github.com/pushkarkumarvats/omniquant/blob/main/src/messaging/transport.py"
click node_channels "https://github.com/pushkarkumarvats/omniquant/blob/main/src/messaging/channels.py"
click node_integration "https://github.com/pushkarkumarvats/omniquant/blob/main/src/integration.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_features,node_microfeatures,node_altdata,node_models,node_strategies toneBlue
class node_ingestion,node_connectors,node_pipeline,node_timeseries,node_featurestore toneAmber
class node_backtest,node_matching,node_orderbook,node_optimizer,node_riskmanager,node_riskengine,node_dropcopy,node_algorithms,node_fix,node_omsbridge,node_rustoms,node_referenceoms toneMint
class node_transport,node_channels,node_integration toneRose
class node_gateway,node_web,node_streamlit,node_user,node_externaldata toneIndigo
```

## Components

### Research & Alpha

- [Feature Engineering](https://github.com/pushkarkumarvats/omniquant/blob/main/src/feature_engineering/technical_features.py): `src/feature_engineering/technical_features.py`
- [Microstructure Features](https://github.com/pushkarkumarvats/omniquant/blob/main/src/feature_engineering/microstructure_features.py): `src/feature_engineering/microstructure_features.py`
- [Alternative Data](https://github.com/pushkarkumarvats/omniquant/blob/main/src/research/alt_data.py): `src/research/alt_data.py`
- [ML Alpha Models](https://github.com/pushkarkumarvats/omniquant/blob/main/src/alpha_models/boosting_model.py): `src/alpha_models/boosting_model.py`
- [Trading Strategies](https://github.com/pushkarkumarvats/omniquant/tree/main/src/strategies): `src/strategies`

### Market Data

- [Data Ingestion](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/ingestion.py): `src/data_pipeline/ingestion.py`
- [Realtime Connectors](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/real_time_connectors.py): `src/data_pipeline/real_time_connectors.py`
- [Data Processing](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_pipeline/arrow_pipeline.py): `src/data_pipeline/arrow_pipeline.py`
- [Timeseries Database](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_platform/timeseries_db.py): `src/data_platform/timeseries_db.py`
- [Feature Store](https://github.com/pushkarkumarvats/omniquant/blob/main/src/data_platform/feature_store.py): `src/data_platform/feature_store.py`

### Trading & Execution

- [Event Backtester](https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/event_simulator.py): `src/simulator/event_simulator.py`
- [Matching Engine](https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/matching_engine.py): `src/simulator/matching_engine.py`
- [Simulated Order Book](https://github.com/pushkarkumarvats/omniquant/blob/main/src/simulator/orderbook.py): `src/simulator/orderbook.py`
- [Portfolio Optimizer](https://github.com/pushkarkumarvats/omniquant/blob/main/src/portfolio/optimizer.py): `src/portfolio/optimizer.py`
- [Portfolio Risk](https://github.com/pushkarkumarvats/omniquant/blob/main/src/portfolio/risk_manager.py): `src/portfolio/risk_manager.py`
- [Pretrade Risk Engine](https://github.com/pushkarkumarvats/omniquant/blob/main/src/risk_ops/risk_engine.py): `src/risk_ops/risk_engine.py`
- [Drop Copy Reconciliation](https://github.com/pushkarkumarvats/omniquant/blob/main/src/risk_ops/drop_copy.py): `src/risk_ops/drop_copy.py`
- [Execution Algorithms](https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/algorithms.py): `src/execution/algorithms.py`
- [FIX Engine](https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/fix_protocol/fix_engine.py): `src/execution/fix_protocol/fix_engine.py`
- [OMS Bridge](https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/native_gateway/oms_bridge.py): `src/execution/native_gateway/oms_bridge.py`
- [Rust Native OMS](https://github.com/pushkarkumarvats/omniquant/blob/main/native/oms-core/src/lib.rs): `native/oms-core/src/lib.rs`
- [Reference OMS](https://github.com/pushkarkumarvats/omniquant/blob/main/src/execution/native_gateway/reference_oms.py): `src/execution/native_gateway/reference_oms.py`

### Platform Services

- [Message Transport](https://github.com/pushkarkumarvats/omniquant/blob/main/src/messaging/transport.py): `src/messaging/transport.py`
- [Typed Channels](https://github.com/pushkarkumarvats/omniquant/blob/main/src/messaging/channels.py): `src/messaging/channels.py`
- [System Integration](https://github.com/pushkarkumarvats/omniquant/blob/main/src/integration.py): `src/integration.py`

### User Interfaces

- [FastAPI Gateway](https://github.com/pushkarkumarvats/omniquant/blob/main/src/api/main.py): `src/api/main.py`
- [Next.js Dashboard](https://github.com/pushkarkumarvats/omniquant/blob/main/frontend/src/pages/index.tsx): `frontend/src/pages/index.tsx`
- [Research Dashboard](https://github.com/pushkarkumarvats/omniquant/blob/main/src/dashboard/app.py): `src/dashboard/app.py`

### Other components

- **Researcher / Operator**
- **Market Data Sources**

## Connections

- Researcher / Operator → FastAPI Gateway: requests (evidence: `src/api/main.py`)
- Researcher / Operator → Next.js Dashboard: views
- Researcher / Operator → Research Dashboard: explores (evidence: `src/dashboard/app.py`)
- FastAPI Gateway → Data Ingestion: resolves / fetches (evidence: `src/api/main.py`)
- FastAPI Gateway → Event Backtester: runs backtest (evidence: `src/api/main.py`)
- Market Data Sources → Data Ingestion: supplies data
- Data Ingestion → Feature Engineering: provides input (evidence: `notebooks/AlphaResearch_Example.py`)
- Data Ingestion → Microstructure Features: provides input (evidence: `notebooks/AlphaResearch_Example.py`)
- Feature Engineering → ML Alpha Models: builds predictors (evidence: `notebooks/AlphaResearch_Example.py`)
- Microstructure Features → ML Alpha Models: builds predictors (evidence: `notebooks/AlphaResearch_Example.py`)
- ML Alpha Models → Trading Strategies: generates alpha
- Trading Strategies → Event Backtester: drives simulation
- Event Backtester → Matching Engine: dispatches orders (evidence: `src/simulator/event_simulator.py`)
- Matching Engine → Simulated Order Book: submits orders (evidence: `src/simulator/matching_engine.py`)
- Researcher / Operator → Portfolio Optimizer: configures portfolio
- Portfolio Optimizer → Portfolio Risk: risk assessment
- Pretrade Risk Engine → OMS Bridge: pretrade gate
- OMS Bridge → Rust Native OMS: bridges FFI
- OMS Bridge → Reference OMS: falls back to (evidence: `src/execution/native_gateway/oms_bridge.py`)
- Execution Algorithms → FIX Engine: routes execution
- FIX Engine → OMS Bridge: interfaces OMS
- Drop Copy Reconciliation → Pretrade Risk Engine: reconciles fills
- System Integration → Message Transport: creates transports (evidence: `src/integration.py`)
- System Integration → Typed Channels: starts channels (evidence: `src/integration.py`)
- Typed Channels → Message Transport: publishes messages (evidence: `src/messaging/channels.py`)
- System Integration → Timeseries Database: connects database (evidence: `src/integration.py`)
- System Integration → Feature Store: configures stores (evidence: `src/integration.py`)
- Next.js Dashboard → FastAPI Gateway: uses API
- Data Processing → Timeseries Database: persists data
- Alternative Data → ML Alpha Models: enriches research
