Communitygithub.com

tradeblocks-org/tradeblocks-skills

Analyse de portefeuille pour stratégies de trading. Explore la corrélation, la diversification et les caractéristiques de performance combinées. À utiliser pour comprendre les relations entre stratégies, explorer les effets de diversification ou analyser la composition du portefeuille.

Qu'est-ce que tradeblocks-skills ?

Cette compétence d'agent IA, conçue pour l'analyse de portefeuille de trading, fournit des données historiques complètes pour évaluer et optimiser un ensemble de stratégies de trading. Elle s'appuie sur le serveur MCP TradeBlocks et est idéale pour les utilisateurs souhaitant comprendre comment leurs stratégies interagissent, identifier les risques de concentration et améliorer les rendements ajustés au risque. La compétence propose sept étapes clés : un bilan de santé global du portefeuille, une analyse détaillée des corrélations entre paires, une carte structurelle montrant la couverture par régime de volatilité, une analyse de contribution marginale pour chaque stratégie, un conseiller en allocation par régime, une détection de similarité entre stratégies, et une simulation de modification d'allocation (scénarios « what-if »). Les résultats incluent des notes de A à F sur neuf dimensions (diversification, risque de queue, robustesse, etc.), des alertes spécifiques, et des métriques clés comme le Sharpe, Sortino et le drawdown maximum. La compétence est particulièrement utile pour les traders et gestionnaires de portefeuille qui utilisent plusieurs stratégies et veulent éliminer les redondances, couvrir les angles morts, et valider que leur portefeuille est aligné avec leur tolérance au risque.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tradeblocks-org/tradeblocks-skills/tree/HEAD/skills/portfolio

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Analyse de Portefeuille

Explorez comment les stratégies se relient entre elles et ce que leur combinaison signifie pour les caractéristiques du portefeuille.

Ce que fait cette compétence

Elle met en lumière les données pour aider à comprendre les dynamiques du portefeuille :

  • Bilan de santé : Évaluation complète du portefeuille en un seul appel
  • Corrélation : Comment les stratégies évoluent-elles les unes par rapport aux autres ?
  • Structure : Où le portefeuille présente-t-il des chevauchements ou des angles morts ?
  • Contribution marginale : Quelles stratégies améliorent ou dégradent les rendements ajustés au risque ?
  • Similarité : Y a-t-il des stratégies redondantes ?
  • Simulation « what-if » : Comment la modification des allocations affecterait-elle le portefeuille ?

Prérequis

  • Serveur MCP TradeBlocks en fonctionnement
  • Plusieurs blocs de stratégie ou un bloc multi-stratégie chargé
  • Profils de stratégie recommandés pour l'analyse de couverture par régime et de structure

Processus

Étape 1 : Bilan de santé du portefeuille

Commencez par portfolio_health_check pour une évaluation complète en un seul appel.

Paramètres clés :

  • blockId : Nom du dossier du bloc
  • correlationThreshold : Signaler les paires au-dessus de ce seuil (par défaut : 0,5)
  • tailDependenceThreshold : Signaler les paires de dépendance extrême au-dessus de ce seuil (par défaut : 0,5)
  • profitProbabilityThreshold : Avertissement de probabilité de profit Monte Carlo (par défaut : 0,95)
  • wfeThreshold : Avertissement d'efficacité walk-forward (par défaut : -0,15)

L'outil renvoie un rapport structuré :

  • Verdict : SAIN / PRÉOCCUPATIONS_MODÉRÉES / PRÉOCCUPATIONS_SIGNIFICATIVES
  • Notes : A-F sur 9 dimensions :
DimensionCe qu'elle mesure
DiversificationCorrélation entre paires de stratégies
Risque de queueRisque de co-mouvement extrême conjoint
RobustesseEfficacité walk-forward (hors échantillon vs dans échantillon)
CohérenceProbabilité de profit Monte Carlo
Couverture par régimePerformance des stratégies selon les régimes VIX
Couverture des joursCouverture des jours de trading sur la semaine
Risque de concentrationAllocation par structure, sous-jacent, DTE
Risque de corrélationChevauchement conscient des profils (même sous-jacent + DTE + jours)
Alignement du scalingÉcart de P&L par contrat entre backtest et live
  • Alertes : Avertissements spécifiques avec détails (paires à forte corrélation, paires à forte dépendance extrême, etc.)
  • Chiffres clés : Sharpe, Sortino, drawdown maximum, corrélation moyenne, dépendance extrême moyenne, stats MC, WFE

