# javagg/freeoq architecture

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

- Interactive diagram: https://gitdiagram.com/javagg/freeoq
- Repository: https://github.com/javagg/freeoq

## Overview

FreeOQ is an open-source implementation of the OpenQuant API and its supporting quantitative-trading framework. The visible workflow exposes framework data and orders through the OpenQuant API: data management handles market data, while order management maintains and routes orders through providers and execution servers. CSV import is a separate path for parsing records into data series. The tree also shows charting, FIX messaging, simulation, strategy, and portfolio capabilities. Source excerpts are selective, so links to unsampled subsystems are omitted rather than inferred.

Main entry points: [`src/openquant/OpenQuant.API/OpenQuant.cs`](https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.API/OpenQuant.cs) (OpenQuant API), [`src/freequant/FreeQuant.Execution/OrderManager.cs`](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Execution/OrderManager.cs) (Order manager), [`src/freequant/FreeQuant.Instruments/DataManager.cs`](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Instruments/DataManager.cs) (Data manager), [`src/freequant/FreeQuant.Data/IDataSeries.cs`](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Data/IDataSeries.cs) (Data series)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and framework"]
  node_api_surface["OpenQuant API<br/>[OpenQuant.cs]"]
  node_framework["Framework runtime<br/>[Framework.cs]"]
end

subgraph group_market["Market data"]
  node_data_manager["Data manager<br/>[DataManager.cs]"]
  node_series[("Data series<br/>[IDataSeries.cs]")]
  node_daily_data["Daily bars<br/>[Daily.cs]"]
  node_csv_import["CSV importer<br/>[Engine.cs]"]
  node_taq_import["TAQ importer<br/>[ImportEngine.cs]"]
  node_provider_manager["Provider manager<br/>[ProviderManager.cs]"]
end

subgraph group_trading["Trading and execution"]
  node_order_manager["Order manager<br/>[OrderManager.cs]"]
  node_order_store[("Order server<br/>[OrderDbServer.cs]")]
  node_execution_provider["Execution providers<br/>[ProviderManager.cs]"]
  node_simulation["Simulation execution"]
  node_trading_managers["Trading managers<br/>[FreeQuant.Trading]"]
end

subgraph group_interfaces["Visualization and protocols"]
  node_charting["Charting<br/>[Chart.cs]"]
  node_fix["FIX messaging<br/>[FreeQuant.FIX]"]
  node_dock_manager["Dock manager<br/>[DockManager.cs]"]
end

node_user(("API user"))

node_user -->|"uses"| node_api_surface
node_api_surface -->|"initializes"| node_order_manager
node_order_manager -->|"persists orders"| node_order_store
node_order_manager -->|"routes orders"| node_execution_provider
node_csv_import -->|"adds records"| node_series
node_data_manager -.->|"manages series"| node_series
node_api_surface -.->|"exposes data"| node_data_manager
node_provider_manager -->|"manages providers"| node_execution_provider

