Que fait Gestionnaire de Portefeuille à Risque - Contrôle Piloté par IA ?
Couche systématique de gestion des risques situé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 les risques 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. Aucun trade individuel 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 issu de meme-trader
token_risk_score: number; // 1-10 issu 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 Gain * Gain Moyen - (1 - Taux de Gain) * Perte Moyenne) / Gain Moyen
Taille Ajustée = Kelly * Multiplicateur Fractionnel (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 |
|---|---|---|---|
| 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 Jeton / 20) * Multiplicateur de Marché
Où :
- Force du Signal : 0.5-1.5 (faible à fort)
- Risque 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é au Risque : DANS LES LIMITES
RAISONNEMENT :
1. Signal fort (8/10) justifie un dimensionnement supérieur à la moyenne
2. Jeton à risque faible-moyen (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 :
- Envisagez une entrée progressive (3 tranches) plutôt qu'une seule entrée
- 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 Max (30j) : -18.3%
├─ Drawdown Actuel : 0% (au plus haut historique)
├─ 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 Memes : 63% - ÉLEVÉE
ALERTES :
⚠️ Corrélation élevée entre MEME et WIF (0.85)
⚠️ Concentration sectorielle des Memes au-dessus de 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 hautement 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 rendements des 30 derniers jours
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 | Actuelle | 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 stablecoin 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% en journée
weekly_loss_limit: 20, // Arrêter toute activité à -20% en semaine
position_loss_limit: 30, // Fermeture automatique de la position à -30%
drawdown_limit: 25, // Mode urgence à -25% du sommet
correlation_spike_action: 'alert',
auto_execute: false, // Nécessite une 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% | Arrêter les nouvelles transactions | ÉLEVÉE |
| 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. 📊 Fréquence de surveillance accrue
RECOMMANDATIONS :
- 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 variation
memes: number; // % de variation par rapport à SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Crash éclair SOL -30%',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotation des Memes',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Poursuite de la Hausse',
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 Portefeuille | Probabilité
Crash éclair SOL -30% | -7 200 $ (-36%) | 5%
Rotation des Memes | -5 040 $ (-25%) | 10%
Poursuite de la Hausse | +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 DES RISQUES :
⚠️ Sensibilité élevée à la rotation des memes (scénario -25%)
⚠️ Exposition significative au cygne noir (-62%)
✓ Valeur attendue positive dans les scénarios de base
✓ Potentiel de hausse substantiel en cas de hausse (+73%)
RECOMMANDATION :
Envisagez de couvrir l'exposition aux memes avec des options de vente 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 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 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 le statut du kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
--portfolio-file ./portfolio.json \
--check-status
Portes 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 rug </validation_rules>
Gestion des Erreurs
<error_recovery>
- Données de prix manquantes : Utiliser la dernière connue + avertissement de données obsolètes
- 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>