Présentez le verdict, signalez toute note inférieure à B et détaillez les avertissements spécifiques.

Étape 2 : Analyse de corrélation

Utilisez get_correlation_matrix pour des données détaillées de corrélation par paire.

Paramètres clés :

  • blockId : Nom du dossier du bloc
  • method : "kendall" (robuste, basé sur les rangs, par défaut), "spearman" (rangs), "pearson" (linéaire)
  • alignment : "shared" (uniquement les jours où les deux ont tradé) ou "zero-pad" (remplir les manquants avec 0)
  • timePeriod : "daily", "weekly" ou "monthly" agrégation
  • normalization : "raw" (P&L absolu), "margin" (P&L/marge), "notional" (P&L/notionnel)
  • minSamples : Nombre minimum de périodes partagées pour un calcul valide (par défaut : 10)
  • highlightThreshold : Signaler les paires au-dessus de ce seuil (par défaut : 0,7)

Interprétation des valeurs de corrélation :

CorrélationCe qu'elle indique
< 0,2Très faible – les stratégies évoluent de manière indépendante
0,2 - 0,4Faible – mouvements principalement indépendants
0,4 - 0,6Modérée – certains comportements partagés
0,6 - 0,8Élevée – mouvements partagés significatifs
> 0,8Très élevée – les stratégies se comportent de manière similaire

Voir references/correlation.md pour comprendre pourquoi le tau de Kendall est souvent plus informatif que le coefficient de Pearson pour les rendements de trading.

Étape 3 : Carte structurelle du portefeuille

Utilisez portfolio_structure_map pour visualiser une matrice Vol_Régime x Direction_Tendance sur toutes les stratégies profilées.

Paramètres clés :

  • blockId : Optionnel – omettre pour agréger sur tous les blocs
  • minTrades : Seuil d'avertissement pour données insuffisantes (par défaut : 10)

L'outil renvoie :

  • Une matrice de 18 cellules (6 Vol_Régimes x 3 Directions_Tendance) avec des statistiques par stratégie
  • Détection de chevauchement : 2+ stratégies actives dans la même cellule
  • Angles morts : Cellules sans aucun trade sur l'ensemble des stratégies
  • Avertissements de données insuffisantes : Cellules avec moins de trades que le seuil

C'est l'outil clé pour comprendre la construction du portefeuille – où le portefeuille a une couverture et où il n'en a pas.

Étape 4 : Contribution marginale

Utilisez marginal_contribution pour voir comment chaque stratégie affecte les rendements ajustés au risque du portefeuille.

Paramètres clés :

  • blockId : Nom du dossier du bloc
  • targetStrategy : Calculer pour une stratégie spécifique uniquement (optionnel)
  • topN : Nombre de principaux contributeurs à retourner (par défaut : 5)

L'outil renvoie :

  • Sharpe et Sortino de base du portefeuille
  • Impact marginal du Sharpe et du Sortino par stratégie
  • Stratégies les plus bénéfiques et les moins bénéfiques

Interprétation :

  • Sharpe marginal négatif : Retirer cette stratégie DIMINUERAIT le Sharpe du portefeuille – elle contribue positivement
  • Sharpe marginal positif : Retirer cette stratégie AUGMENTERAIT le Sharpe du portefeuille – elle pourrait nuire aux rendements ajustés au risque
  • Note : la contribution marginale mesure l'impact ajusté au risque, pas le P&L absolu. Une stratégie rentable peut nuire au Sharpe si elle ajoute de la volatilité.

Étape 5 : Conseiller en allocation par régime

Utilisez regime_allocation_advisor pour recouper les régimes attendus des profils de stratégie avec les performances réelles.

Paramètres clés :

  • blockId : Optionnel – omettre pour agréger sur toutes les stratégies profilées
  • minTrades : Nombre minimum de trades par cellule de régime pour des statistiques fiables (par défaut : 5)

L'outil renvoie par stratégie et par régime :

  • Si le régime était attendu (selon le profil) ou inattendu
  • Taux de réussite, P&L, nombre de trades dans ce régime
  • Classifications :
    • thesis_aligned : La stratégie se comporte comme attendu dans ses régimes cibles
    • thesis_violation : La stratégie sous-performe dans les régimes qu'elle devrait gérer
    • hidden_edge : La stratégie performe bien dans des régimes non marqués comme attendus

Mettez en évidence les violations de thèse (stratégies qui échouent là où elles ne devraient pas) et les avantages cachés (opportunités non capturées par le profil).

