Gerenciador de Portfólio de Risco - Controle de Risco Impulsionado por IA
Camada sistemática de gerenciamento de risco que fica entre a geração de sinais e a execução de negociações. Usa abordagens baseadas em dados para otimizar o dimensionamento de posições, gerenciar o risco do portfólio e automatizar ações defensivas.
Princípio Central
O dimensionamento de posições e o gerenciamento de risco determinam a sobrevivência a longo prazo. Nenhuma negociação individual deve ameaçar o portfólio.
Gatilhos de Ativação
Capacidades Principais
1. Motor de Dimensionamento de Posições
<position_sizing> Métodos de Dimensionamento:
interface PositionSizeRequest {
signal_strength: number; // 0-1 vindo do meme-trader
token_risk_score: number; // 1-10 vindo da detecção rug
current_portfolio: Portfolio;
market_regime: 'bull' | 'bear' | 'sideways' | 'volatile';
risk_tolerance: 'conservative' | 'moderate' | 'degen';
}
interface PositionSizeResult {
recommended_size_pct: number; // % do portfólio
recommended_size_usd: number;
max_allowed_size: number;
reasoning: string[];
risk_warnings: string[];
}
Critério de Kelly (Modificado):
Tamanho Ideal = (Taxa de Acerto * Ganho Médio - (1 - Taxa de Acerto) * Perda Média) / Ganho Médio
Tamanho Ajustado = Kelly * Multiplicador Fracionário (0.25-0.5 para segurança)
Matriz de Dimensionamento Ajustada ao Risco:
| Tolerância ao Risco | Tamanho Base | Posição Única Máxima | Exposição Correlacionada Máxima |
|---|---|---|---|
| Conservador | 0.5-1% | 2% | 5% |
| Moderado | 1-2% | 4% | 10% |
| Degen | 2-5% | 10% | 25% |
Ajustes Baseados em Sinal:
Tamanho Final = Tamanho Base * Força do Sinal * (1 - Risco do Token / 20) * Multiplicador de Mercado
Onde:
- Força do Sinal: 0.5-1.5 (fraco a forte)
- Risco do Token: 1-10 (quanto menor, mais seguro)
- Multiplicador de Mercado: 0.5 (volátil) a 1.2 (tendência)
Formato de Saída:
RECOMENDAÇÃO DE TAMANHO DE POSIÇÃO
Token: $MEME
Força do Sinal: 8/10
Pontuação de Risco do Token: 4/10
Regime de Mercado: BULL
TAMANHO RECOMENDADO:
├─ Percentual: 2.3% do portfólio
├─ Valor: $460 (de um portfólio de $20.000)
├─ Máximo Permitido: $800 (limite de 4%)
└─ Ajustado ao Risco: DENTRO DOS LIMITES
JUSTIFICATIVA:
1. Sinal forte (8/10) suporta dimensionamento acima da média
2. Token de risco baixo-médio (4/10) permite alocação total
3. Regime de mercado em alta permite dimensionamento agressivo
4. Nenhuma correlação com posições existentes
AVISOS:
- Considere escalar (3 parcelas) vs entrada única
- Defina stop-loss em -25% (perda máxima de $345)
</position_sizing>
2. Métricas de Risco do Portfólio
<risk_metrics> Painel de Risco em Tempo Real:
PAINEL DE RISCO DO PORTFÓLIO
═══════════════════════════════════════
POSIÇÕES (5 ativas):
Token | Tamanho | PnL | Risco | 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 RISCO:
├─ VaR Diário (95%): -$1.240 (-6,2%)
├─ Drawdown Máximo (30d): -18,3%
├─ Drawdown Atual: 0% (no ATH)
├─ Índice Sharpe (30d): 2,14
├─ Índice Sortino: 2,87
├─ Beta em relação a SOL: 1,34
MATRIZ DE CORRELAÇÃO:
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
RISCO DE CONCENTRAÇÃO:
├─ Posição Principal: 37% (SOL) - DENTRO DO LIMITE
├─ 3 Principais Posições: 72,5% - ALTO
├─ Índice Herfindahl: 0,23 - MODERADO
└─ Exposição a Memes: 63% - ALTO
ALERTAS:
⚠️ Alta correlação entre MEME e WIF (0,85)
⚠️ Concentração do setor de memes acima de 50%
Cálculos de Risco:
interface PortfolioRisk {
// Value at Risk
var_95: number; // VaR diário com 95% de confiança
var_99: number; // VaR diário com 99% de confiança
cvar_95: number; // VaR Condicional (déficit esperado)
// Risco de Performance
sharpe_ratio: number;
sortino_ratio: number;
max_drawdown: number;
current_drawdown: number;
// Risco de Correlação
avg_correlation: number;
max_correlation: number;
correlation_cluster: string[]; // Grupos altamente correlacionados
// Risco de Concentração
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 retornos dos últimos 30 dias
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. Rebalanceamento Dinâmico
Quadro de Alocação Alvo:
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 desvio para acionar
}
Saída de Rebalanceamento:
RECOMENDAÇÃO DE REBALANCEAMENTO
Alocação Atual vs Alvo:
Categoria | Atual | Alvo | Desvio | Ação
SOL | 37% | 30% | +7% | VENDER $1.400
Memes | 63% | 50% | +13% | VENDER $2.600
Stáveis | 0% | 20% | -20% | COMPRAR $4.000
NEGOCIAÇÕES SUGERIDAS:
1. VENDER 15% da posição BONK ($630) → USDC
2. VENDER 20% da posição WIF ($500) → USDC
3. VENDER 10% da posição SOL ($740) → USDC
4. Manter posições MEME e DOGE
5. Converter vendas em buffer de stablecoin USDC
PROJEÇÃO PÓS-REBALANCEAMENTO:
├─ SOL: 31% (alvo: 30%)
├─ Memes: 48% (alvo: 50%)
├─ Stáveis: 21% (alvo: 20%)
└─ Redução de VaR: -18% (perfil de risco melhorado)
4. Ações Defensivas Automatizadas
<defensive_actions> Sistema Kill Switch:
interface KillSwitchConfig {
daily_loss_limit: number; // % do portfólio
weekly_loss_limit: number; // % do portfólio
position_loss_limit: number; // % por posição
drawdown_limit: number; // % do pico
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Parar novas negociações em -10% no dia
weekly_loss_limit: 20, // Parar toda atividade em -20% na semana
position_loss_limit: 30, // Fechar posição automaticamente em -30%
drawdown_limit: 25, // Modo de emergência em -25% do pico
correlation_spike_action: 'alert',
auto_execute: false, // Exigir confirmação na Fase 1
};
Ações Acionadas:
| Gatilho | Ação | Gravidade |
|---|---|---|
| Posição -25% | Aviso de stop-loss | MÉDIA |
| Posição -30% | Fechamento automático (se ativado) | ALTA |
| Diário -10% | Parar novas negociações | ALTA |
| Semanal -20% | Sair para stablecoins | CRÍTICA |
| Drawdown -25% | Liquidação de emergência | CRÍTICA |
| Correlação > 0.95 | Reduzir uma posição | MÉDIA |
Saída de Alerta:
🚨 ALERTA DE RISCO: LIMITE DE PERDA DIÁRIA PRÓXIMO
PnL Diário Atual: -8,7% (-$1.740)
Limite Diário: -10% (-$2.000)
Buffer Restante: $260
AÇÕES ACIONADAS:
1. ⏸️ Execução de novas negociações PAUSADA
2. ⚠️ Revisar todas as posições abertas
3. 📊 Frequência de monitoramento aumentada
RECOMENDADO:
- Revisar posição com pior desempenho (WIF: -15%)
- Considerar saída parcial se a tendência continuar
- NÃO fazer média para baixo
Digite RESUMIR para reativar negociações
Digite SAIR_TUDO para liquidar posições
</defensive_actions>
5. Análise de Cenários
<scenario_analysis> Teste de Estresse:
interface StressScenario {
name: string;
market_move: {
sol: number; // % de variação
memes: number; // % de variação vs SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Flash Crash SOL -30%',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotação para Fora de Memes',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Continuação do Mercado em Alta',
market_move: { sol: 50, memes: 100, correlation_shift: 0 },
probability: 0.15,
},
{
name: 'Evento Cisne Negro',
market_move: { sol: -60, memes: -80, correlation_shift: 0.3 },
probability: 0.01,
},
];
Saída do Teste de Estresse:
RESULTADOS DO TESTE DE ESTRESSE
Valor Atual do Portfólio: $20.000
CENÁRIO | Impacto no Portfólio | Probabilidade
Flash Crash SOL -30% | -$7.200 (-36%) | 5%
Rotação para Fora de Memes | -$5.040 (-25%) | 10%
Continuação do Mercado Alta| +$14.600 (+73%) | 15%
Evento Cisne Negro | -$12.400 (-62%) | 1%
VALOR ESPERADO DO PORTFÓLIO:
├─ Caso Base: $20.000
├─ Esperado (ponderado prob.): $22.340 (+11,7%)
├─ Pior Caso (99%): -$12.400 (-62%)
└─ VaR (95%, 30d): -$4.800 (-24%)
AVALIAÇÃO DE RISCO:
⚠️ Alta sensibilidade à rotação de memes (cenário -25%)
⚠️ Exposição significativa a cisne negro (-62%)
✓ Valor esperado positivo em cenários base
✓ Potencial de alta substancial no caso de alta (+73%)
RECOMENDAÇÃO:
Considere proteger exposição a memes com puts de SOL ou reduzir
cotação de memes em 10-15% para melhorar o perfil de risco.
</scenario_analysis>
Pontos de Integração
Gerenciador de Risco fornece para:
- meme-executor: Tamanhos de posição aprovados, níveis de stop-loss
- meme-trader: Limites de posição, capital disponível
- Todas as skills: Estado do portfólio, alertas de risco
Uso via CLI
# Calcular tamanho de posição
npx tsx .claude/skills/risk-portfolio-manager/scripts/position-sizer.ts \
--signal 8 \
--risk-score 4 \
--portfolio-file ./portfolio.json \
--risk-mode moderate
# Obter métricas de risco do portfólio
npx tsx .claude/skills/risk-portfolio-manager/scripts/risk-metrics.ts \
--portfolio-file ./portfolio.json \
--include-correlation \
--var-confidence 95
# Recomendação de rebalanceamento
npx tsx .claude/skills/risk-portfolio-manager/scripts/rebalancer.ts \
--portfolio-file ./portfolio.json \
--target-allocation ./targets.json \
--threshold 5
# Executar testes de estresse
npx tsx .claude/skills/risk-portfolio-manager/scripts/stress-test.ts \
--portfolio-file ./portfolio.json \
--scenarios default \
--output-format detailed
# Verificar status do kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Portões de Qualidade
<validation_rules>
- O dimensionamento de posição requer pontuação de qualidade >= 85% nos dados de preço
- Os cálculos de VaR exigem 30+ dias de dados históricos limpos
- A matriz de correlação requer dados de preço sincronizados
- Todas as recomendações incluem níveis de confiança
- Nenhum dimensionamento de posição sem verificação de detecção rug </validation_rules>
Tratamento de Erros
<error_recovery>
- Dados de preço ausentes: Usar último conhecido + aviso de desatualização
- Erro de cálculo: Fallback conservador (tamanho mínimo)
- Conflito de kill switch: A segurança vence (parar > continuar)
- Qualidade de dados insuficiente: Rejeitar dimensionamento, solicitar atualização </error_recovery>
<see_also>
- references/risk-models.md - Fórmulas matemáticas
- references/allocation-templates.md - Portfólios alvo
- scripts/position-sizer.ts - Motor de dimensionamento
- scripts/risk-metrics.ts - Cálculos de risco
- scripts/kill-switch.ts - Segurança automatizada </see_also>