Gestionnaire de Portefeuille Risque - Contrôle des Risques Piloté par l'IA
Couche de gestion des risques systématique placée entre la génération de signaux et l'exécution des transactions. Utilise des approches basées sur les données pour optimiser le dimensionnement des positions, gérer le risque du portefeuille et automatiser les actions défensives.
Principe Fondamental
Le dimensionnement des positions et la gestion des risques déterminent la survie à long terme. Aucune transaction unique ne devrait menacer le portefeuille.
Déclencheurs d'Activation
Capacités Clés
1. Moteur de Dimensionnement des Positions
<position_sizing> Méthodes de Dimensionnement :
interface PositionSizeRequest {
signal_strength: number; // 0-1 en provenance de meme-trader
token_risk_score: number; // 1-10 en provenance de la détection rug
current_portfolio: Portfolio;
market_regime: 'bull' | 'bear' | 'sideways' | 'volatile';
risk_tolerance: 'conservative' | 'moderate' | 'degen';
}
interface PositionSizeResult {
recommended_size_pct: number; // % du portefeuille
recommended_size_usd: number;
max_allowed_size: number;
reasoning: string[];
risk_warnings: string[];
}
Critère de Kelly (Modifié) :
Optimal Size = (Win Rate * Avg Win - (1 - Win Rate) * Avg Loss) / Avg Win
Adjusted Size = Kelly * Fractional Multiplier (0.25-0.5 pour la sécurité)
Matrice de Dimensionnement Ajustée au Risque :
| Tolérance au Risque | Taille de Base | Position Unique Maximale | Exposition Corrélée Maximale |
|---|---|---|---|
| Conservative | 0.5-1% | 2% | 5% |
| Moderate | 1-2% | 4% | 10% |
| Degen | 2-5% | 10% | 25% |
Ajustements Basés sur le Signal :
Taille Finale = Taille de Base * Force du Signal * (1 - Risque du Jeton / 20) * Multiplicateur de Marché
Où :
- Force du Signal : 0.5-1.5 (faible à fort)
- Risque du Jeton : 1-10 (plus bas = plus sûr)
- Multiplicateur de Marché : 0.5 (volatile) à 1.2 (tendance)
Format de Sortie :
RECOMMANDATION DE TAILLE DE POSITION
Jeton : $MEME
Force du Signal : 8/10
Score de Risque du Jeton : 4/10
Régime de Marché : BULL
TAILLE RECOMMANDÉE :
├─ Pourcentage : 2,3% du portefeuille
├─ Montant : 460 $ (sur un portefeuille de 20 000 $)
├─ Maximum Autorisé : 800 $ (limite de 4%)
└─ Ajustée au Risque : DANS LES LIMITES
RAISONNEMENT :
1. Signal fort (8/10) justifie un dimensionnement supérieur à la moyenne
2. Jeton à risque moyen-faible (4/10) permet une allocation complète
3. Régime de marché haussier permet un dimensionnement agressif
4. Aucune corrélation avec les positions existantes
AVERTISSEMENTS :
- Envisager d'entrer en plusieurs tranches (3) vs. une seule entrée
- Placer un stop-loss à -25% (perte max de 345 $)
</position_sizing>
2. Mesures de Risque du Portefeuille
<risk_metrics> Tableau de Bord des Risques en Temps Réel :
TABLEAU DE BORD DES RISQUES DU PORTEFEUILLE
═══════════════════════════════════════
POSITIONS (5 actives) :
Jeton | Taille | PnL | Risque | Poids
$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%
MESURES DE RISQUE :
├─ VaR Quotidienne (95%) : -1 240 $ (-6,2%)
├─ Drawdown Max (30j) : -18,3%
├─ Drawdown Actuel : 0% (au plus haut)
├─ Ratio de Sharpe (30j) : 2,14
├─ Ratio de Sortino : 2,87
├─ Bêta face à SOL : 1,34
MATRICE DE CORRÉLATION :
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
RISQUE DE CONCENTRATION :
├─ Première Position : 37% (SOL) - DANS LA LIMITE
├─ Top 3 Positions : 72,5% - ÉLEVÉ
├─ Indice Herfindahl : 0,23 - MODÉRÉ
└─ Exposition aux Meme : 63% - ÉLEVÉE
ALERTES :
⚠️ Forte corrélation entre MEME et WIF (0.85)
⚠️ Concentration du secteur Meme supérieure à 50%
Calculs de Risque :
interface PortfolioRisk {
// Value at Risk
var_95: number; // VaR quotidienne à 95% de confiance
var_99: number; // VaR quotidienne à 99% de confiance
cvar_95: number; // VaR Conditionnelle (déficit attendu)
// Risque de Performance
sharpe_ratio: number;
sortino_ratio: number;
max_drawdown: number;
current_drawdown: number;
// Risque de Corrélation
avg_correlation: number;
max_correlation: number;
correlation_cluster: string[]; // Groupes fortement corrélés
// Risque de Concentration
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 historique utilisant les 30 derniers jours de rendements
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. Rééquilibrage Dynamique
Cadre d'Allocation Cible :
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 dérive pour déclencher
}
Sortie de Rééquilibrage :
RECOMMANDATION DE RÉÉQUILIBRAGE
Allocation Actuelle vs. Cible :
Catégorie | Actuel | Cible | Dérive | Action
SOL | 37% | 30% | +7% | VENDRE 1 400 $
Memes | 63% | 50% | +13% | VENDRE 2 600 $
Stables | 0% | 20% | -20% | ACHETER 4 000 $
TRANSACTIONS SUGGÉRÉES :
1. VENDRE 15% de la position BONK (630 $) → USDC
2. VENDRE 20% de la position WIF (500 $) → USDC
3. VENDRE 10% de la position SOL (740 $) → USDC
4. Conserver les positions MEME et DOGE
5. Convertir les ventes en réserve de stablecoins USDC
PROJECTION POST-RÉÉQUILIBRAGE :
├─ SOL : 31% (cible : 30%)
├─ Memes : 48% (cible : 50%)
├─ Stables : 21% (cible : 20%)
└─ Réduction de la VaR : -18% (profil de risque amélioré)
4. Actions Défensives Automatisées
<defensive_actions> Système Kill Switch :
interface KillSwitchConfig {
daily_loss_limit: number; // % du portefeuille
weekly_loss_limit: number; // % du portefeuille
position_loss_limit: number; // % par position
drawdown_limit: number; // % depuis le pic
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Arrêter les nouvelles transactions à -10% sur la journée
weekly_loss_limit: 20, // Arrêter toute activité à -20% sur la semaine
position_loss_limit: 30, // Fermer automatiquement la position à -30%
drawdown_limit: 25, // Mode urgence à -25% depuis le pic
correlation_spike_action: 'alert',
auto_execute: false, // Nécessite confirmation en Phase 1
};
Actions Déclenchées :
| Déclencheur | Action | Sévérité |
|---|---|---|
| Position -25% | Avertissement stop-loss | MOYENNE |
| Position -30% | Fermeture auto (si activée) | HAUTE |
| Quotidien -10% | Arrêt des nouvelles transactions | HAUTE |
| Hebdomadaire -20% | Sortie vers les stables | CRITIQUE |
| Drawdown -25% | Liquidation d'urgence | CRITIQUE |
| Corrélation > 0.95 | Réduire une position | MOYENNE |
Sortie d'Alerte :
🚨 ALERTE DE RISQUE : LIMITE DE PERTE QUOTIDIENNE APPROCHANTE
PnL Quotidien Actuel : -8,7% (-1 740 $)
Limite Quotidienne : -10% (-2 000 $)
Marge Restante : 260 $
ACTIONS DÉCLENCHÉES :
1. ⏸️ Exécution de nouvelles transactions PAUSÉE
2. ⚠️ Examiner toutes les positions ouvertes
3. 📊 Augmentation de la fréquence de surveillance
RECOMMANDÉ :
- Examiner la position la moins performante (WIF : -15%)
- Envisager une sortie partielle si la tendance continue
- NE PAS faire la moyenne à la baisse
Tapez RESUME pour réactiver le trading
Tapez EXIT_ALL pour liquider les positions
</defensive_actions>
5. Analyse de Scénarios
<scenario_analysis> Tests de Résistance :
interface StressScenario {
name: string;
market_move: {
sol: number; // % de changement
memes: number; // % de changement vs SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Krach soudain SOL -30%',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Sortie de la rotation Meme',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Poursuite du Bull Run',
market_move: { sol: 50, memes: 100, correlation_shift: 0 },
probability: 0.15,
},
{
name: 'Événement Cygne Noir',
market_move: { sol: -60, memes: -80, correlation_shift: 0.3 },
probability: 0.01,
},
];
Sortie du Test de Résistance :
RÉSULTATS DU TEST DE RÉSISTANCE
Valeur Actuelle du Portefeuille : 20 000 $
SCÉNARIO | Impact sur le Portefeuille | Probabilité
Krach soudain SOL -30% | -7 200 $ (-36%) | 5%
Sortie de la rotation Meme | -5 040 $ (-25%) | 10%
Poursuite du Bull Run | +14 600 $ (+73%) | 15%
Événement Cygne Noir | -12 400 $ (-62%) | 1%
VALEUR ATTENDUE DU PORTEFEUILLE :
├─ Cas de Base : 20 000 $
├─ Attendue (pondérée proba) : 22 340 $ (+11,7%)
├─ Pire Cas (99%) : -12 400 $ (-62%)
└─ VaR (95%, 30j) : -4 800 $ (-24%)
ÉVALUATION DES RISQUES :
⚠️ Forte sensibilité à la rotation memes (scénario -25%)
⚠️ Exposition significative au cygne noir (-62%)
✓ Valeur attendue positive dans les scénarios de base
✓ Potentiel de hausse substantiel dans le cas haussier (+73%)
RECOMMANDATION :
Envisager de couvrir l'exposition aux memes avec des puts SOL
ou de réduire l'allocation aux memes de 10 à 15 % pour améliorer
le profil de risque.
</scenario_analysis>
Points d'Intégration
Le Gestionnaire de Risques fournit à :
- meme-executor : Tailles de position approuvées, niveaux de stop-loss
- meme-trader : Limites de position, capital disponible
- Tous les skills : État du portefeuille, alertes de risque
Utilisation en CLI
# Calculer la taille de position
npx tsx .claude/skills/risk-portfolio-manager/scripts/position-sizer.ts \
--signal 8 \
--risk-score 4 \
--portfolio-file ./portfolio.json \
--risk-mode moderate
# Obtenir les mesures de risque du portefeuille
npx tsx .claude/skills/risk-portfolio-manager/scripts/risk-metrics.ts \
--portfolio-file ./portfolio.json \
--include-correlation \
--var-confidence 95
# Recommandation de rééquilibrage
npx tsx .claude/skills/risk-portfolio-manager/scripts/rebalancer.ts \
--portfolio-file ./portfolio.json \
--target-allocation ./targets.json \
--threshold 5
# Exécuter des tests de résistance
npx tsx .claude/skills/risk-portfolio-manager/scripts/stress-test.ts \
--portfolio-file ./portfolio.json \
--scenarios default \
--output-format detailed
# Vérifier le statut du kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Barrières de Qualité
<validation_rules>
- Le dimensionnement des positions nécessite un score de qualité >= 85% sur les données de prix
- Les calculs de VaR nécessitent 30+ jours de données historiques propres
- La matrice de corrélation nécessite des données de prix synchronisées
- Toutes les recommandations incluent des niveaux de confiance
- Pas de dimensionnement de position sans vérification de détection rug </validation_rules>
Gestion des Erreurs
<error_recovery>
- Données de prix manquantes : Utiliser la dernière connue + avertissement de péremption
- Erreur de calcul : Repli conservateur (taille minimale)
- Conflit de kill switch : La sécurité l'emporte (arrêt > continuer)
- Qualité des données insuffisante : Refuser le dimensionnement, demander une actualisation </error_recovery>
<see_also>
- references/risk-models.md - Formules mathématiques
- references/allocation-templates.md - Portefeuilles cibles
- scripts/position-sizer.ts - Moteur de dimensionnement
- scripts/risk-metrics.ts - Calculs de risque
- scripts/kill-switch.ts - Sécurité automatisée </see_also>