Gestionnaire de Portefeuille à Risque - Contrôle des Risques Piloté par l'IA
Couche systématique de gestion des risques située entre la génération de signaux et l'exécution des ordres. Utilise des approches data-driven 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 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 en provenance du 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é) :
Taille Optimale = (Taux de Réussite * Gain Moyen - (1 - Taux de Réussite) * Perte Moyenne) / Gain Moyen
Taille Ajustée = Kelly * Multiplicateur Fractionnaire (0.25-0.5 pour la sécurité)
Matrice de Dimensionnement Ajusté au Risque :
| Tolérance au Risque | Taille de Base | Position Maximale Unique | Exposition Corrélée Maximale |
|---|---|---|---|
| Conservateur | 0.5-1% | 2% | 5% |
| Modéré | 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 Token / 20) * Multiplicateur de Marché
Où :
- Force du Signal : 0.5-1.5 (faible à fort)
- Risque Token : 1-10 (faible = plus sûr)
- Multiplicateur de Marché : 0.5 (volatile) à 1.2 (tendance)
Format de Sortie :
RECOMMANDATION DE TAILLE DE POSITION
Token : $MEME
Force du Signal : 8/10
Score de Risque du Token : 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é au Risque : DANS LES LIMITES
RAISONNEMENT :
1. Signal fort (8/10) justifie une taille supérieure à la moyenne
2. Token à risque faible-moyen (4/10) permet une allocation complète
3. Marché haussier autorise un dimensionnement agressif
4. Pas de corrélation avec les positions existantes
AVERTISSEMENTS :
- Envisager une entrée échelonnée (3 tranches) plutôt qu'une entrée unique
- Définir un stop-loss à -25 % (perte max de 345 $)
</position_sizing>
2. Mesures de Risque du Portefeuille
<risk_metrics> Tableau de Bord du Risque en Temps Réel :
TABLEAU DE BORD DU RISQUE DU PORTEFEUILLE
═══════════════════════════════════════════════
POSITIONS (5 actives) :
Token | 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 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
├─ Top 3 Positions : 72,5 % - ÉLEVÉ
├─ Indice Herfindahl : 0,23 - MODÉRÉ
└─ Exposition aux Meme : 63 % - ÉLEVÉ
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 du 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 APRÈS RÉÉQUILIBRAGE :
├─ SOL : 31 % (cible : 30 %)
├─ Memes : 48 % (cible : 50 %)
├─ Stables : 21 % (cible : 20 %)
└─ Réduction VaR : -18 % (profil de risque amélioré)
4. Actions Défensives Automatisées
<defensive_actions> Système de Coupe-Circuit :
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, // Stopper les nouvelles transactions à -10 % par jour
weekly_loss_limit: 20, // Stopper toute activité à -20 % par semaine
position_loss_limit: 30, // Fermer automatiquement une 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 automatique (si activée) | ÉLEVÉE |
| Quotidien -10 % | Stopper les nouvelles transactions | ÉLEVÉE |
| Hebdomadaire -20 % | Sortir 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 du jour actuel : -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. ⚠️ Passer en revue toutes les positions ouvertes
3. 📊 Augmentation de la fréquence de surveillance
RECOMMANDÉ :
- Passer en revue la position la moins performante (WIF : -15 %)
- Envisager une sortie partielle si la tendance continue
- NE PAS moyenner à 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; // variation en %
memes: number; // variation en % par rapport à 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 Meme vers sortie',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Continuation haussière',
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 éclair SOL -30% | -7 200 $ (-36 %) | 5 %
Rotation Meme vers sortie | -5 040 $ (-25 %) | 10 %
Continuation haussière | +14 600 $ (+73 %) | 15 %
Événement Cygne Noir | -12 400 $ (-62 %) | 1 %
VALEUR ATTENDUE DU PORTEFEUILLE :
├─ Cas de base : 20 000 $
├─ Attendu (pondéré par probabilité) : 22 340 $ (+11,7 %)
├─ Pire cas (99 %) : -12 400 $ (-62 %)
└─ VaR (95 %, 30j) : -4 800 $ (-24 %)
ÉVALUATION DU RISQUE :
⚠️ Forte sensibilité à la rotation Meme (scénario à -25 %)
⚠️ Exposition significative au cygne noir (-62 %)
✓ Valeur attendue positive dans les scénarios de base
✓ Potentiel haussier substantiel (+73 %)
RECOMMANDATION :
Envisager de couvrir l'exposition aux Meme avec des puts sur SOL
ou de réduire l'allocation Meme 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
- Tous les skills : État du portefeuille, alertes de risque
Utilisation en Ligne de Commande
# 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 l'état du coupe-circuit
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Garde-fous 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 rug </validation_rules>
Gestion des Erreurs
<error_recovery>
- Données de prix manquantes : Utiliser la dernière valeur connue + avertissement de péremption
- Erreur de calcul : Fallback conservateur (taille minimale)
- Conflit de coupe-circuit : La sécurité gagne (stopper > continuer)
- Qualité des données insuffisante : Rejeter le dimensionnement, demander un rafraîchissement </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>