# amor71/liualgotrader architecture

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

- Interactive diagram: https://gitdiagram.com/amor71/liualgotrader
- Repository: https://github.com/amor71/liualgotrader

## Overview

LiuAlgoTrader is a multi-process algorithmic trading platform for US equities and crypto, with live trading, backtesting, optimization, and session analytics. The main live path is market data into the producer/consumer runtime, where scanners and strategies inform orders sent through a broker adapter; portfolio and trade state is persisted for later analysis. Backtesting reuses strategy and trading abstractions, while analytics and optimization provide separate research branches. Some components are documented or indexed but their wiring was not excerpted, so those links are marked unverified.

Main entry points: [`liualgotrader/consumer.py`](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/consumer.py) (Consumer), [`liualgotrader/enhanced_backtest.py`](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/enhanced_backtest.py) (Backtest engine), [`liualgotrader/common/data_loader.py`](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/data_loader.py) (Historical data loader), [`liualgotrader/analytics/analysis.py`](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/analytics/analysis.py) (Session analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Trading runtime"]
  node_cli["CLI entrypoints"]
  node_producer["Producer<br/>[producer.py]"]
  node_consumer["Consumer<br/>[consumer.py]"]
end

subgraph group_market["Market data"]
  node_feed{{"Market data APIs"}}
  node_loader["Historical data loader<br/>[data_loader.py]"]
  node_adapters["Data connectors"]
end

subgraph group_domain["Trading domain"]
  node_scanner["Scanners"]
  node_strategy["Strategies<br/>[base.py]"]
  node_trading_data["Trading state<br/>[trading_data.py]"]
  node_trader_factory["Trader factory<br/>[trader_factory.py]"]
  node_trader["Broker adapters"]
end

subgraph group_research["Backtest and research"]
  node_backtest["Backtest engine"]
  node_optimizer["Optimizer<br/>[optimizer.py]"]
  node_analytics["Session analytics<br/>[analysis.py]"]
  node_consolidate["Analytics consolidation<br/>[consolidate.py]"]
  node_indicators["Financial calculations"]
end

subgraph group_state["Persistence"]
  node_portfolio["Portfolio and accounts<br/>[portfolio.py]"]
  node_records["Trade and run records<br/>[new_trades.py]"]
  node_database[("PostgreSQL<br/>[database.py]")]
end

node_operator(("Operator"))
node_exchange{{"Broker APIs"}}

node_operator -->|"starts"| node_cli
node_cli -.->|"runs trading"| node_consumer
node_cli -.->|"runs backtest"| node_backtest
node_producer -.->|"queues events"| node_consumer
node_feed -->|"provides feeds"| node_adapters
node_adapters -->|"supplies data"| node_loader
node_loader -->|"loads symbols"| node_scanner
node_consumer -.->|"dispatches scans"| node_scanner
node_consumer -->|"runs strategies"| node_strategy
node_strategy -->|"reads data"| node_loader
node_consumer -->|"updates state"| node_trading_data
node_consumer -->|"creates trader"| node_trader_factory
node_trader_factory -->|"selects adapter"| node_trader
node_trader -->|"submits orders"| node_exchange
node_consumer -->|"uses portfolio"| node_portfolio
node_consumer -->|"saves trades"| node_records
node_portfolio -->|"reads and writes"| node_database
node_records -.->|"persists records"| node_database
node_backtest -->|"loads history"| node_loader
node_backtest -->|"uses scanners"| node_scanner
node_backtest -->|"runs strategies"| node_strategy
node_backtest -->|"creates trader"| node_trader_factory
node_optimizer -->|"optimizes runs"| node_backtest
node_analytics -->|"queries sessions"| node_database
node_analytics -->|"loads portfolio"| node_portfolio
node_analytics -->|"loads returns data"| node_loader
node_consolidate -->|"uses analysis"| node_analytics
node_strategy -.->|"uses calculations"| node_indicators

click node_cli "https://github.com/amor71/liualgotrader/tree/master/liualgotrader/scripts"
click node_producer "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/producer.py"
click node_consumer "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/consumer.py"
click node_loader "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/data_loader.py"
click node_adapters "https://github.com/amor71/liualgotrader/tree/master/liualgotrader/data"
click node_scanner "https://github.com/amor71/liualgotrader/tree/master/liualgotrader/scanners"
click node_strategy "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/strategies/base.py"
click node_trading_data "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/trading_data.py"
click node_trader_factory "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/trading/trader_factory.py"
click node_trader "https://github.com/amor71/liualgotrader/tree/master/liualgotrader/trading"
click node_portfolio "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/models/portfolio.py"
click node_records "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/models/new_trades.py"
click node_database "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/database.py"
click node_backtest "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/enhanced_backtest.py"
click node_optimizer "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/backtesting/optimizer.py"
click node_analytics "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/analytics/analysis.py"
click node_consolidate "https://github.com/amor71/liualgotrader/blob/master/liualgotrader/analytics/consolidate.py"
click node_indicators "https://github.com/amor71/liualgotrader/tree/master/liualgotrader/fincalcs"

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_cli,node_producer,node_consumer toneBlue
class node_feed,node_loader,node_adapters toneAmber
class node_scanner,node_strategy,node_trading_data,node_trader_factory,node_trader,node_exchange toneMint
class node_backtest,node_optimizer,node_analytics,node_consolidate,node_indicators toneRose
class node_portfolio,node_records,node_database,node_operator toneIndigo
```

## Components

### Trading runtime

- [CLI entrypoints](https://github.com/amor71/liualgotrader/tree/master/liualgotrader/scripts): `liualgotrader/scripts`
- [Producer](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/producer.py): `liualgotrader/producer.py`
- [Consumer](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/consumer.py): `liualgotrader/consumer.py`

### Market data

- **Market data APIs**
- [Historical data loader](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/data_loader.py): `liualgotrader/common/data_loader.py`
- [Data connectors](https://github.com/amor71/liualgotrader/tree/master/liualgotrader/data): `liualgotrader/data`

### Trading domain

- [Scanners](https://github.com/amor71/liualgotrader/tree/master/liualgotrader/scanners): `liualgotrader/scanners`
- [Strategies](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/strategies/base.py): `liualgotrader/strategies/base.py`
- [Trading state](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/trading_data.py): `liualgotrader/common/trading_data.py`
- [Trader factory](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/trading/trader_factory.py): `liualgotrader/trading/trader_factory.py`
- [Broker adapters](https://github.com/amor71/liualgotrader/tree/master/liualgotrader/trading): `liualgotrader/trading`

### Backtest and research

- [Backtest engine](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/enhanced_backtest.py): `liualgotrader/enhanced_backtest.py`
- [Optimizer](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/backtesting/optimizer.py): `liualgotrader/backtesting/optimizer.py`
- [Session analytics](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/analytics/analysis.py): `liualgotrader/analytics/analysis.py`
- [Analytics consolidation](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/analytics/consolidate.py): `liualgotrader/analytics/consolidate.py`
- [Financial calculations](https://github.com/amor71/liualgotrader/tree/master/liualgotrader/fincalcs): `liualgotrader/fincalcs`

### Persistence

- [Portfolio and accounts](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/models/portfolio.py): `liualgotrader/models/portfolio.py`
- [Trade and run records](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/models/new_trades.py): `liualgotrader/models/new_trades.py`
- [PostgreSQL](https://github.com/amor71/liualgotrader/blob/master/liualgotrader/common/database.py): `liualgotrader/common/database.py`

### Other components

- **Operator**
- **Broker APIs**

## Connections

- Operator → CLI entrypoints: starts
- CLI entrypoints → Consumer: runs trading
- CLI entrypoints → Backtest engine: runs backtest
- Producer → Consumer: queues events
- Market data APIs → Data connectors: provides feeds
- Data connectors → Historical data loader: supplies data (evidence: `liualgotrader/common/data_loader.py`)
- Historical data loader → Scanners: loads symbols (evidence: `liualgotrader/scanners/base.py`)
- Consumer → Scanners: dispatches scans
- Consumer → Strategies: runs strategies (evidence: `liualgotrader/consumer.py`)
- Strategies → Historical data loader: reads data (evidence: `liualgotrader/strategies/base.py`)
- Consumer → Trading state: updates state (evidence: `liualgotrader/consumer.py`)
- Consumer → Trader factory: creates trader (evidence: `liualgotrader/consumer.py`)
- Trader factory → Broker adapters: selects adapter (evidence: `liualgotrader/trading/trader_factory.py`)
- Broker adapters → Broker APIs: submits orders
- Consumer → Portfolio and accounts: uses portfolio (evidence: `liualgotrader/consumer.py`)
- Consumer → Trade and run records: saves trades (evidence: `liualgotrader/consumer.py`)
- Portfolio and accounts → PostgreSQL: reads and writes (evidence: `liualgotrader/models/portfolio.py`)
- Trade and run records → PostgreSQL: persists records
- Backtest engine → Historical data loader: loads history (evidence: `liualgotrader/enhanced_backtest.py`)
- Backtest engine → Scanners: uses scanners (evidence: `liualgotrader/enhanced_backtest.py`)
- Backtest engine → Strategies: runs strategies (evidence: `liualgotrader/enhanced_backtest.py`)
- Backtest engine → Trader factory: creates trader (evidence: `liualgotrader/enhanced_backtest.py`)
- Optimizer → Backtest engine: optimizes runs (evidence: `liualgotrader/backtesting/optimizer.py`)
- Session analytics → PostgreSQL: queries sessions (evidence: `liualgotrader/analytics/analysis.py`)
- Session analytics → Portfolio and accounts: loads portfolio (evidence: `liualgotrader/analytics/analysis.py`)
- Session analytics → Historical data loader: loads returns data (evidence: `liualgotrader/analytics/analysis.py`)
- Analytics consolidation → Session analytics: uses analysis (evidence: `liualgotrader/analytics/consolidate.py`)
- Strategies → Financial calculations: uses calculations
