Compétence de Suivi de Portefeuille
Un suivi de portefeuille d'investissement entièrement local. Toutes les données restent dans ~/.portfolio-tracker/.
Architecture
- Données :
~/.portfolio-tracker/data.json(portefeuilles, actifs, prix) - Configuration :
~/.portfolio-tracker/config.json(clés API, adresses de portefeuille, profil utilisateur) - Scripts : Outils CLI TypeScript dans
<chemin-compétence>/scripts/, exécutés vianpx tsx
Configuration Initiale
Avant d'exécuter un script, assurez-vous que les dépendances sont installées :
npm install --prefix <chemin-compétence>/scripts
Remplacez <chemin-compétence> par le chemin d'installation réel de cette compétence.
Fonctionnement des Scripts
Chaque script est un outil CLI autonome. Exécutez-les avec :
npx tsx <chemin-compétence>/scripts/<script>.ts <commande> [args]
Les scripts lisent depuis l'entrée standard si nécessaire et produisent du JSON sur la sortie standard.
data-store.ts
load— Lire les données de portefeuille (crée un fichier par défaut s'il manque)save— Écrire les données de portefeuille (JSON depuis l'entrée standard)load-config— Lire la configurationsave-config— Écrire la configuration (JSON depuis l'entrée standard)
fetch-prices.ts
crypto <symbole>— Obtenir le prix d'une crypto (Binance → CoinGecko)stock <symbole>— Obtenir le prix d'une action (Yahoo Finance)fx— Obtenir les taux de change USD/CNY/HKDhistorical <symbole>— Obtenir les données historiques mensuelles sur 3 anssearch <requête>— Rechercher des actifs par nom/symbolerefresh— Actualiser les prix par lots (JSON des actifs depuis l'entrée standard)
binance-sync.ts
sync <cléApi> <secretApi>— Récupérer tous les soldes Binance (6 types de comptes)validate <cléApi> <secretApi>— Valider les identifiants API
ibkr-sync.ts
sync <jeton> <idRequête>— Récupérer les positions IBKR via Flex Queryvalidate <jeton> <idRequête>— Valider les identifiants IBKR
blockchain-sync.ts
sync <adresse> [chaîne]— Récupérer les soldes d'un portefeuille (une chaîne ou les 5 chaînes EVM)validate <adresse>— Valider une adresse EVM
Types de Données
Actif
{
"id": "identifiant-unique",
"type": "CRYPTO | USSTOCK | HKSTOCK | ASHARE | CASH",
"symbole": "BTC",
"nom": "Bitcoin",
"quantité": 1.5,
"prixMoyen": 40000,
"prixActuel": 50000,
"devise": "USD | CNY | HKD",
"transactions": [],
"source": { "type": "manuel | binance | wallet | ibkr" }
}
Portefeuille
{
"id": "identifiant-unique",
"nom": "Principal",
"actifs": [...]
}
Schémas de Flux de Travail
Visualisation du Portefeuille
- Charger les données via
data-store.ts load - Trouver le portefeuille actuel par
currentPortfolioId - Calculer la valeur totale en utilisant
quantité * prixActuelpar actif - Convertir dans la devise d'affichage en utilisant
tauxDeChange - Présenter sous forme de tableau formaté
Ajout d'Actifs
- Charger les données
- Rechercher l'actif avec
fetch-prices.ts search <requête> - Obtenir le prix actuel via
fetch-prices.ts crypto/stock <symbole> - Ajouter l'actif au portefeuille actuel avec un ID unique généré
- Sauvegarder les données
Actualisation des Prix
- Charger les données
- Transmettre les actifs du portefeuille actuel à
fetch-prices.ts refreshvia l'entrée standard - Exécuter également
fetch-prices.ts fxpour les taux de change - Mettre à jour le
prixActuelde chaque actif et lestauxDeChange - Définir
dernièreActualisationPrixà l'horodatage ISO actuel - Sauvegarder les données
Synchronisation depuis un Échange/Portefeuille
- Charger la configuration pour obtenir les identifiants
- Exécuter le script de synchronisation approprié
- Fusionner les résultats : mettre à jour les actifs existants (correspondance par symbole+source), ajouter les nouveaux
- Sauvegarder les données
Commandes
Commandes utilisateur disponibles :
/portfolio— Voir et gérer les portefeuilles/prices— Actualiser tous les prix/setup— Configurer les clés API et les portefeuilles/sync-binance— Synchroniser depuis Binance/sync-ibkr— Synchroniser depuis Interactive Brokers/sync-wallet— Synchroniser depuis un portefeuille blockchain/advise— Obtenir des conseils d'investissement par IA