Gestionnaire de Portefeuille à Risque - Contrôle des Risques par IA
Couche de gestion systématique 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 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 provenant de meme-trader
token_risk_score: number; // 1-10 provenant 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ée au Risque :
| Tolérance au Risque | Taille de Base | Position Unique Maximale | Exposition Corrélée Maximale |
|---|---|---|---|
| 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 Token / 20) * Multiplicateur de Marché
Où :
- Force du Signal : 0.5-1.5 (faible à fort)
- Risque Token : 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 une taille supérieure à 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 :
- Envisager un scaling in (3 tranches) plutôt qu'une entrée unique
- Définir 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 sommet)
├─ 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 de Herfindahl : 0,23 - MODÉRÉ
└─ Exposition Meme : 63 % - ÉLEVÉE
ALERTES :
⚠️ Corrélation élevée entre MEME et WIF (0,85)
⚠️ Concentration du secteur Meme supérieure à 50 %
Calculs de Risque :
interface PortfolioRisk {
// Valeur à Risque
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 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 | 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 % 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 % par rapport au sommet
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) | ÉLEVÉE |
| Quotidienne -10 % | Arrêt des nouvelles transactions | ÉLEVÉE |
| Hebdomadaire -20 % | Sortie vers stables | CRITIQUE |
| Drawdown -25 % | Liquidation d'urgence | CRITIQUE |
| Corrélation > 0,95 | Réduire une position | MOYENNE |
Sortie d'Alerte :
🚨 ALERTE RISQUE : LIMITE DE PERTE QUOTIDIENNE APPROCHÉE
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
RECOMMANDÉ :
- Examiner la position la moins performante (WIF : -15 %)
- Envisager une sortie partielle si la tendance se poursuit
- NE PAS acheter pour baisser 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 variation
memes: number; // % de variation par rapport à SOL
correlation_shift: number;
};
probability: number;
}
const stressScenarios: StressScenario[] = [
{
name: 'Krach Flash SOL -30 %',
market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
probability: 0.05,
},
{
name: 'Rotation Hors Meme',
market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
probability: 0.10,
},
{
name: 'Poursuite du Marché 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 Portefeuille | Probabilité
Krach Flash SOL -30 % | -7 200 $ (-36 %) | 5 %
Rotation Hors Meme | -5 040 $ (-25 %) | 10 %
Poursuite Marché 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é 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 haussier (+73 %)
RECOMMANDATION :
Envisager de couvrir l'exposition aux memes avec des puts SOL ou de réduire
l'allocation 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
- Toutes les compétences : État du portefeuille, alertes de risque
Utilisation en Ligne de Commande
# Calculer la taille d'une 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
Gardes 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 les dernières connues + avertissement de péremption
- Erreur de calcul : Repli conservateur (taille minimale)
- Conflit de kill switch : La sécurité l'emporte (arrêt > continuation)
- 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>