Gestor de Riesgo de Portafolio - Control de Riesgo Impulsado por IA
Capa de gestión de riesgos sistemática que se sitúa entre la generación de señales y la ejecución de operaciones. Utiliza enfoques basados en datos para optimizar el tamaño de las posiciones, gestionar el riesgo del portafolio y automatizar acciones defensivas.
Principio Fundamental
El tamaño de las posiciones y la gestión del riesgo determinan la supervivencia a largo plazo. Ninguna operación individual debe amenazar el portafolio.
Disparadores de Activación
Capacidades Fundamentales
1. Motor de Dimensionamiento de Posiciones
<position_sizing> Métodos de Dimensionamiento:
interface PositionSizeRequest {
signal_strength: number; // 0-1 de meme-trader
token_risk_score: number; // 1-10 de detección de rug
current_portfolio: Portfolio;
market_regime: 'bull' | 'bear' | 'sideways' | 'volatile';
risk_tolerance: 'conservative' | 'moderate' | 'degen';
}
interface PositionSizeResult {
recommended_size_pct: number; // % del portafolio
recommended_size_usd: number;
max_allowed_size: number;
reasoning: string[];
risk_warnings: string[];
}
Criterio de Kelly (Modificado):
Tamaño Óptimo = (Tasa de Aciertos * Ganancia Promedio - (1 - Tasa de Aciertos) * Pérdida Promedio) / Ganancia Promedio
Tamaño Ajustado = Kelly * Multiplicador Fraccional (0.25-0.5 por seguridad)
Matriz de Dimensionamiento Ajustado por Riesgo:
| Tolerancia al Riesgo | Tamaño Base | Máx. por Posición | Máx. Exposición Correlacionada |
|---|---|---|---|
| Conservador | 0.5-1% | 2% | 5% |
| Moderado | 1-2% | 4% | 10% |
| Degen | 2-5% | 10% | 25% |
Ajustes Basados en Señales:
Tamaño Final = Tamaño Base * Fuerza de Señal * (1 - Riesgo del Token / 20) * Multiplicador de Mercado
Donde:
- Fuerza de Señal: 0.5-1.5 (débil a fuerte)
- Riesgo del Token: 1-10 (menor es más seguro)
- Multiplicador de Mercado: 0.5 (volátil) a 1.2 (en tendencia)
Formato de Salida:
RECOMENDACIÓN DE TAMAÑO DE POSICIÓN
Token: $MEME
Fuerza de Señal: 8/10
Puntuación de Riesgo del Token: 4/10
Régimen de Mercado: BULL
TAMAÑO RECOMENDADO:
├─ Porcentaje: 2.3% del portafolio
├─ Cantidad: $460 (de $20,000 portafolio)
├─ Máx. Permitido: $800 (límite 4%)
└─ Ajustado por Riesgo: DENTRO DE LÍMITES
RAZONAMIENTO:
1. Señal fuerte (8/10) respalda un dimensionamiento superior al promedio
2. Token de riesgo bajo-medio (4/10) permite asignación completa
3. Régimen de mercado alcista permite dimensionamiento agresivo
4. Sin correlación con posiciones existentes
ADVERTENCIAS:
- Considere escalar la entrada (3 tramos) vs entrada única
- Establezca stop-loss en -25% ($345 pérdida máxima)
</position_sizing>
2. Métricas de Riesgo del Portafolio
<risk_metrics> Panel de Riesgo en Tiempo Real:
PANEL DE RIESGO DEL PORTAFOLIO
═══════════════════════════════════════
POSICIONES (5 activas):
Token | Tamaño | PnL | Riesgo | Peso
$BONK | $4,200 | +$840 | 5/10 | 21%
$MEME | $3,100 | +$620 | 4/10 | 15.5%
$DOGE | $2,800 | -$140 | 3/10 | 14%
$WIF | $2,500 | +$1,250 | 6/10 | 12.5%
SOL | $7,400 | +$2,220 | 2/10 | 37%
───────────────────────────────────────
TOTAL | $20,000 | +$4,790 | | 100%
MÉTRICAS DE RIESGO:
├─ VaR Diario (95%): -$1,240 (-6.2%)
├─ Drawdown Máximo (30d): -18.3%
├─ Drawdown Actual: 0% (en ATH)
├─ Ratio Sharpe (30d): 2.14
├─ Ratio Sortino: 2.87
├─ Beta con SOL: 1.34
MATRIZ DE CORRELACIÓN:
BONK MEME DOGE WIF SOL
BONK 1.00 0.82 0.71 0.78 0.65
MEME 0.82 1.00 0.68 0.85 0.61
DOGE 0.71 0.68 1.00 0.59 0.54
WIF 0.78 0.85 0.59 1.00 0.72
SOL 0.65 0.61 0.54 0.72 1.00
RIESGO DE CONCENTRACIÓN:
├─ Posición Principal: 37% (SOL) - DENTRO DEL LÍMITE
├─ Top 3 Posiciones: 72.5% - ALTO
├─ Índice Herfindahl: 0.23 - MODERADO
└─ Exposición a Memes: 63% - ALTA
ALERTAS:
⚠️ Alta correlación entre MEME y WIF (0.85)
⚠️ Concentración del sector Meme por encima del 50%
Cálculos de Riesgo:
interface PortfolioRisk {
// Valor en Riesgo
var_95: number; // VaR diario con confianza del 95%
var_99: number; // VaR diario con confianza del 99%
cvar_95: number; // VaR condicional (déficit esperado)
// Riesgo de Rendimiento
sharpe_ratio: number;
sortino_ratio: number;
max_drawdown: number;
current_drawdown: number;
// Riesgo de Correlación
avg_correlation: number;
max_correlation: number;
correlation_cluster: string[]; // Grupos altamente correlacionados
// Riesgo de Concentración
herfindahl_index: number;
top_position_pct: number;
sector_concentrations: Record<string, number>;
}
function calculateVaR(
positions: Position[],
confidence: number = 0.95,
horizon_days: number = 1
): number {
// VaR histórico usando rendimientos de los últimos 30 días
const returns = getHistoricalReturns(positions, 30);
const portfolio_returns = calculatePortfolioReturns(returns, positions);
const sorted = portfolio_returns.sort((a, b) => a - b);
const index = Math.floor((1 - confidence) * sorted.length);
return sorted[index] * getPortfolioValue(positions) * Math.sqrt(horizon_days);
}
</risk_metrics>
3. Reequilibrio Dinámico
Marco de Asignación Objetivo:
interface AllocationTarget {
core_holdings: {
SOL: { target: 30, min: 20, max: 50 };
stablecoins: { target: 20, min: 10, max: 40 };
};
satellite_holdings: {
memes: { target: 30, min: 0, max: 50 };
defi: { target: 15, min: 0, max: 30 };
other: { target: 5, min: 0, max: 15 };
};
rebalance_threshold: 5; // % de desviación para disparar
}
Salida de Reequilibrio:
RECOMENDACIÓN DE REEQUILIBRIO
Asignación Actual vs Objetivo:
Categoría | Actual | Objetivo | Desviación | Acción
SOL | 37% | 30% | +7% | VENDER $1,400
Memes | 63% | 50% | +13% | VENDER $2,600
Estables | 0% | 20% | -20% | COMPRAR $4,000
OPERACIONES SUGERIDAS:
1. VENDER 15% de la posición BONK ($630) → USDC
2. VENDER 20% de la posición WIF ($500) → USDC
3. VENDER 10% de la posición SOL ($740) → USDC
4. MANTENER posiciones MEME y DOGE
5. Convertir ventas en reserva de stablecoin USDC
PROYECCIÓN POST-REEQUILIBRIO:
├─ SOL: 31% (objetivo: 30%)
├─ Memes: 48% (objetivo: 50%)
├─ Estables: 21% (objetivo: 20%)
└─ Reducción de VaR: -18% (perfil de riesgo mejorado)
4. Acciones Defensivas Automatizadas
<defensive_actions> Sistema de Kill Switch:
interface KillSwitchConfig {
daily_loss_limit: number; // % del portafolio
weekly_loss_limit: number; // % del portafolio
position_loss_limit: number; // % por posición
drawdown_limit: number; // % desde el pico
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Detener nuevas operaciones con -10% diario
weekly_loss_limit: 20, // Detener toda actividad con -20% semanal
position_loss_limit: 30, // Cerrar automáticamente posición con -30%
drawdown_limit: 25, // Modo de emergencia con -25% desde el pico
correlation_spike_action: 'alert',
auto_execute: false, // Requerir confirmación en Fase 1
};
Acciones Disparadas:
| Disparador | Acción | Gravedad |
|---|---|---|
| Posición -25% | Advertencia de stop-loss | MEDIA |
| Posición -30% | Cierre automático (si está habilitado) | ALTA |
| Diario -10% | Detener nuevas operaciones | ALTA |
| Semanal -20% | Salir a estables | CRÍTICA |
| Drawdown -25% | Liquidación de emergencia | CRÍTICA |
| Correlación > 0.95 | Reducir una posición | MEDIA |
Salida de Alerta:
🚨 ALERTA DE RIESGO: LÍMITE DE PÉRDIDA DIARIA PRÓXIMO
PnL del Día Actual: -8.7% ($-1,740)
Límite Diario: -10% ($-2,000)
Reserva Restante: $260
ACCIONES DISPARADAS:
1. ⏸️ Ejecución de nuevas operaciones PAUSADA
2. ⚠️ Revisar todas las posiciones abiertas
3. 📊 Mayor frecuencia de monitoreo
RECOMENDADO:
- Revisar la posición con peor rendimiento (WIF: -15%)
- Considerar salida parcial si la tendencia continúa
- NO promediar a la baja
Escriba RESUME para reanudar la negociación
Escriba EXIT_ALL para liquidar posiciones
</defensive_actions>
5. Análisis de Escenarios
<scenario_analysis> Pruebas de Estrés:
interface StressScenario {
name: string;
market_move: {
sol: number; // % de cambio
memes: number; // % de cambio vs SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Caída Súbita de SOL -30%',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotación Fuera de Memes',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Continuación del Rally Alcista',
market_move: { sol: 50, memes: 100, correlation_shift: 0 },
probability: 0.15,
},
{
name: 'Evento de Cisne Negro',
market_move: { sol: -60, memes: -80, correlation_shift: 0.3 },
probability: 0.01,
},
];
Salida de Prueba de Estrés:
RESULTADOS DE LA PRUEBA DE ESTRÉS
Valor Actual del Portafolio: $20,000
ESCENARIO | Impacto en el Portafolio | Probabilidad
Caída Súbita de SOL -30% | -$7,200 (-36%) | 5%
Rotación Fuera de Memes | -$5,040 (-25%) | 10%
Continuación del Rally | +$14,600 (+73%) | 15%
Cisne Negro | -$12,400 (-62%) | 1%
VALOR ESPERADO DEL PORTAFOLIO:
├─ Caso Base: $20,000
├─ Esperado (prob-ponderado): $22,340 (+11.7%)
├─ Peor Caso (99%): -$12,400 (-62%)
└─ VaR (95%, 30d): -$4,800 (-24%)
EVALUACIÓN DE RIESGO:
⚠️ Alta sensibilidad a rotación de memes (escenario -25%)
⚠️ Exposición significativa a cisne negro (-62%)
✓ Valor esperado positivo en escenarios base
✓ Potencial alcista sustancial en caso alcista (+73%)
RECOMENDACIÓN:
Considere cubrir la exposición a memes con opciones de SOL o reducir
la asignación a memes en un 10-15% para mejorar el perfil de riesgo.
</scenario_analysis>
Puntos de Integración
El Gestor de Riesgo proporciona a:
- meme-executor: Tamaños de posición aprobados, niveles de stop-loss
- meme-trader: Límites de posición, capital disponible
- Todas las habilidades: Estado del portafolio, alertas de riesgo
Uso en CLI
# Calcular tamaño de posición
npx tsx .claude/skills/risk-portfolio-manager/scripts/position-sizer.ts \
--signal 8 \
--risk-score 4 \
--portfolio-file ./portfolio.json \
--risk-mode moderate
# Obtener métricas de riesgo del portafolio
npx tsx .claude/skills/risk-portfolio-manager/scripts/risk-metrics.ts \
--portfolio-file ./portfolio.json \
--include-correlation \
--var-confidence 95
# Recomendación de reequilibrio
npx tsx .claude/skills/risk-portfolio-manager/scripts/rebalancer.ts \
--portfolio-file ./portfolio.json \
--target-allocation ./targets.json \
--threshold 5
# Ejecutar pruebas de estrés
npx tsx .claude/skills/risk-portfolio-manager/scripts/stress-test.ts \
--portfolio-file ./portfolio.json \
--scenarios default \
--output-format detailed
# Verificar estado del kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Barreras de Calidad
<validation_rules>
- El dimensionamiento de posiciones requiere una puntuación de calidad >= 85% en los datos de precio
- Los cálculos de VaR requieren 30+ días de datos históricos limpios
- La matriz de correlación requiere datos de precio sincronizados
- Todas las recomendaciones incluyen niveles de confianza
- No se realiza dimensionamiento de posiciones sin verificación de detección de rug </validation_rules>
Manejo de Errores
<error_recovery>
- Datos de precio faltantes: Usar último conocido + advertencia de obsolecencia
- Error de cálculo: Retroceso conservador (tamaño mínimo)
- Conflicto de kill switch: La seguridad gana (detener > continuar)
- Calidad de datos insuficiente: Rechazar dimensionamiento, solicitar actualización </error_recovery>
<see_also>
- references/risk-models.md - Fórmulas matemáticas
- references/allocation-templates.md - Portafolios objetivo
- scripts/position-sizer.ts - Motor de dimensionamiento
- scripts/risk-metrics.ts - Cálculos de riesgo
- scripts/kill-switch.ts - Seguridad automatizada </see_also>