Étape 6 : Similarité des stratégies

Utilisez strategy_similarity pour détecter les stratégies potentiellement redondantes.

Paramètres clés :

  • blockId : Nom du dossier du bloc
  • correlationThreshold : Corrélation minimale pour signaler (par défaut : 0,7)
  • tailDependenceThreshold : Dépendance extrême minimale pour signaler (par défaut : 0,5)
  • minSharedDays : Nombre minimum de jours de trading partagés (par défaut : 30)
  • topN : Nombre de paires les plus similaires (par défaut : 5)

L'outil renvoie :

  • Les paires de stratégies les plus similaires classées par score de similarité combiné
  • Corrélation, dépendance extrême et chevauchement de jours de trading pour chaque paire
  • Alertes pour les stratégies qui pourraient ajouter du risque sans bénéfice de diversification

Si deux stratégies sont fortement corrélées ET ont une forte dépendance extrême, elles subiront probablement des drawdowns ensemble – la « diversification » entre elles est illusoire.

Étape 7 : Simulation « what-if » (modification d'allocation)

Utilisez what_if_scaling pour explorer les changements d'allocation.

Paramètres clés :

  • blockId : Nom du dossier du bloc
  • strategyWeights : Poids par stratégie, ex. {"5/7 17D": 0.5, "Pickle RIC": 1.5}. Les non spécifiés par défaut à 1,0. Poids 0 = exclure.
  • strategies : Mode multi-stratégie – tableau avec source de bloc et facteur d'échelle par stratégie
  • showUncapped : Afficher également les résultats sans le plafond maxContractsPerTrade

L'outil renvoie :

  • Comparaison avant/après des métriques du portefeuille
  • Détail par stratégie aux nouveaux poids
  • Sensible aux profils : respecte les plafonds maxContractsPerTrade des profils
  • Alertes lorsque ignoreMarginReq est défini

Scénarios courants :

  • « Et si je retirais cette stratégie ? » → mettre son poids à 0
  • « Et si je doublais cette allocation ? » → mettre le poids à 2,0
  • « Et si je réduisais de moitié tout sauf mon meilleur performer ? » → ajuster les poids en conséquence

Étape 8 : Présenter les conclusions

Synthétisez les données :

Santé du portefeuille :

  • Verdict : [SAIN / PRÉOCCUPATIONS_MODÉRÉES / PRÉOCCUPATIONS_SIGNIFICATIVES]
  • Dimensions nécessitant une attention : [toute note inférieure à B]
  • Alertes clés : [avertissements spécifiques]

Résultats de corrélation :

  • Corrélation moyenne entre paires : [valeur]
  • Paire la plus corrélée : [paire] à [valeur]
  • Paire la moins corrélée : [paire] à [valeur]

Structure :

  • Angles morts de régime : [cellules sans couverture]
  • Zones de chevauchement : [cellules avec 2+ stratégies]
  • Concentration : [par sous-jacent, DTE, type de structure]

Contribution marginale :

  • Plus bénéfique : [stratégie] (Sharpe marginal : [valeur])
  • Moins bénéfique : [stratégie] (Sharpe marginal : [valeur])

Ce qui ressort :

  • [Schémas notables]
  • [Paires de stratégies redondantes le cas échéant]
  • [Violations de thèse ou avantages cachés]

Présentez-les comme des perspectives issues des données historiques. L'utilisateur peut décider ce qui correspond à sa tolérance au risque et à ses objectifs de portefeuille.

Références d'interprétation

Compétences connexes

Après l'analyse de portefeuille :

  • /tradeblocks:compare – Comparaison approfondie de paires de stratégies ou de blocs spécifiques
  • /tradeblocks:risk – Dimensionnement des positions et analyse de Kelly
  • /tradeblocks:health-check – Métriques complètes sur une stratégie individuelle

Remarques

  • La corrélation est mesurée sur les rendements agrégés, pas trade par trade
  • Les schémas de corrélation passés peuvent ne pas persister dans les conditions de marché futures
  • La corrélation extrême (comportement en période de crise) est souvent plus élevée que la corrélation normale
  • Une faible corrélation ne garantit pas une protection – les deux peuvent perdre pour des raisons différentes
  • La taille de l'échantillon compte – 10 points de données partagés est le minimum, plus c'est mieux
  • Les profils de stratégie sont nécessaires pour l'analyse de couverture par régime, la carte structurelle et l'alignement du scaling

Skills associés