Gestor de Riesgo de Portafolio - Control de Riesgo Impulsado por IA
Capa de gestión de riesgo sistemática situada 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 debería amenazar el portafolio.
Desencadenantes de Activación
Capacidades Principales
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):
Optimal Size = (Win Rate * Avg Win - (1 - Win Rate) * Avg Loss) / Avg Win
Adjusted Size = Kelly * Fractional Multiplier (0.25-0.5 por seguridad)
Matriz de Dimensionamiento Ajustada por Riesgo:
| Tolerancia al Riesgo | Tamaño Base | Máx. Posición Individual | Máx. Exposición Correlacionada |
|---|---|---|---|
| Conservador | 0.5-1% | 2% | 5% |
| Moderado | 1-2% | 4% | 10% |
| Degenerado | 2-5% | 10% | 25% |
Ajustes Basados en la Señal:
Final Size = Base Size * Signal Strength * (1 - Token Risk / 20) * Market Multiplier
Donde:
- Signal Strength: 0.5-1.5 (débil a fuerte)
- Token Risk: 1-10 (más bajo es más seguro)
- Market Multiplier: 0.5 (volátil) a 1.2 (con 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: ALCISTA
TAMAÑO RECOMENDADO:
├─ Porcentaje: 2.3% del portafolio
├─ Monto: $460 (de un portafolio de $20,000)
├─ Máximo Permitido: $800 (límite del 4%)
└─ Ajustado por Riesgo: DENTRO DE LÍMITES
RAZONAMIENTO:
1. Señal fuerte (8/10) respalda un tamaño superior al promedio
2. Token de riesgo bajo-medio (4/10) permite la asignación completa
3. El régimen de mercado alcista permite un dimensionamiento agresivo
4. Sin correlación con posiciones existentes
ADVERTENCIAS:
- Considere escalar la entrada (3 tramos) vs. una sola entrada
- Establezca un stop-loss en -25% (pérdida máxima de $345)
</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 | PyG | 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 a 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 Superior: 37% (SOL) - DENTRO DEL LÍMITE
├─ 3 Posiciones Principales: 72.5% - ALTO
├─ Índice Herfindahl: 0.23 - MODERADO
└─ Exposición a Memes: 63% - ALTO
ALERTAS:
⚠️ Alta correlación entre MEME y WIF (0.85)
⚠️ Concentración del sector Meme superior al 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 utilizando los últimos 30 días de rendimientos
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 activar
}
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 Cortafuegos:
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 al -10% diario
weekly_loss_limit: 20, // Detener toda actividad al -20% semanal
position_loss_limit: 30, // Cerrar posición automáticamente al -30%
drawdown_limit: 25, // Modo de emergencia al -25% desde el pico
correlation_spike_action: 'alert',
auto_execute: false, // Requerir confirmación en Fase 1
};
Acciones Desencadenadas:
| Desencadenante | 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
PyG del Día Actual: -8.7% ($-1,740)
Límite Diario: -10% ($-2,000)
Reserva Restante: $260
ACCIONES DESENCADENADAS:
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%)
- Considere una salida parcial si la tendencia continúa
- NO promediar a la baja
Escriba RESUME para reanudar operaciones
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 Relámpago 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 Mercado 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 Relámpago de SOL -30% | -$7,200 (-36%) | 5%
Rotación Fuera de Memes | -$5,040 (-25%) | 10%
Continuación Alcista | +$14,600 (+73%) | 15%
Evento de Cisne Negro | -$12,400 (-62%) | 1%
VALOR ESPERADO DEL PORTAFOLIO:
├─ Caso Base: $20,000
├─ Esperado (ponderado por prob.): $22,340 (+11.7%)
├─ Peor Caso (99%): -$12,400 (-62%)
└─ VaR (95%, 30d): -$4,800 (-24%)
EVALUACIÓN DE RIESGO:
⚠️ Alta sensibilidad a la 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 venta 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
- Todos los skills: Estado del portafolio, alertas de riesgo
Uso en CLI
# Calcular el tamaño de la 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 el estado del cortafuegos
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Puertas de Calidad
<validation_rules>
- El dimensionamiento de la posición 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 hay dimensionamiento de posición sin verificación de detección de rug </validation_rules>
Manejo de Errores
<error_recovery>
- Datos de precio faltantes: Usar el último conocido + advertencia de desactualización
- Error de cálculo: Retroceso conservador (tamaño mínimo)
- Conflicto de cortafuegos: 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>