click node_api_surface "https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.API/OpenQuant.cs"
click node_framework "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant/Framework.cs"
click node_data_manager "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Instruments/DataManager.cs"
click node_series "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Data/IDataSeries.cs"
click node_daily_data "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Data/Daily.cs"
click node_csv_import "https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.Shared/Data/Import/CSV/Engine.cs"
click node_taq_import "https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.Shared/Data/Import/TAQ/ImportEngine.cs"
click node_provider_manager "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Providers/ProviderManager.cs"
click node_order_manager "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Execution/OrderManager.cs"
click node_order_store "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Execution/OrderDbServer.cs"
click node_execution_provider "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Providers/ProviderManager.cs"
click node_simulation "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Simulation/SimulationExecutionService.cs"
click node_trading_managers "https://github.com/javagg/freeoq/tree/master/src/freequant/FreeQuant.Trading"
click node_charting "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Charting/Chart.cs"
click node_fix "https://github.com/javagg/freeoq/tree/master/src/freequant/FreeQuant.FIX"
click node_dock_manager "https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Docking.Winforms/DockManager.cs"

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_api_surface,node_framework,node_user toneBlue
class node_data_manager,node_series,node_daily_data,node_csv_import,node_taq_import,node_provider_manager toneAmber
class node_order_manager,node_order_store,node_execution_provider,node_simulation,node_trading_managers toneMint
class node_charting,node_fix,node_dock_manager toneRose
```

## Components

### API and framework

- [OpenQuant API](https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.API/OpenQuant.cs): `src/openquant/OpenQuant.API/OpenQuant.cs`
- [Framework runtime](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant/Framework.cs): `src/freequant/FreeQuant/Framework.cs`

### Market data

- [Data manager](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Instruments/DataManager.cs): `src/freequant/FreeQuant.Instruments/DataManager.cs`
- [Data series](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Data/IDataSeries.cs): `src/freequant/FreeQuant.Data/IDataSeries.cs`
- [Daily bars](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Data/Daily.cs): `src/freequant/FreeQuant.Data/Daily.cs`
- [CSV importer](https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.Shared/Data/Import/CSV/Engine.cs): `src/openquant/OpenQuant.Shared/Data/Import/CSV/Engine.cs`
- [TAQ importer](https://github.com/javagg/freeoq/blob/master/src/openquant/OpenQuant.Shared/Data/Import/TAQ/ImportEngine.cs): `src/openquant/OpenQuant.Shared/Data/Import/TAQ/ImportEngine.cs`
- [Provider manager](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Providers/ProviderManager.cs): `src/freequant/FreeQuant.Providers/ProviderManager.cs`

### Trading and execution

- [Order manager](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Execution/OrderManager.cs): `src/freequant/FreeQuant.Execution/OrderManager.cs`
- [Order server](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Execution/OrderDbServer.cs): `src/freequant/FreeQuant.Execution/OrderDbServer.cs`
- [Execution providers](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Providers/ProviderManager.cs): `src/freequant/FreeQuant.Providers/ProviderManager.cs`
- [Simulation execution](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Simulation/SimulationExecutionService.cs): `src/freequant/FreeQuant.Simulation/SimulationExecutionService.cs`
- [Trading managers](https://github.com/javagg/freeoq/tree/master/src/freequant/FreeQuant.Trading): `src/freequant/FreeQuant.Trading`

### Visualization and protocols

- [Charting](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Charting/Chart.cs): `src/freequant/FreeQuant.Charting/Chart.cs`
- [FIX messaging](https://github.com/javagg/freeoq/tree/master/src/freequant/FreeQuant.FIX): `src/freequant/FreeQuant.FIX`
- [Dock manager](https://github.com/javagg/freeoq/blob/master/src/freequant/FreeQuant.Docking.Winforms/DockManager.cs): `src/freequant/FreeQuant.Docking.Winforms/DockManager.cs`

### Other components

- **API user**

## Connections

- API user → OpenQuant API: uses (evidence: `src/openquant/OpenQuant.API/OpenQuant.cs`)
- OpenQuant API → Order manager: initializes (evidence: `src/openquant/OpenQuant.API/OpenQuant.cs`)
- Order manager → Order server: persists orders (evidence: `src/freequant/FreeQuant.Execution/OrderManager.cs`)
- Order manager → Execution providers: routes orders (evidence: `src/freequant/FreeQuant.Execution/OrderManager.cs`)
- CSV importer → Data series: adds records (evidence: `src/openquant/OpenQuant.Shared/Data/Import/CSV/Engine.cs`)
- Data manager → Data series: manages series (evidence: `src/freequant/FreeQuant.Instruments/DataManager.cs`)
- OpenQuant API → Data manager: exposes data
- Provider manager → Execution providers: manages providers (evidence: `src/freequant/FreeQuant.Providers/ProviderManager.cs`)
