# AgentFxTrading

> Autonomous AI Forex & Multi-Asset Trading System with Dual Strategy Engines, cTrader C# integration, FastAPI Python Server, and Multi-LLM Reasoning (DeepSeek, Claude, OpenAI, Qwen, Gemini).

AgentFxTrading combines quantitative technical indicators with state-of-the-art Large Language Model (LLM) reasoning to autonomously trade Forex, Metals (XAUUSD), Indices (US30, USTEC, DE40), and Crypto (BTC, ETH, SOL). It provides dual-mode Demo/Real isolation, institutional 8-layer risk guardrails, cycle cost gating saving 80-90% API tokens, and a real-time dark cTrader-themed WebUI.

- **GitHub Repository**: https://github.com/kienphan/AgentFxTrading
- **License**: Open Source (MIT)
- **Primary Tech Stack**: Python 3.9+, FastAPI, cTrader / C#, SQLite, WebSocket, Docker
- **Supported Brokers**: IC Markets cTrader, Pepperstone, Spotware cTrader compatible brokers
- **Supported AI Providers**: DeepSeek, Qwen, Claude, OpenAI, Gemini, Local Ollama

## Core Capabilities

- **Dual Strategy Engines**:
  - `AiAgentBot`: Trend Momentum Signal (TMS - Heikin Ashi + TDI + Stochastic) with Opening Range Breakout (ORB) and Kaufman Efficiency Regimes (KER).
  - `AsianRangeJudasSweepBot`: ICT Smart Money Concepts (SMC) tracking liquidity sweeps of Asian Session High/Low (00:00–06:00 UTC) during London (07:00–10:00 UTC) and NY (12:30–16:00 UTC) Killzones with Order Block & FVG confirmation.
- **Institutional 8-Layer Risk Shield**:
  - Position Memory (Tick-by-tick MFE/MAE tracking)
  - Auto Breakeven (+0.1x ATR offset at >= 0.8x ATR profit)
  - Trailing Stop (Dynamic SL at 1.2x ATR trailing by 0.7x ATR)
  - Profit Lock-in & Giveback Floor (Close trade if profit retraces >= 40% of peak MFE, or >= 55% with >= 1.5x ATR activation on Indices)
  - Anti-Overextension Guard (Blocks chasing breakout > 2.5x ATR from OR)
  - Max Dollar Risk Cap ($12.00 hard cap per trade)
  - Loss Streak Protection (Trading halts after 3 consecutive losses)
  - Cycle Gating / Cost Gate (Deterministic pre-filters saving 80-90% LLM tokens)
- **Live cTrader WebUI**:
  - Strict binary isolation between Demo (Paper) and Real (Live) accounts
  - Live session killzones clock (Tokyo, London, New York)
  - Real-time P&L, MFE progress, and guardrail telemetry
  - Color-coded AI Reasoning streaming terminal ([LLM], [GATE], [SNAPSHOT], [EVENT], [WARN], [ERROR])
  - Economic calendar with ForexFactory Red News AI filter
  - Quantitative ranking leaderboard

## Documentation Links

- [Full LLM Context & Guide](llms-full.txt): Comprehensive guide with code, API routes, and strategy rules.
- [Architecture & Setup](https://github.com/kienphan/AgentFxTrading#readme): Step-by-step setup for cTrader and FastAPI.