ATE - Autonomous Trading Engine (ATE)

Hệ thống Giao Dịch Tự Động cho XAUUSD (Vàng) | Phiên bản 2.4

---

Tổng Quan

ATE là nền tảng giao dịch tự động hoàn chỉnh kết hợp phân tích định lượng thời gian thực, trí tuệ nhân tạo đa mô hình và kiểm soát rủi ro fail-closed, vận hành trên MetaTrader 5 với giao diện Bloomberg Terminal:

• Dữ liệu thời gian thực MT5 (XAUUSD, khung M1 -> D1)
• Multi-AI Provider Engine: Mặc định chạy miễn phí trên OpenCode Zen Free Pool (không cần API Key), tự động xoay vòng và failover sang các provider thương mại (Gemini, OpenAI, DeepSeek, Claude...) khi cần
• 5 Phương Pháp Giao Dịch: Price Action, SMC, ICT, Sniper, Ultra Confluence
• 72+ Mẫu hình thị trường được phát hiện tự động (FVG, Order Block, BOS, CHoCH, Tick, Breaker...)
• RiskGate 15 điểm - chặn lệnh theo nguyên tắc Fail-Closed trước khi đến MT5
• Web Dashboard toàn diện (Next.js + FastAPI + WebSocket)

Kiến Trúc Tổng Quan

MT5 REAL DATA (XAUUSDm)
        |
        v
MARKET_DATA_ENGINE
        |
        v
CANDLE_NORMALIZER
        |
        v
SHARED_SWING_ENGINE  <-- NGUỒN DUY NHẤT (ONE CANONICAL SOURCE)
        |
        v
MARKET_STRUCTURE_ENGINE
        |
        +---------------------------------------------------+
        |               PATTERN DETECTION ENGINES           |
        |    Price Action | SMB | ICT | Sniper | Ultra      |
        +---------------------------------------------------+
        |
        v
MARKUP_OBJECTS (JSON)
        |
        +--------> FRONTEND CHART (SVG + lightweight-charts)
        |
        v
AI CONTEXT BUILDER
        |
        v
AI_ENGINE (Multi-AI Failover Router)
        |
        v
RISK_ENGINE (Fail-Closed RiskGate)
        |
        v
MT5 EXECUTION (qua MQL5 EA - đơn vị thực thi duy nhất)

5 Phương Pháp Giao Dịch

1. PRICE ACTION (25 khái niệm)

Xu hướng, Swing HH/HL/LH/LL, Hỗ trợ/Kháng cự, Trendline, Kênh giá, Range, Breakout, Pullback, Retest, Fake Breakout, 14 mẫu hình nến (Pin Bar, Engulfing, Doji...).

2. SMC - Smart Money Concepts (26 khái niệm)

Market Structure (BOS, CHoCH, MSS), Order Block, FVG/IFVG, Liquidity Sweep, Equal Highs/Lows, Breaker/Mitigation/Rejection Block, Premium/Discount, Supply/Demand.

3. ICT - Inner Circle Trader (26 khái niệm)

OTE (Fibonacci 62-79%), PD Array, Kill Zones, PDH/PDL, Weekly/Monthly High/Low, Turtle Soup, Judas Swing, SMT Divergence, AMD/PO3, Silver Bullet, Unicorn Model.

4. SNIPER (chứng khoán chỉ báo)

EMA 9/21 Ribbon, VWAP, ADX(14), RSI(14), MACD - hệ thống chấm điểm 7 yếu tố, vào lệnh khi giá retest ribbon/VWAP với xác nhận động lượng.

5. ULTRA CONFLUENCE (Matrix 5 lớp)

Layer 1: Market Structure (BOS, CHoCH, Swing)
Layer 2: Supply/Demand (OB, FVG, Liquidity)
Layer 3: Dynamic (EMA, VWAP, Pivot)
Layer 4: Momentum (RSI, MACD, ADX, Volume)
Layer 5: Time/News (Session, Killzone, News impact)

Trọng số: Structure 25% + Zone 25% + Indicator 20% + Momentum 15% + Time 15%. Setup >= 85% là QUALIFIED, 70-84% là CONSIDER.

Cấu Trúc Thư Mục

