--- id: "MAP-OQI-010" title: "Mapa de OQI-010-llm-trading-integration" type: "Index" project: "trading-platform" updated_date: "2026-01-04" --- # _MAP: OQI-010 - LLM Trading Integration **Ultima actualizacion:** 2026-01-04 **Estado:** Planning **Version:** 1.0.0 --- ## Proposito Esta epica implementa la integracion avanzada del LLM con fine-tuning para trading, incluyendo: - Fine-tuning con estrategias AMD/ICT/SMC - MCP Binance Connector - Sistema de gestion de riesgo - API de predicciones para frontend - Persistencia y tracking de predicciones --- ## Contenido del Directorio ``` OQI-010-llm-trading-integration/ ├── README.md # Este archivo - descripcion de la epica ├── _MAP.md # Indice del modulo │ ├── requerimientos/ # Documentos de requerimientos funcionales │ ├── RF-LLM-001-fine-tuning.md # Fine-tuning con estrategias │ ├── RF-LLM-002-mcp-binance.md # MCP Binance Connector │ ├── RF-LLM-003-risk-management.md # Sistema de gestion de riesgo │ ├── RF-LLM-004-api-predictions.md # API predicciones frontend │ ├── RF-LLM-005-persistence.md # Persistencia predicciones │ ├── RF-LLM-006-confluence.md # Analisis confluencia ML │ ├── RF-LLM-007-websocket.md # WebSocket real-time │ ├── RF-LLM-008-tracking.md # Tracking outcomes │ ├── RF-LLM-009-dashboard.md # Dashboard accuracy │ └── RF-LLM-010-circuit-breaker.md # Circuit breaker │ ├── especificaciones/ # Especificaciones tecnicas │ ├── ET-LLM-001-arquitectura.md # Arquitectura general │ ├── ET-LLM-002-fine-tuning.md # Pipeline fine-tuning │ ├── ET-LLM-003-mcp-binance.md # MCP Binance spec │ ├── ET-LLM-004-risk-service.md # Risk management service │ ├── ET-LLM-005-predictions-api.md # API endpoints │ └── ET-LLM-006-database.md # DDL y schemas │ ├── historias-usuario/ # User Stories │ ├── US-LLM-001-mcp-binance.md │ ├── US-LLM-002-fine-tuning-pipeline.md │ ├── US-LLM-003-persistence-ddl.md │ ├── US-LLM-004-ml-analysis.md │ ├── US-LLM-005-risk-validation.md │ ├── US-LLM-006-api-predictions.md │ ├── US-LLM-007-websocket-realtime.md │ ├── US-LLM-008-confluence-calc.md │ ├── US-LLM-009-trade-execution.md │ ├── US-LLM-010-outcome-tracking.md │ ├── US-LLM-011-accuracy-metrics.md │ ├── US-LLM-012-circuit-breaker.md │ ├── US-LLM-013-production-tuning.md │ ├── US-LLM-014-alerts.md │ ├── US-LLM-015-monitoring-dashboard.md │ └── US-LLM-016-integration-tests.md │ └── implementacion/ # Trazabilidad de implementacion └── TRACEABILITY.yml ``` --- ## Requerimientos Funcionales | ID | Nombre | Prioridad | SP | Estado | |----|--------|-----------|-----|--------| | RF-LLM-001 | Fine-tuning con estrategias | P0 | 13 | Pendiente | | RF-LLM-002 | MCP Binance Connector | P0 | 8 | Pendiente | | RF-LLM-003 | Sistema gestion de riesgo | P0 | 8 | Pendiente | | RF-LLM-004 | API predicciones frontend | P0 | 5 | Pendiente | | RF-LLM-005 | Persistencia predicciones | P1 | 5 | Pendiente | | RF-LLM-006 | Analisis confluencia ML | P0 | 5 | Pendiente | | RF-LLM-007 | WebSocket real-time | P1 | 5 | Pendiente | | RF-LLM-008 | Tracking outcomes | P1 | 5 | Pendiente | | RF-LLM-009 | Dashboard accuracy | P2 | 3 | Pendiente | | RF-LLM-010 | Circuit breaker auto | P0 | 5 | Pendiente | **Total:** 62 SP --- ## Historias de Usuario por Sprint ### Sprint 1: Infraestructura (21 SP) | ID | Historia | SP | Estado | |----|----------|-----|--------| | US-LLM-001 | MCP Binance Connector | 8 | Pendiente | | US-LLM-002 | Pipeline fine-tuning | 8 | Pendiente | | US-LLM-003 | DDL PostgreSQL | 5 | Pendiente | ### Sprint 2: Core Features (26 SP) | ID | Historia | SP | Estado | |----|----------|-----|--------| | US-LLM-004 | Analisis ML + explicacion | 8 | Pendiente | | US-LLM-005 | Validacion de riesgo | 5 | Pendiente | | US-LLM-006 | API predicciones | 5 | Pendiente | | US-LLM-007 | WebSocket predicciones | 5 | Pendiente | | US-LLM-008 | Calculo confluencia | 3 | Pendiente | ### Sprint 3: Integracion (21 SP) | ID | Historia | SP | Estado | |----|----------|-----|--------| | US-LLM-009 | Ejecucion MT4/Binance | 8 | Pendiente | | US-LLM-010 | Tracking outcomes | 5 | Pendiente | | US-LLM-011 | Metricas accuracy | 5 | Pendiente | | US-LLM-012 | Circuit breaker | 3 | Pendiente | ### Sprint 4: Optimizacion (21 SP) | ID | Historia | SP | Estado | |----|----------|-----|--------| | US-LLM-013 | Fine-tuning produccion | 8 | Pendiente | | US-LLM-014 | Alertas oportunidades | 5 | Pendiente | | US-LLM-015 | Dashboard monitoreo | 5 | Pendiente | | US-LLM-016 | Tests integracion | 3 | Pendiente | **Total:** 89 SP --- ## Componentes Nuevos ### 1. MCP Binance Connector - **Ubicacion:** `apps/mcp-binance-connector/` - **Puerto:** 3606 - **Tecnologia:** Node.js + TypeScript + CCXT - **Documentacion:** `docs/01-arquitectura/MCP-BINANCE-CONNECTOR-SPEC.md` ### 2. Risk Management Service - **Ubicacion:** `apps/llm-agent/src/services/risk_manager.py` - **Funcionalidades:** Position sizing, drawdown monitor, circuit breaker ### 3. Predictions API - **Ubicacion:** `apps/llm-agent/src/api/predictions.py` - **Endpoints:** REST + WebSocket - **Puerto:** 3085 ### 4. Fine-Tuning Pipeline - **Ubicacion:** `apps/llm-agent/fine_tuning/` - **Dataset:** JSONL con estrategias de trading - **Modelo:** LoRA adapter para Llama 3 8B --- ## DDL Nuevas Tablas ```sql -- Schema: ml CREATE TABLE ml.llm_predictions (...) CREATE TABLE ml.prediction_outcomes (...) CREATE TABLE ml.llm_decisions (...) CREATE TABLE ml.risk_events (...) ``` Ver detalle en: `docs/01-arquitectura/INTEGRACION-LLM-FINE-TUNING.md` --- ## Dependencias ### Depende de: - OQI-001: Autenticacion (Completado) - OQI-006: ML Signals (Completado) - OQI-007: LLM Agent base (Completado) ### Habilita: - OQI-004: Investment Accounts - OQI-011: Auto-Trading (futuro) --- ## Referencias - [README Epica](./README.md) - [Integracion LLM Fine-Tuning](../../01-arquitectura/INTEGRACION-LLM-FINE-TUNING.md) - [MCP Binance Spec](../../01-arquitectura/MCP-BINANCE-CONNECTOR-SPEC.md) - [Plan ML-LLM-Trading](../../../orchestration/planes/PLAN-ML-LLM-TRADING.md) --- **Generado:** 2026-01-04