Overview
AI Trading Agent is an autonomous trading system that leverages xAI's Grok model for intelligent market analysis and decision-making. The system connects to Interactive Brokers for real order execution, featuring a professional dashboard for monitoring portfolio performance in real-time.
AI Trading Agent est un système de trading autonome qui exploite le modèle Grok de xAI pour l'analyse intelligente des marchés et la prise de décision. Le système se connecte à Interactive Brokers pour l'exécution réelle des ordres, avec un tableau de bord professionnel pour le suivi des performances du portefeuille en temps réel.
Key Features
| Feature | Description |
|---|---|
| AI-Powered Analysis | Grok model analyzes market conditions and makes trading decisions |
| Real-time Dashboard | Monitor portfolio value, positions, and P&L with interactive charts |
| Automated Trading Loop | Configurable intervals (30 min) with manual/auto modes |
| Self-Reflection System | AI reviews past trades and adjusts strategy automatically |
| Interactive Brokers | Direct integration for live order execution |
| Fonctionnalité | Description |
|---|---|
| Analyse par IA | Le modèle Grok analyse les conditions de marché et prend des décisions de trading |
| Tableau de Bord Temps Réel | Suivi de la valeur du portefeuille, des positions et du P&L avec graphiques interactifs |
| Boucle de Trading Automatisée | Intervalles configurables (30 min) avec modes manuel/auto |
| Système d'Auto-Réflexion | L'IA revoit les trades passés et ajuste sa stratégie automatiquement |
| Interactive Brokers | Intégration directe pour l'exécution d'ordres en direct |
Technical Architecture
Frontend
- Next.js 14 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling with dark/light themes
- Recharts - Interactive portfolio charts
- Zustand - State management with persistence
- React Query - Server state and caching
- WebSocket - Real-time updates
Backend
- FastAPI - High-performance async Python API
- ib_insync - Interactive Brokers SDK for order execution
- xAI Grok API - AI analysis engine with tool calling
- SQLite - Local persistence for trades, decisions, reflections
- APScheduler - Automated trading loop
- Pydantic - Data validation
AI Agent Features
The Grok agent has access to 12 trading tools:| Tool | Purpose |
|---|---|
| get_stock_price_history | Historical OHLCV data |
| get_stock_info | Company fundamentals |
| trade_stock | Execute buy/sell/close orders |
| get_portfolio_state | Current positions and P&L |
| search_news | News and catalyst search |
| set_stop_loss / set_take_profit | Risk management orders |
Infrastructure
- Docker - Containerized deployment
- Caddy - Reverse proxy with auto-SSL
- Yahoo Finance - Fallback market data source
Frontend
- Next.js 14 - Framework React avec App Router
- TypeScript - Développement typé
- Tailwind CSS - Styling utilitaire avec thèmes sombre/clair
- Recharts - Graphiques interactifs du portefeuille
- Zustand - Gestion d'état avec persistance
- React Query - État serveur et mise en cache
- WebSocket - Mises à jour en temps réel
Backend
- FastAPI - API Python asynchrone haute performance
- ib_insync - SDK Interactive Brokers pour l'exécution des ordres
- xAI Grok API - Moteur d'analyse IA avec appel de fonctions
- SQLite - Persistance locale pour les trades, décisions et réflexions
- APScheduler - Boucle de trading automatisée
- Pydantic - Validation des données
Fonctionnalités de l'Agent IA
L'agent Grok a accès à 12 outils de trading :| Outil | Utilisation |
|---|---|
| get_stock_price_history | Données historiques OHLCV |
| get_stock_info | Fondamentaux de l'entreprise |
| trade_stock | Exécution d'ordres achat/vente/clôture |
| get_portfolio_state | Positions actuelles et P&L |
| search_news | Recherche d'actualités et de catalyseurs |
| set_stop_loss / set_take_profit | Ordres de gestion du risque |
Infrastructure
- Docker - Déploiement conteneurisé
- Caddy - Reverse proxy avec SSL automatique
- Yahoo Finance - Source de données de marché de secours
Dashboard Features
Portfolio Monitoring
- Real-time portfolio value with interactive chart (1H/24H/7D/ALL views)
- Dollar and percentage P&L display
- Paris and New York timezone clocks
Trading Controls
- Manual/Auto trading mode toggle
- Trigger Analysis button for on-demand AI analysis
- Status indicators (IBKR, API, Scheduler, Market)
Analysis Panel
- All AI decisions with reasoning (BUY/SELL/KEEP)
- Chat history with Grok
- Auto-reflections with lessons learned
Suivi du Portefeuille
- Valeur du portefeuille en temps réel avec graphique interactif (vues 1H/24H/7J/TOUT)
- Affichage du P&L en dollars et en pourcentage
- Horloges Paris et New York
Contrôles de Trading
- Basculement mode de trading manuel/auto
- Bouton d'analyse à la demande par l'IA
- Indicateurs de statut (IBKR, API, Scheduler, Marché)
Panneau d'Analyse
- Toutes les décisions de l'IA avec raisonnement (ACHAT/VENTE/CONSERVER)
- Historique des conversations avec Grok
- Auto-réflexions avec leçons apprises
Technologies Summary
| Category | Technologies |
|---|---|
| Frontend | Next.js 14, TypeScript, Tailwind CSS, Recharts, Zustand, React Query |
| Backend | Python 3.11, FastAPI, ib_insync, SQLite, APScheduler |
| AI | xAI Grok API, Tool Calling, Self-Reflection |
| Infrastructure | Docker, Caddy, WebSocket |
| Data | Yahoo Finance, Interactive Brokers API |
| Catégorie | Technologies |
|---|---|
| Frontend | Next.js 14, TypeScript, Tailwind CSS, Recharts, Zustand, React Query |
| Backend | Python 3.11, FastAPI, ib_insync, SQLite, APScheduler |
| IA | xAI Grok API, Tool Calling, Self-Reflection |
| Infrastructure | Docker, Caddy, WebSocket |
| Données | Yahoo Finance, Interactive Brokers API |