tradeAI/
+-- README.md                       # Giới thiệu
+-- LICENSE                         # Giấy phép MIT
+-- MARKET_ANALYSIS_SPEC.md         # Đặc tả Market Analysis Engine
+-- dashboard/                      # Python FastAPI Backend
|   +-- server.py                   # FastAPI + AI decision loop
|   +-- detectors.py                # Pattern lõi (FVG, OB, BOS, Swing)
|   +-- advanced_detectors.py       # Pattern nâng cao (ICT, PA)
|   +-- chart_markup.py             # Markup builder cho chart
|   +-- signal_engines.py           # Sinh tín hiệu 5 phương pháp
|   +-- strategy_core.py            # Logic giao dịch lõi
|   +-- risk_gate.py                # Lớp lọc rủi ro 15 điểm (fail-closed)
|   +-- risk_profiles.py            # Hồ sơ rủi ro theo symbol
|   +-- command_store.py            # Sổ cái lệnh - SQLite WAL (idempotent)
|   +-- performance.py              # KPI & Equity curve
|   +-- ws_hub.py                   # WebSocket hub (~1s)
|   +-- logging_config.py           # Logger JSON có cấu trúc
|   +-- tests/test_market_analysis.py
+-- MQL5/                          # MT5 Expert Advisor
|   +-- Experts/tradeAI/ATE_XAUUSD.mq5
+-- web/                           # Next.js Frontend
    +-- app/page.tsx                # Dashboard chính
    +-- app/components/TradingChart.tsx   # lightweight-charts
    +-- app/components/CandleChart.tsx    # SVG chart
    +-- app/components/ControlCenter.tsx  # Điều khiển trang
    +-- lib/api.ts                  # API client

Khởi Động Nhanh

Backend

cd dashboard
pip install -r requirements.txt
python server.py

Frontend

cd web
npm install
npm run dev

MT5 EA

1. Copy MQL5/Experts/tradeAI/ATE_XAUUSD.mq5 vào thư mục experts của MT5.
2. Biên dịch và attach vào chart XAUUSD.
3. Cấu hình tham số trong EA settings (symbol, magic, token bridge).

Xem hướng dẫn chi tiết tại docs/OPERATION_GUIDE.md.

Cấu Hình Môi Trường (.env)

Nguồn chuẩn duy nhất: ENVIRONMENT_CONFIG.md (mirror: docs/ENVIRONMENT_CONFIG.md).

Mỗi thành phần đọc file .env riêng (tất cả đều không commit — xem .env.example):

Thành phần	File env	Bắt buộc tối thiểu
Backend (server.py)	dashboard/.env	ADMIN_LOGIN/PASSWORD, QUANTAI_BRIDGE_TOKEN
Frontend (Next.js)	web/.env (+ .env.local)	ATE_BACKEND_URL, JWT_SECRET, Firebase
Docker/Cloudlocal	Cloudlocal/.env	QUANTAI_BRIDGE_TOKEN, ATE_EXECUTION_MODE
EA (MT5)	input InpApiUrl + InpBridgeToken	URL backend + token (khớp QUANTAI_BRIDGE_TOKEN)

# Bắt đầu nhanh:
cp .env.example .env                  # root (tham chiếu)
cp dashboard/.env.example dashboard/.env
cp web/.env.example web/.env
cp Cloudlocal/.env.template Cloudlocal/.env

3 biến phải ĐỒNG BỘ giữa mọi file: QUANTAI_BRIDGE_TOKEN (EA + backend + web proxy), ATE_EXECUTION_MODE (DEMO/LIVE), ATE_EXECUTION_SYMBOL (XAUUSDm). Khi chạy LIVE phải đọc kỹ Security Checklist trong ENVIRONMENT_CONFIG.md (đổi token, JWT, admin password) — hệ thống fail-closed: mọi lệnh phải qua EA thật.

API Endpoints Chính

Endpoint	Method	Mô tả
/api/status	GET	Trạng thái hệ thống tổng hợp
/api/market	GET	Dữ liệu nến + chỉ báo + markup
/api/control-center/status	GET	Trạng thái vận hành
/api/control-center/mode	POST	Đổi mode (DEMO/LIVE/DISABLED)
/api/control-center/kill-switch	POST	Công tắc khẩn
/api/copilot/chat	POST	Trò chuyện AI Copilot
/api/news/analyze	POST	Phân tích tin tức kinh tế
/api/v1/bridge/commands/claim	POST	EA nhận lệnh (Bearer Token)
/api/v1/telemetry	POST	EA gửi telemetry mỗi 1s
/ws/stream	WS	Broadcast telemetry thời gian thực

Đặc tả đầy đủ tại docs/API_SPEC.md.

Kiểm Thử

cd dashboard
python -m pytest tests/ -v   # 67+ test (bao gồm bridge protocol, control center, risk gate)

Tài Liệu

Toàn bộ tài liệu dự án nằm trong docs/:

• Mục lục tài liệu
• Cấu hình môi trường (canonical)
• Tính năng
• Kiến trúc
• AI Pipeline & Multi-AI Engine
• 5 Phương pháp giao dịch
• Giao thức MT5
• Cơ sở dữ liệu
• Rủi ro & Mối đe dọa
• Vận hành

Bản Quyền & Giấy Phép

• Copyright (c) 2024-2026 Nguyễn Quang Tú (QTusdev) - https://github.com/qtu11
• Released under the MIT License: LICENSE
• Chi tiết: docs/COPYRIGHT.md

Cảnh báo rủi ro: Giao dịch tiền mã hóa/ngoại hối tiềm ẩn rủi ro tổn thất vốn lớn. Hệ thống chỉ nên vận hành ở chế độ DEMO cho đến khi được kiểm chứng kỹ lưỡng.