---
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
