Portefeuille — optimisation équipondérée vs max Sharpe
Voir reference.md pour les formats de tickers.
Prérequis
GET http://localhost:8000/health
Doit retourner {"status": "ok"}. Sinon : dire à l'utilisateur d'exécuter python backend/run.py.
Étape 1 — Analyser les tickers
- Extraire tous les symboles de ticker du message. Mettre en majuscules, supprimer les espaces.
- Minimum 2, maximum 10. Les doublons sont rejetés par l'API — dédupliquer silencieusement et le noter.
- Si moins de 2 tickers sont fournis, en demander plus avant de continuer.
Étape 2 — Soumettre le job de portefeuille
POST http://localhost:8000/api/v1/portfolio
Content-Type: application/json
{"tickers": ["T1", "T2", "..."], "query": "Optimiser l'allocation pour un rendement maximal ajusté au risque."}
Réponse : {"job_id": "<uuid>", "status": "pending", "message": "..."}
Dire à l'utilisateur :
Job de portefeuille soumis pour {n} tickers. Récupération de l'historique des prix sur 1 an et optimisation… généralement 15–30 s.
Étape 3 — Vérifier le statut
GET http://localhost:8000/api/v1/status/{job_id}
Toutes les 5 s jusqu'à completed ou failed.
Étape 4 — Récupérer le résultat
GET http://localhost:8000/api/v1/result/{job_id}
Cas d'erreur
Si le résultat contient une clé error de premier niveau (par ex. "Au moins deux tickers avec un historique de prix chevauchant sont requis"), expliquer le problème en langage clair et s'arrêter :
L'optimisation de portefeuille nécessite au moins deux tickers avec un historique de transactions chevauchant au cours de la dernière année. Vérifiez que tous les tickers sont valides et ont suffisamment d'historique.
Table des champs
| Champ | Chemin | Notes |
|---|---|---|
| Tickers utilisés | tickers | Peut différer de l'entrée si certains n'avaient pas de données |
| Lignes de prix | price_rows | Nombre de jours de trading chevauchant |
| Poids équipondérés | equal_weight.weights | {ticker: décimal} — multiplier par 100 pour obtenir % |
| Rendement équipondéré | equal_weight.annual_return_pct | Déjà en % |
| Volatilité équipondérée | equal_weight.annual_volatility_pct | Déjà en % |
| Sharpe équipondéré | equal_weight.sharpe_ratio | Annualisé, taux sans risque = 5% |
| VaR équipondérée | equal_weight.var_95_daily_pct | Déjà en %, quotidienne |
| Poids optimaux | optimal.weights | {ticker: décimal} — multiplier par 100 pour obtenir % |
| Rendement optimal | optimal.annual_return_pct | Déjà en % |
| Volatilité optimale | optimal.annual_volatility_pct | Déjà en % |
| Sharpe optimal | optimal.sharpe_ratio | Annualisé, taux sans risque = 5% |
| VaR optimale | optimal.var_95_daily_pct | Déjà en %, quotidienne |
| Optimiseur réussi | optimal.optimizer_success | booléen |
| Message de l'optimiseur | optimal.optimizer_message | Pertinent uniquement si success = false |
| Matrice de corrélation | correlation_matrix | Dictionnaire imbriqué {ticker: {ticker: corr}} |
| VaR du portefeuille | portfolio_var_95_daily_pct | VaR quotidienne du portefeuille optimal, déjà en % |
Étape 5 — Interpréter et présenter
Poids
Convertir les poids décimaux en pourcentages (poids * 100, 1 décimale).
Si un poids est à 0.0% dans le portefeuille optimal, noter que l'optimiseur a exclu cet actif (rendement insuffisant ou corrélation élevée avec d'autres).
Ratio de Sharpe
- < 0 : le portefeuille rapporte moins que le taux sans risque (5%) ; reconsidérer la composition.
- 0–1 : rendement ajusté au risque médiocre.
- 1–2 : bon.
-
2 : excellent.
Comparer le Sharpe équipondéré avec le Sharpe optimal. Si le Sharpe optimal est plus élevé, les poids concentrés sont justifiés. Si similaires (différence < 0.1), le portefeuille équipondéré est presque aussi efficace et plus simple à rééquilibrer.
Matrice de corrélation
Interpréter les corrélations par paires :
-
0.80 : fortement corrélées — ces deux actifs évoluent presque ensemble ; détenir les deux ajoute peu de diversification.
- 0.50–0.80 : corrélation modérée — une certaine co-mouvance, bénéfice partiel de diversification.
- < 0.30 : faible corrélation — bonne paire de diversification.
- Proche de 0 ou négatif : fort diversificateur.
Identifier la paire la plus corrélée et la paire la moins corrélée et les mentionner dans la narration.
VaR
VaR quotidienne à 95% de confiance : sur le pire 1 jour de trading sur 20, le portefeuille a historiquement perdu environ {portfolio_var_95_daily_pct}%. Annualiser une estimation approximative uniquement si utile : multiplier la VaR quotidienne par √252 ≈ 15.9 pour approximer la VaR annuelle (note : il s'agit d'une approximation grossière).
Échec de l'optimiseur
Si optimal.optimizer_success = false, dire :
L'optimiseur n'a pas convergé ({optimal.optimizer_message}). Les poids optimaux sont revenus aux poids équipondérés — traiter la colonne "optimale" comme équipondérée.
Actions indiennes dans le portefeuille
Si un ticker se termine par .NS ou .BO, noter que les actifs libellés en INR introduisent un risque de change pour les investisseurs basés en USD. La matrice de corrélation reflète les rendements en devise locale et ne capture pas la volatilité INR/USD.
Étape 6 — Recommandation
Après avoir présenté les données, donner une recommandation en 2–3 phrases :
- Indiquer s'il faut utiliser les poids équipondérés ou optimaux et pourquoi (comparaison Sharpe).
- Nommer les 1–2 principales pondérations du portefeuille optimal et ce qui motive leur poids.
- Noter tout problème de diversification (paires fortement corrélées) ou considération de change.
Sortie
# Analyse de portefeuille — {tickers séparés par des virgules}
Historique des prix : {price_rows} jours de trading chevauchant (≈ {price_rows/252:.1f} ans)
---
## Comparaison des allocations
| Ticker | Poids équipondéré | Poids optimal |
|----------|-------------------|---------------|
| {ticker} | {ew*100:.1f}% | {ow*100:.1f}% |
| … | … | … |
---
## Métriques du portefeuille
| Métrique | Équipondéré | Optimal (max Sharpe) |
|---------------------------|-------------|----------------------|
| Rendement annuel attendu | {eq_ret}% | {opt_ret}% |
| Volatilité annuelle | {eq_vol}% | {opt_vol}% |
| Ratio de Sharpe | {eq_sh} | {opt_sh} |
| VaR (95%, 1 jour) | {eq_var}% | {opt_var}% |
{Si optimizer_success = false :
> ⚠ L'optimiseur n'a pas convergé ({optimizer_message}) — les poids optimaux sont égaux aux poids équipondérés.}
---
## Matrice de corrélation
| Ticker | {t1} | {t2} | … |
|--------|------|------|---|
| {t1} | 1.00 | … | … |
| … | … | … | … |
**Paire la plus corrélée :** {t_a} / {t_b} à {corr:.2f} — bénéfice de diversification limité.
**Paire la moins corrélée :** {t_c} / {t_d} à {corr:.2f} — bénéfice de diversification le plus fort.
---
## Recommandation
{2–3 phrases : choix équipondéré vs optimal, justification des principales pondérations, éventuelle mise en garde sur la diversification ou le change.}
{Si des tickers .NS/.BO :
> ⚠ Les actions indiennes ({liste}) sont libellées en INR. La matrice de corrélation reflète les rendements en devise locale et ne capture pas le risque de change INR/USD pour les investisseurs basés en USD.}
Récupération d'erreurs
| Situation | Action |
|---|---|
| Erreur de premier niveau dans le résultat | Expliquer le problème ; demander à l'utilisateur de vérifier les tickers et réessayer |
Un ticker retiré de la liste tickers | Noter qu'il avait un historique de prix insuffisant ou non chevauchant |
optimizer_success = false | Expliquer le repli sur les poids équipondérés ; afficher quand même les métriques |
Un seul ticker .NS/.BO | Noter le risque de change ; l'afficher dans la matrice de corrélation comme d'habitude |