Gestionnaire de Risque de Portefeuille - Contrôle de Risque Piloté par IA
Couche de gestion systématique des risques qui se situe entre la génération des 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 doit menacer le portefeuille.
Déclencheurs d'Activation
Capacités Principales
1. Moteur de Dimensionnement des Positions
<position_sizing> Méthodes de Dimensionnement :
interface PositionSizeRequest {
signal_strength: number; // 0-1 provenant du trader de memes
token_risk_score: number; // 1-10 provenant de la détection de 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é) :
Taille Optimale = (Taux de Gain * Gain Moyen - (1 - Taux de Gain) * Perte Moyenne) / Gain Moyen
Taille Ajustée = Kelly * Multiplicateur Fractionnaire (0,25-0,5 pour la sécurité)
Matrice de Dimensionnement Ajustée au Risque :
| Tolérance au Risque | Taille de Base | Position Unique Max | Exposition Corrélée Max |
|---|---|---|---|
| Conservative | 0,5-1% | 2% | 5% |
| Modérée | 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 à forte)
- 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é : HAUSSIER
TAILLE RECOMMANDÉE :
├─ Pourcentage : 2,3 % du portefeuille
├─ Montant : 460 $ (sur un portefeuille de 20 000 $)
├─ Maximum Autorisé : 800 $ (limite de 4 %)
└─ Ajusté au Risque : DANS LES LIMITES
RAISONNEMENT :
1. Signal fort (8/10) justifie un dimensionnement au-dessus de la moyenne
2. Jeton à risque faible-moyen (4/10) permet une allocation complète
3. Le régime de marché haussier autorise un dimensionnement agressif
4. Aucune corrélation avec les positions existantes
AVERTISSEMENTS :
- Envisagez une entrée progressive (3 tranches) plutôt qu'une entrée unique
- Définissez un stop-loss à -25 % (perte max de 345 $)
</position_sizing>
2. Métriques 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 %
MÉTRIQUES DE RISQUE :
├─ VaR Quotidienne (95 %) : -1 240 $ (-6,2 %)
├─ Drawdown Maximum (30j) : -18,3 %
├─ Drawdown Actuel : 0 % (au plus haut)
├─ Ratio de Sharpe (30j) : 2,14
├─ Ratio de Sortino : 2,87
├─ Bêta par rapport à 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 :
├─ Position Principale : 37 % (SOL) - DANS LA LIMITE
├─ 3 Premières Positions : 72,5 % - ÉLEVÉ
├─ Indice Herfindahl : 0,23 - MODÉRÉ
└─ Exposition aux Memes : 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; // % par rapport au sommet
correlation_spike_action: 'alert' | 'reduce' | 'exit';
auto_execute: boolean;
}
const defaultKillSwitch: KillSwitchConfig = {
daily_loss_limit: 10, // Arrêter les nouvelles transactions à -10 % par jour
weekly_loss_limit: 20, // Arrêter toute activité à -20 % par semaine
position_loss_limit: 30, // Fermer automatiquement la position à -30 %
drawdown_limit: 25, // Mode urgence à -25 % du sommet
correlation_spike_action: 'alert',
auto_execute: false, // Nécessite confirmation en Phase 1
};
Actions Déclenchées :
| Déclencheur | Action | Gravité |
|---|---|---|
| Position -25 % | Avertissement stop-loss | MOYENNE |
| Position -30 % | Fermeture automatique (si activée) | HAUTE |
| Quotidien -10 % | Arrêt des nouvelles transactions | HAUTE |
| Hebdomadaire -20 % | Sortie vers des 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 APPROCHANT
PnL Actuel du Jour : -8,7 % (-1 740 $)
Limite Quotidienne : -10 % (-2 000 $)
Tampon Restant : 260 $
ACTIONS DÉCLENCHÉES :
1. ⏸️ Exécution de nouvelles transactions PAUSÉE
2. ⚠️ Examinez toutes les positions ouvertes
3. 📊 Fréquence de surveillance augmentée
RECOMMANDÉ :
- Examinez la position la moins performante (WIF : -15 %)
- Envisagez une sortie partielle si la tendance se poursuit
- N'ACHETEZ PAS pour réduire le prix moyen
Tapez RESUME pour réactiver les transactions
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 Éclair SOL -30 %',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotation Hors des Memes',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Poursuite du Marché Hausster',
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 des Tests de Résistance :
RÉSULTATS DES TESTS DE RÉSISTANCE
Valeur Actuelle du Portefeuille : 20 000 $
SCÉNARIO | Impact sur le Portefeuille | Probabilité
Krach Éclair SOL -30 % | -7 200 $ (-36 %) | 5 %
Rotation Hors des Memes | -5 040 $ (-25 %) | 10 %
Poursuite du Marché Hausster | +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 par proba) : 22 340 $ (+11,7 %)
├─ Pire Cas (99 %) : -12 400 $ (-62 %)
└─ VaR (95 %, 30j) : -4 800 $ (-24 %)
ÉVALUATION DU RISQUE :
⚠️ Forte sensibilité à la rotation des memes (scénario -25 %)
⚠️ Exposition significative au cygne noir (-62 %)
✓ Valeur attendue positive dans les scénarios de base
✓ Hausse potentielle substantielle en cas de hausse (+73 %)
RECOMMANDATION :
Envisagez 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 Risque fournit à :
- meme-executor : Tailles de position approuvées, niveaux de stop-loss
- meme-trader : Limites de position, capital disponible
- Toutes les compétences : État du portefeuille, alertes de risque
Utilisation en CLI
# Calculer la taille de la 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 métriques 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 l'état 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
- Aucun dimensionnement de position sans vérification de détection de rug </validation_rules>
Gestion des Erreurs
<error_recovery>
- Données de prix manquantes : Utiliser la dernière connue + avertissement de vétusté
- Erreur de calcul : Repli conservateur (taille minimale)
- Conflit de kill switch : La sécurité l'emporte (arrêt > continuer)
- Qualité des données insuffisante : Rejeter 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>