# 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

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

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

```markdown
## 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](../especificaciones/ET-LLM-002-agente-analisis.md)
- [ET-LLM-003: Integración ML](../especificaciones/ET-LLM-003-integracion-ml.md)

---

## 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*
*OrbiQuant IA Trading Platform*
