Risk Portfolio Manager - Controle de Risco Orientado por IA
Camada sistemática de gerenciamento de risco que atua entre a geração de sinais e a execução de trades. Usa abordagens orientadas a 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. Nenhum trade 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 de 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 a Risco | Tamanho Base | Máximo por Posição | Máximo de Exposição Correlacionada |
|---|---|---|---|
| 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 (menor é mais seguro)
- Multiplicador de Mercado: 0,5 (volátil) a 1,2 (em tendência)
Formato de Saída:
RECOMENDAÇÃO DE TAMANHO DE POSIÇÃO
Token: $MEME
Força do Sinal: 8/10
Score de Risco do Token: 4/10
Regime de Mercado: BULL
TAMANHO RECOMENDADO:
├─ Percentual: 2,3% do portfólio
├─ Valor: $460 (de $20.000 no portfólio)
├─ 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. Mercado em alta permite dimensionamento agressivo
4. Sem correlação com posições existentes
AVISOS:
- Considere entrar em 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:
├─ Maior Posição: 37% (SOL) - DENTRO DO LIMITE
├─ 3 Maiores Posições: 72,5% - ALTO
├─ Índice Herfindahl: 0,23 - MODERADO
└─ Exposição a Meme: 63% - ALTA
ALERTAS:
⚠️ Alta correlação entre MEME e WIF (0,85)
⚠️ Concentração no setor de memes acima de 50%
Cálculos de Risco:
interface PortfolioRisk {
// Valor em Risco
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; // CVaR (perda esperada)
// 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 os últimos 30 dias de retornos
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
Estrutura 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 do 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
Stables | 0% | 20% | -20% | COMPRAR $4.000
TRADES SUGERIDOS:
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%)
├─ Stables: 21% (alvo: 20%)
└─ Redução de VaR: -18% (perfil de risco melhorado)
4. Ações Defensivas Automatizadas
<defensive_actions> Sistema de 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; // % em relação ao pico
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Parar novos trades a -10% no dia
weekly_loss_limit: 20, // Parar toda atividade a -20% na semana
position_loss_limit: 30, // Fechar posição automaticamente a -30%
drawdown_limit: 25, // Modo de emergência a -25% do pico
correlation_spike_action: 'alert',
auto_execute: false, // Exigir confirmação na Fase 1
};
Ações Acionadas:
| Gatilho | Ação | Severidade |
|---|---|---|
| Posição -25% | Aviso de stop-loss | MÉDIA |
| Posição -30% | Fechar automaticamente (se ativado) | ALTA |
| Diário -10% | Parar novos trades | 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 SE APROXIMANDO
PnL do Dia Atual: -8,7% ($-1.740)
Limite Diário: -10% ($-2.000)
Buffer Restante: $260
AÇÕES ACIONADAS:
1. ⏸️ Execução de novos trades PAUSADA
2. ⚠️ Revisar todas as posições abertas
3. 📊 Frequência de monitoramento aumentada
RECOMENDADO:
- Revisar posição com pior performance (WIF: -15%)
- Considerar saída parcial se a tendência continuar
- NÃO fazer média de baixa
Digite RESUME para reativar negociações
Digite EXIT_ALL para liquidar posições
</defensive_actions>
5. Análise de Cenários
<scenario_analysis> Testes 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: 'Saída de Moda das 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%
Saída de Moda das 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 por prob.): $22.340 (+11,7%)
├─ Pior Caso (99% de confiança): -$12.400 (-62%)
└─ VaR (95%, 30d): -$4.800 (-24%)
AVALIAÇÃO DE RISCO:
⚠️ Alta sensibilidade à saída de moda das memes (cenário -25%)
⚠️ Exposição significativa a cisne negro (-62%)
✓ Valor esperado positivo em cenários base
✓ Potencial de alta substancial no bull case (+73%)
RECOMENDAÇÃO:
Considere fazer hedge da exposição a memes com puts de SOL ou reduzir
a alocação em memes em 10-15% para melhorar o perfil de risco.
</scenario_analysis>
Pontos de Integração
O Risk Manager fornece para:
- meme-executor: Tamanhos de posição aprovados, níveis de stop-loss
- meme-trader: Limites de posição, capital disponível
- Todos os skills: Estado do portfólio, alertas de risco
Uso via CLI
# Calcular tamanho da 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
Garantias de Qualidade
<validation_rules>
- O dimensionamento de posição requer score 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 é feito sem verificação de rug </validation_rules>
Tratamento de Erros
<error_recovery>
- Dados de preço ausentes: Usar último conhecido + aviso de obsolescência
- Erro de cálculo: Fallback conservador (tamanho mínimo)
- Conflito de kill switch: 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>