Gestionnaire de Portefeuille
Un outil en ligne de commande pour suivre des portefeuilles d'actions et de cryptomonnaies, avec prix en temps réel, P&L et suivi des dividendes.
Quand utiliser cette compétence
Utilisez cette compétence lorsque vous avez besoin de :
- Suivre des actions et des cryptomonnaies localement
- Obtenir des prix en temps réel et le P&L
- Suivre les rendements des dividendes, le rendement sur le coût (YOC) et les revenus projetés
- Visualiser les prochaines dates ex-dividende
- Gérer plusieurs portefeuilles
- Exporter les données du portefeuille en CSV
Outils
Cette compétence fournit les capacités suivantes :
1. Lister les avoirs
Afficher tous les avoirs avec leurs valeurs actuelles et le P&L.
Commande :
npx tsx portfolio.ts list
2. Ajouter un avoir
Ajouter un nouvel avoir en action ou en cryptomonnaie.
Commande :
npx tsx portfolio.ts add <symbole> <quantité> <prix> <nom> [type]
Exemples :
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. Vendre un avoir
Vendre des actions selon la méthode du coût de base FIFO (premier entré, premier sorti).
Commande :
npx tsx portfolio.ts sell <symbole> <quantité> <prix> [date]
Exemples :
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. Historique des transactions
Consulter l'historique des ventes pour tous les avoirs ou un symbole spécifique.
Commande :
npx tsx portfolio.ts history [symbole]
Exemples :
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. Résumé des P&L
Afficher les profits/pertes réalisés et non réalisés.
Commande :
npx tsx portfolio.ts pnl
6. Suivi des dividendes
Consulter les informations détaillées sur les dividendes des actions, y compris le rendement, le rendement sur le coût (YOC) et le revenu annuel projeté.
Commande :
npx tsx portfolio.ts dividends
7. Résumé des dividendes
Afficher un résumé des dividendes au niveau du portefeuille : revenu total projeté, rendement moyen pondéré et rendement sur le coût.
Commande :
npx tsx portfolio.ts dividend-summary
Le résultat inclut :
- Revenu annuel total projeté
- Estimations de revenus mensuels/trimestriels
- Rendement moyen pondéré de tous les avoirs
- Rendement sur le coût du portefeuille
- Nombre d'actions versant des dividendes
8. Calendrier des dividendes
Consulter les prochaines dates ex-dividende de vos avoirs.
Commande :
npx tsx portfolio.ts calendar [jours]
Exemples :
npx tsx portfolio.ts calendar # 30 prochains jours
npx tsx portfolio.ts calendar 60 # 60 prochains jours
9. Liste avec dividendes
La commande list récupère automatiquement les données de dividendes. Utilisez le drapeau --no-dividends pour ignorer.
Commandes :
npx tsx portfolio.ts list # Avec infos dividendes
npx tsx portfolio.ts list --no-dividends # Ignorer les dividendes
10. Supprimer un avoir
Supprimer un avoir par son symbole.
Commande :
npx tsx portfolio.ts remove <symbole>
11. Valeur du portefeuille
Afficher la valeur totale du portefeuille et le P&L.
Commande :
npx tsx portfolio.ts value
12. Gérer les portefeuilles
Lister, basculer ou créer des portefeuilles.
Commandes :
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Nom du Portefeuille"
Astuce : Après avoir exécuté npm link, vous pouvez utiliser la commande plus courte portfolio au lieu de npx tsx portfolio.ts.
Installation
Tout d'abord, installez les dépendances requises :
npm install
Cela installera tous les paquets nécessaires, y compris le runtime TypeScript (tsx), Next.js, React et autres dépendances listées dans package.json.
Optionnel : Liez la CLI globalement pour un accès plus facile :
npm link
Après le lien, vous pouvez utiliser portfolio <commande> au lieu de npx tsx portfolio.ts <commande>.
Scripts NPM
npm run dev # Démarrer l'interface web (optionnel)
npm run build # Builder pour la production
Interface Web (Optionnelle)
Vous pouvez également exécuter une interface web optionnelle avec un support complet du suivi des dividendes :
npm run dev
Ouvrez ensuite http://localhost:3000
Fonctionnalités de l'interface web :
- Valeur du portefeuille en temps réel et suivi du P&L
- Cartes de résumé des dividendes (revenu annuel, rendement pondéré, YOC, dates à venir)
- Tableau détaillé des dividendes par action
- Calendrier visuel des prochaines dates ex-dividende
- Graphique circulaire interactif pour la répartition du portefeuille
Stockage des données
Les données du portefeuille sont stockées localement dans data/portfolio.json. Le fichier de données est créé automatiquement lors de la première exécution avec un portefeuille vide.
Fonctionnalités
- Prix des actions en temps réel via l'API Yahoo Finance
- Prix des cryptomonnaies en temps réel via l'API CoinGecko
- Prise en charge de plusieurs portefeuilles
- Suivi du P&L par avoir
- Suivi des dividendes (rendement, YOC, revenu projeté, dates ex-dividende)
- Interface en ligne de commande et interface web optionnelle