# zduan001/low-latency architecture

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

- Interactive diagram: https://gitdiagram.com/zduan001/low-latency
- Repository: https://github.com/zduan001/low-latency
- Video tour (about a minute): https://gitdiagram.com/zduan001/low-latency/video

## Overview

This repository is a chapter-by-chapter implementation of a low-latency trading system. Its principal workflow is market-data consumption by a trading engine and strategies, followed by order submission to an exchange, matching, and publication of responses and market updates. The graph uses Chapter12 as the latest listed implementation; shared design stages from earlier chapters are represented there rather than duplicated. Source evidence is limited: the README gives no architecture details, and several subsystem implementations are unsampled, so their connections are omitted unless the excerpts or source index support them.

Main entry points: [`Chapter12/exchange/matcher/matching_engine.h`](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/matcher/matching_engine.h) (Matching engine), [`Chapter12/trading/strategy/trade_engine.cpp`](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/trade_engine.cpp) (Trade engine), [`Chapter12/trading/strategy/market_maker.cpp`](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/market_maker.cpp) (Market maker), [`Chapter12/trading/strategy/liquidity_taker.cpp`](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/liquidity_taker.cpp) (Liquidity taker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_trading["Trading system"]
  node_trade_engine["Trade engine<br/>[trade_engine.cpp]"]
  node_market_maker["Market maker<br/>[market_maker.cpp]"]
  node_liquidity_taker["Liquidity taker"]
  node_feature_engine["Feature engine<br/>[feature_engine.h]"]
  node_risk_manager["Risk manager<br/>[risk_manager.h]"]
  node_order_manager["Order manager<br/>[order_manager.cpp]"]
  node_position_keeper["Position keeper<br/>[position_keeper.h]"]
  node_trading_book["Trading order book"]
  node_order_gateway["Order gateway"]
end

subgraph group_exchange["Exchange"]
  node_order_server["Order server"]
  node_order_payloads["Order messages<br/>[client_request.h]"]
  node_response_payloads["Response messages<br/>[client_response.h]"]
end

subgraph group_market_data["Market data"]
  node_md_consumer["Market data consumer"]
  node_md_publisher["Market data publisher"]
  node_market_updates["Market updates<br/>[market_update.h]"]
end

subgraph group_matching["Matching"]
  node_matching_engine["Matching engine<br/>[matching_engine.h]"]
  node_exchange_book["Exchange order book<br/>[me_order_book.h]"]
end

subgraph group_runtime["Runtime utilities"]
  node_lf_queue["Lock-free queue<br/>[lf_queue.h]"]
  node_thread_utils["Thread utilities<br/>[thread_utils.h]"]
end

node_strategy_actor(("Strategy user"))

node_trade_engine -->|"uses"| node_trading_book
node_trade_engine -->|"uses"| node_feature_engine
node_trade_engine -->|"uses"| node_position_keeper
node_trade_engine -->|"uses"| node_order_manager
node_trade_engine -->|"uses"| node_risk_manager
node_trade_engine -->|"uses"| node_market_maker
node_trade_engine -->|"uses"| node_liquidity_taker
node_matching_engine -->|"dispatches orders"| node_exchange_book
node_matching_engine -->|"reads requests"| node_order_payloads
node_matching_engine -->|"writes responses"| node_response_payloads
node_matching_engine -->|"writes updates"| node_market_updates
node_matching_engine -->|"receives requests"| node_order_server
node_matching_engine -->|"sends updates"| node_md_publisher
node_matching_engine -->|"uses queues"| node_lf_queue
node_matching_engine -->|"uses threading"| node_thread_utils

click node_trade_engine "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/trade_engine.cpp"
click node_market_maker "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/market_maker.cpp"
click node_liquidity_taker "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/liquidity_taker.cpp"
click node_feature_engine "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/feature_engine.h"
click node_risk_manager "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/risk_manager.h"
click node_order_manager "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/order_manager.cpp"
click node_position_keeper "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/position_keeper.h"
click node_trading_book "https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/market_order_book.h"
click node_order_gateway "https://github.com/zduan001/low-latency/tree/main/Chapter12/trading/order_gw"
click node_md_consumer "https://github.com/zduan001/low-latency/tree/main/Chapter12/trading/market_data"
click node_md_publisher "https://github.com/zduan001/low-latency/tree/main/Chapter12/exchange/market_data"
click node_order_server "https://github.com/zduan001/low-latency/tree/main/Chapter12/exchange/order_server"
click node_matching_engine "https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/matcher/matching_engine.h"
click node_exchange_book "https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/matcher/me_order_book.h"
click node_order_payloads "https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/order_server/client_request.h"
click node_response_payloads "https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/order_server/client_response.h"
click node_market_updates "https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/market_data/market_update.h"
click node_lf_queue "https://github.com/zduan001/low-latency/blob/main/Chapter12/common/lf_queue.h"
click node_thread_utils "https://github.com/zduan001/low-latency/blob/main/Chapter12/common/thread_utils.h"

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_trade_engine,node_market_maker,node_liquidity_taker,node_feature_engine,node_risk_manager,node_order_manager,node_position_keeper,node_trading_book,node_order_gateway,node_strategy_actor toneBlue
class node_order_server,node_order_payloads,node_response_payloads toneAmber
class node_md_consumer,node_md_publisher,node_market_updates toneMint
class node_matching_engine,node_exchange_book toneRose
class node_lf_queue,node_thread_utils toneIndigo
```

## Components

### Trading system

- [Trade engine](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/trade_engine.cpp): `Chapter12/trading/strategy/trade_engine.cpp`
- [Market maker](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/market_maker.cpp): `Chapter12/trading/strategy/market_maker.cpp`
- [Liquidity taker](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/liquidity_taker.cpp): `Chapter12/trading/strategy/liquidity_taker.cpp`
- [Feature engine](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/feature_engine.h): `Chapter12/trading/strategy/feature_engine.h`
- [Risk manager](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/risk_manager.h): `Chapter12/trading/strategy/risk_manager.h`
- [Order manager](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/order_manager.cpp): `Chapter12/trading/strategy/order_manager.cpp`
- [Position keeper](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/position_keeper.h): `Chapter12/trading/strategy/position_keeper.h`
- [Trading order book](https://github.com/zduan001/low-latency/blob/main/Chapter12/trading/strategy/market_order_book.h): `Chapter12/trading/strategy/market_order_book.h`
- [Order gateway](https://github.com/zduan001/low-latency/tree/main/Chapter12/trading/order_gw): `Chapter12/trading/order_gw`

### Exchange

- [Order server](https://github.com/zduan001/low-latency/tree/main/Chapter12/exchange/order_server): `Chapter12/exchange/order_server`
- [Order messages](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/order_server/client_request.h): `Chapter12/exchange/order_server/client_request.h`
- [Response messages](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/order_server/client_response.h): `Chapter12/exchange/order_server/client_response.h`

### Market data

- [Market data consumer](https://github.com/zduan001/low-latency/tree/main/Chapter12/trading/market_data): `Chapter12/trading/market_data`
- [Market data publisher](https://github.com/zduan001/low-latency/tree/main/Chapter12/exchange/market_data): `Chapter12/exchange/market_data`
- [Market updates](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/market_data/market_update.h): `Chapter12/exchange/market_data/market_update.h`

### Matching

- [Matching engine](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/matcher/matching_engine.h): `Chapter12/exchange/matcher/matching_engine.h`
- [Exchange order book](https://github.com/zduan001/low-latency/blob/main/Chapter12/exchange/matcher/me_order_book.h): `Chapter12/exchange/matcher/me_order_book.h`

### Runtime utilities

- [Lock-free queue](https://github.com/zduan001/low-latency/blob/main/Chapter12/common/lf_queue.h): `Chapter12/common/lf_queue.h`
- [Thread utilities](https://github.com/zduan001/low-latency/blob/main/Chapter12/common/thread_utils.h): `Chapter12/common/thread_utils.h`

### Other components

- **Strategy user**

## Connections

- Trade engine → Trading order book: uses
- Trade engine → Feature engine: uses
- Trade engine → Position keeper: uses
- Trade engine → Order manager: uses
- Trade engine → Risk manager: uses
- Trade engine → Market maker: uses
- Trade engine → Liquidity taker: uses
- Matching engine → Exchange order book: dispatches orders (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Order messages: reads requests (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Response messages: writes responses (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Market updates: writes updates (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Order server: receives requests (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Market data publisher: sends updates (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Lock-free queue: uses queues (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
- Matching engine → Thread utilities: uses threading (evidence: `Chapter12/exchange/matcher/matching_engine.h`)
