trading-platform/docs/02-definicion-modulos/OQI-007-llm-agent/requerimientos/RF-LLM-002-market-analysis.md

id	title	type	status	priority	epic	project	version	created_date	updated_date
RF-LLM-002	Análisis de Mercado con LLM	Requirement	Done	Alta	OQI-007	trading-platform	1.0.0	2025-12-05	2026-01-04

RF-LLM-002: Análisis de Mercado con LLM

Épica: OQI-007 - LLM Strategy Agent Versión: 1.0 Fecha: 2025-12-05 Estado: Planificado Prioridad: P0 - Crítico

---

Descripción

El agente LLM debe ser capaz de realizar análisis de mercado completos, incluyendo análisis técnico, fundamental y de sentimiento. El análisis debe integrar datos en tiempo real, señales ML del sistema y noticias relevantes.

---

Requisitos Funcionales

RF-LLM-002.1: Análisis Técnico

• El agente debe analizar patrones de precio (soportes, resistencias, tendencias)
• El agente debe interpretar indicadores técnicos (RSI, MACD, BB, etc.)
• El agente debe identificar formaciones de velas japonesas
• El agente debe detectar divergencias entre precio e indicadores
• El análisis debe incluir múltiples timeframes (1h, 4h, 1d)

RF-LLM-002.2: Análisis Fundamental

• El agente debe consultar datos fundamentales del activo
• El agente debe analizar earnings, revenue, P/E ratio
• El agente debe considerar eventos corporativos (splits, dividendos)
• El agente debe comparar con competidores del sector

RF-LLM-002.3: Análisis de Sentimiento

• El agente debe analizar sentiment de noticias recientes
• El agente debe considerar menciones en redes sociales
• El agente debe evaluar fear & greed index (crypto)
• El agente debe detectar cambios de narrativa

RF-LLM-002.4: Integración con Señales ML

• El agente debe consultar predicciones del ML Engine (OQI-006)
• El agente debe explicar las señales ML en lenguaje natural
• El agente debe combinar análisis técnico con predicciones ML
• El agente debe indicar nivel de confianza de las predicciones

RF-LLM-002.5: Generación de Insights

• El agente debe generar resumen ejecutivo del análisis
• El agente debe identificar oportunidades de trading
• El agente debe señalar riesgos potenciales
• El agente debe sugerir niveles de entrada/salida

---

Criterios de Aceptación

Feature: Análisis de Mercado

Scenario: Análisis técnico de un símbolo
  Given estoy en el Copilot
  When pregunto "Analiza técnicamente BTC/USD"
  Then el agente responde con:
    | Componente | Contenido |
    | Tendencia | Dirección actual y fuerza |
    | Soportes | Niveles de soporte identificados |
    | Resistencias | Niveles de resistencia identificados |
    | Indicadores | RSI, MACD, BB con interpretación |
    | Patrones | Formaciones identificadas |
    | Conclusión | Sesgo alcista/bajista/neutral |

Scenario: Análisis con señales ML
  Given soy usuario Premium
  When pregunto "¿Qué dice el ML sobre AAPL?"
  Then el agente responde con:
    | Componente | Contenido |
    | Predicción | Dirección predicha por ML |
    | Confianza | Porcentaje de confianza |
    | Horizonte | Timeframe de la predicción |
    | Explicación | Por qué el ML predice esto |
    | Disclaimer | Advertencia de riesgo |

Scenario: Comparación de activos
  Given tengo watchlist con AAPL, MSFT, GOOGL
  When pregunto "Compara estas acciones tecnológicas"
  Then el agente genera tabla comparativa
  And incluye métricas técnicas y fundamentales
  And sugiere cuál tiene mejor oportunidad

---

Reglas de Negocio

Regla	Descripción
RN-001	Análisis fundamental solo para acciones (no crypto)
RN-002	Señales ML solo visibles para usuarios Pro/Premium
RN-003	Todo análisis incluye disclaimer de riesgo
RN-004	Datos de precio máximo 15 minutos de delay (Free)
RN-005	Datos real-time para Pro/Premium
RN-006	Máximo 5 símbolos en comparación simultánea

---

Dependencias

Épicas Requeridas

• OQI-003: Datos de trading y charts
• OQI-006: Señales ML para predicciones

APIs Externas

• Alpaca Markets (market data)
• News API (noticias)
• OpenAI/Claude (análisis LLM)

---

Datos de Entrada

market_context:
  symbol: "AAPL"
  current_price: 185.50
  change_24h: "+2.3%"
  volume: 45000000

technical_data:
  rsi_14: 62
  macd: { signal: 0.5, histogram: 0.2 }
  sma_20: 182.30
  sma_50: 178.45
  support_levels: [180, 175, 170]
  resistance_levels: [188, 192, 200]

ml_signals:
  prediction: "bullish"
  confidence: 0.72
  horizon: "4h"

news_sentiment:
  overall: "positive"
  recent_headlines: [...]

---

Formato de Respuesta

## Análisis de AAPL - Apple Inc.

### Resumen Ejecutivo
AAPL muestra tendencia alcista en el corto plazo con momentum
positivo. El RSI en 62 indica espacio para subir antes de
sobrecompra.

### Análisis Técnico
- **Tendencia:** Alcista (precio sobre SMA 20 y 50)
- **Soportes:** $180 (fuerte), $175, $170
- **Resistencias:** $188 (inmediata), $192, $200
- **RSI (14):** 62 - Neutral con sesgo alcista
- **MACD:** Positivo, señal de compra reciente

### Señales ML 🤖
- **Predicción:** Alcista (72% confianza)
- **Horizonte:** Próximas 4 horas
- **Basado en:** Momentum + Volume profile

### Oportunidad Identificada
📈 Posible entrada en pullback a $182-183
🎯 Target: $188 (resistencia inmediata)
🛑 Stop sugerido: $179 (bajo soporte)

⚠️ *Este análisis es informativo. No constituye
asesoría financiera. Opera bajo tu propio riesgo.*

---

Especificaciones Técnicas Relacionadas

• ET-LLM-002: Agente de Análisis
• ET-LLM-003: Integración ML

---

Historias de Usuario Relacionadas

• US-LLM-003: Solicitar análisis de símbolo
• US-LLM-004: Ver predicciones ML explicadas

---

Documento de requerimientos - Sistema NEXUS Trading Platform