Skip to content

System Architecture

EasyQuant is built around the event-driven backtesting library eqlib. This page explains its overall architecture and what each module does.


Overall Architecture

┌────────────────────────────────────────────────────────────────────────────┐
│                                 User Layer                                 │
│  Python Scripts / Jupyter Notebook                                         │
└──────────────────────────────────────┬─────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│  Strategy API                                                              │
│  initialize(context) / handle_data(ctx, data)                              │
│  run_daily(func) / order*()                                                │
└──────────────────────────────────────┬─────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│  Backtest Engine (eqlib/engine.py)                                         │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐                            │
│  │ Scheduler  │  │   Order    │  │ Portfolio  │                            │
│  │ run_daily  │  │ T+1 check  │  │ Pos / Cash │                            │
│  │ run_weekly │  │ 100-lot    │  │   Fees     │                            │
│  │            │  │ Price-limit│  │            │                            │
│  │            │  │ Suspension │  │            │                            │
│  │            │  │  Delisting │  │            │                            │
│  └────────────┘  └────────────┘  └────────────┘                            │
└──────────────┬──────────────────────────────────────────────┬──────────────┘
               │                                              │
               ▼                                              ▼
┌────────────────────────┐  ┌────────────────────────────────────────────────┐
│  Data Layer            │  │  Analysis & Reporting Layer                    │
│  eqlib/data.py         │  │  eqlib/attribution.py  (Brinson / Factor)      │
│  ┌─────────────┐       │  │  eqlib/report.py       (HTML / PNG / MD / JSON)│
│  │ AKShare API │       │  │  eqlib/scientific/     (overfitting / bias)    │
│  │ Local CSV   │       │  └────────────────────────────────────────────────┘
│  │ Cache Mgmt  │       │
│  └─────────────┘       │
└────────────────────────┘

Module Responsibilities

Module File Responsibility
Backtest Engine eqlib/engine.py Event loop, scheduling, order matching (incl. price-limit / suspension / delisting rules), portfolio management
Data API eqlib/data.py Historical quotes, real-time snapshots, fundamentals, A-share specific data
Trade Execution eqlib/trade.py Order placement, T+1 checks, 100-lot rounding, commission calculation
Performance Analysis eqlib/attribution.py Sharpe, Alpha/Beta, Brinson attribution, factor analysis
Report Generation eqlib/report.py Interactive HTML reports, PNG charts, Markdown, JSON
Stock Selection eqlib/selection.py TopNSelector, MultiFactorSelector, periodic rebalancing
Utilities eqlib/utils/ 40+ technical indicators, statistical analysis, money management
Notifications eqlib/notification.py DingTalk / Feishu webhook trade signals
Scientific Validation eqlib/scientific/ Overfitting detection, statistical confidence, bias detection

Data Flow

User-defined strategy → initialize() → run_daily() registers callbacks
                                              │
                                              ▼
Each trading day: before_trading_start → handle_data / market_open → after_trading_end
                                              │
                                              ├── Call data API for quotes
                                              ├── Compute signals
                                              ├── Call order*() to place orders (queued)
                                              │
                                              ▼
                              Next trading day open: orders matched (avoids look-ahead bias)
                              ├─ Price-limit interception: orders touching the limit are cancelled same-day
                              ├─ Suspension: orders for a security with no bar are cancelled same-day (recorded in cancel_reason)
                              └─ Delisting: no quote for 30 trading days → forced liquidation (DELIST_LIQUIDATE)
                                              │
                                              ▼
Backtest complete → analyze_returns() → generate_report()