multi-agent-quant

# Multi-Agent LLM Quantitative Trading System

A multi-agent quantitative trading system that uses four independent Large Language Models (GPT, DeepSeek, DeepSeek, DeepSeek) as research analysts, fuses their signals via weighted ensemble voting, and executes trades on a MetaTrader 5 demo account through a dedicated trading department.

## Architecture

```
                    RESEARCH DEPARTMENT
  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
  │   GPT   │ │ DeepSeek  │ │ DeepSeek  │ │DeepSeek │
  │  (CLI)  │ │  (CLI)  │ │  (CLI)  │ │  (API)  │
  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘
       └───────────┴──────────┴───────────┘
                       │
              ┌────────▼────────┐
              │  Fusion Engine  │  4-model weighted voting
              │  (Ensemble)     │  + regime agreement check
              └────────┬────────┘
                       │
                TRADING DEPARTMENT
              ┌────────▼────────┐
              │ Trading Agent   │  DeepSeek + MT5 tool access
              │ (Order Sizing)  │  EXECUTE / REJECT / MODIFY
              └────────┬────────┘
                       │
              ┌────────▼────────┐
              │  Risk Guards    │  Trade → Daily → Account
              │  (3 Layers)     │  50% max drawdown hard stop
              └────────┬────────┘
                       │
              ┌────────▼────────┐
              │  MT5 Executor   │  Demo account
              └─────────────────┘
```

### Two-Department Design

| Department | Role | Models | Access |
|---|---|---|---|
| **Research** | Market analysis, direction, regime detection | GPT, DeepSeek, DeepSeek, DeepSeek | Read-only market snapshots |
| **Trading** | Order sizing, margin checks, execution decisions | DeepSeek (dedicated) | Full MT5 API (symbol info, account, margin calc) |

Research agents focus purely on market direction without needing to know contract specifications. The trading agent queries real-time symbol specs and account state to produce valid, exe