Risk Portfolio Manager - Control de Riesgo Impulsado por IA
Capa sistemática de gestión de riesgo 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 riesgo determinan la supervivencia a largo plazo. Ninguna operación individual debería amenazar la cartera.
Activadores
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; // % 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 para 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 Señal * (1 - Riesgo Token / 20) * Multiplicador Mercado
Donde:
- Fuerza Señal: 0.5-1.5 (débil a fuerte)
- Riesgo Token: 1-10 (menor es más seguro)
- Multiplicador Mercado: 0.5 (volátil) a 1.2 (tendencia)
Formato de Salida:
RECOMENDACIÓN DE TAMAÑO DE POSICIÓN
Token: $MEME
Fuerza Señal: 8/10
Puntuación de Riesgo Token: 4/10
Régimen de Mercado: BULL
TAMAÑO RECOMENDADO:
├─ Porcentaje: 2.3% de la cartera
├─ Cantidad: $460 (de cartera de $20,000)
├─ Máx. 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 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 de pérdida máxima)
</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 máx. histórico)
├─ Ratio Sharpe (30d): 2.14
├─ Ratio Sortino: 2.87
├─ Beta respecto 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 Principal: 37% (SOL) - DENTRO DEL LÍMITE
├─ Top 3 Posiciones: 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 sector memes 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 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; // % 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; // % de la cartera
weekly_loss_limit: number; // % de la cartera
position_loss_limit: number; // % por posición
drawdown_limit: number; // % desde el máximo
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 automáticamente posición al -30%
drawdown_limit: 25, // Modo emergencia al -25% desde el máximo
correlation_spike_action: 'alert',
auto_execute: false, // Requerir confirmación en Fase 1
};
Acciones Disparadas:
| 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 stablecoins | 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 Diario Actual: -8.7% ($-1,740)
Límite Diario: -10% ($-2,000)
Colchón Restante: $260
ACCIONES DISPARADAS:
1. ⏸️ Ejecución de nuevas operaciones PAUSADA
2. ⚠️ Revisar todas las posiciones abiertas
3. 📊 Aumentar 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 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 PRUEBA DE ESTRÉS
Valor Actual de la Cartera: $20,000
ESCENARIO | Impacto en Cartera | Probabilidad
Caída Repentina SOL -30% | -$7,200 (-36%) | 5%
Rotación Fuera de Memes | -$5,040 (-25%) | 10%
Continuación Mercado 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 rotación de memes (-25% escenario)
⚠️ Exposición significativa a cisne negro (-62%)
✓ Valor esperado positivo en escenarios base
✓ Potencial de mejora sustancial en escenario 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
Risk Manager 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 de la cartera, alertas de riesgo
Uso desde 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 kill switch
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 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 obsolescencia
- Error de cálculo: Valor conservador por defecto (tamaño mínimo)
- Conflicto de kill switch: Gana la seguridad (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>