Risk Portfolio Manager - Control de Riesgos Impulsado por IA
Capa sistemática de gestión de riesgos 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 dimensionamiento de posiciones, gestionar el riesgo de la cartera y automatizar acciones defensivas.
Principio Fundamental
El dimensionamiento de posiciones y la gestión de riesgos determinan la supervivencia a largo plazo. Ninguna operación individual debería amenazar la cartera.
Disparadores de Activación
Capacidades Principales
1. Motor de Dimensionamiento de Posiciones
<position_sizing> Métodos de Dimensionamiento:
interface PositionSizeRequest {
signal_strength: number; // 0-1 proveniente de meme-trader
token_risk_score: number; // 1-10 proveniente 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; // % de la cartera
recommended_size_usd: number;
max_allowed_size: number;
reasoning: string[];
risk_warnings: string[];
}
Criterio de Kelly (Modificado):
Tamaño Óptimo = (Tasa de Acierto * Ganancia Promedio - (1 - Tasa de Acierto) * 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. Posición Individual | Máx. Exposición Correlacionada |
|---|---|---|---|
| Conservadora | 0.5-1% | 2% | 5% |
| Moderada | 1-2% | 4% | 10% |
| Degen | 2-5% | 10% | 25% |
Ajustes Basados en Señal:
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 (más bajo 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: ALCISTA
TAMAÑO RECOMENDADO:
├─ Porcentaje: 2.3% de la cartera
├─ Monto: $460 (de una cartera 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 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:
- Considerar escalar la entrada (3 tramos) vs entrada única
- Colocar stop-loss en -25% (pérdida máxima de $345)
</position_sizing>
2. Métricas de Riesgo de Cartera
<risk_metrics> Panel de Riesgo en Tiempo Real:
PANEL DE RIESGO DE CARTERA
═══════════════════════════════════════
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
├─ 3 Posiciones Principales: 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 superior al 50%
Cálculos de Riesgo:
interface PortfolioRisk {
// Valor en Riesgo
var_95: number; // VaR diario con 95% de confianza
var_99: number; // VaR diario con 99% de confianza
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 deriva para activar
}
Salida de Reequilibrio:
RECOMENDACIÓN DE REEQUILIBRIO
Asignación Actual vs Objetivo:
Categoría | Actual | Objetivo | Deriva | 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 de BONK ($630) → USDC
2. VENDER 20% de la posición de WIF ($500) → USDC
3. VENDER 10% de la posición de SOL ($740) → USDC
4. Mantener posiciones de MEME y DOGE
5. Convertir ventas en colchón 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 Interruptor de Seguridad:
interface KillSwitchConfig {
daily_loss_limit: number; // % de la cartera
weekly_loss_limit: number; // % de la cartera
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 Activadas:
| Disparador | Acción | Severidad |
|---|---|---|
| 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 ACERCÁNDOSE
PnL del Día Actual: -8.7% ($-1,740)
Límite Diario: -10% ($-2,000)
Colchón Restante: $260
ACCIONES ACTIVADAS:
1. ⏸️ Ejecución de nuevas operaciones PAUSADA
2. ⚠️ Revisar todas las posiciones abiertas
3. 📊 Mayor frecuencia de monitoreo
RECOMENDADO:
- Revisar la posición de peor rendimiento (WIF: -15%)
- Considerar 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 Repentina 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 PRUEBA DE ESTRÉS
Valor Actual de la Cartera: $20,000
ESCENARIO | Impacto en Cartera | Probabilidad
Caída Repentina de SOL -30% | -$7,200 (-36%) | 5%
Rotación Fuera de Memes | -$5,040 (-25%) | 10%
Continuación del Rally Alcista | +$14,600 (+73%) | 15%
Evento de Cisne Negro | -$12,400 (-62%) | 1%
VALOR ESPERADO DE LA CARTERA:
├─ 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 (+73%)
RECOMENDACIÓN:
Considerar cubrir la exposición a memes con puts 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 Riesgos 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 skills: Estado de la cartera, 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 de cartera
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 interruptor de seguridad
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Controles 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 hay 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 datos obsoletos
- Error de cálculo: Alternativa conservadora (tamaño mínimo)
- Conflicto de interruptor de seguridad: 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 - Carteras objetivo
- scripts/position-sizer.ts - Motor de dimensionamiento
- scripts/risk-metrics.ts - Cálculos de riesgo
- scripts/kill-switch.ts - Seguridad automatizada </see_also>