Analyse de Portefeuille Wallet
Objectif : Fournir une analyse concise de la répartition des actifs et une évaluation des risques pour les portefeuilles EVM.
Entrées
wallet_address(obligatoire) : Adresse EVM (0x...)
Source de Données
Principale : API Zerion via zerion-portfolio.py
# Obtenir tous les actifs
python3 zerion-portfolio.py <address>
# Obtenir uniquement les positions DeFi
python3 zerion-portfolio.py <address> --only-defi
Environnement : ZERION_API_KEY doit être défini. Sinon, obtenez votre clé API sur : https://www.zerion.io/api
Flux d'Exécution
Étape 1 : Validation de l'Entrée
1. Vérifier le format de l'adresse : 0x + 40 caractères hexadécimaux
2. Si format invalide : Quitter avec un message d'erreur
Étape 2 : Récupération des Données du Portefeuille
# Exécuter le script Zerion
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <address>
Gérer les cas particuliers :
- Portefeuille vide → Signaler « Portefeuille vide »
- Échec de l'API → Quitter avec erreur, impossible de continuer
- Positions de valeur nulle → Ignorer
Étape 3 : Catégorisation des Actifs
Regrouper par type :
Natifs : ETH, MATIC, BNB, etc.
Stablecoins : USDC, USDT, DAI, USDS
Positions DeFi : Possède un attribut protocole + position_type != 'wallet'
Autres Tokens : Tout le reste
Suivre la valeur totale par catégorie pour les pourcentages de répartition
Étape 4 : Identification des Protocoles DeFi
Pour chaque position DeFi :
1. Extraire le nom du protocole depuis attributes.protocol
2. Identifier le type de position (Prêt/Staking/LP/etc.)
3. Enregistrer la valeur de la position et le pourcentage du portefeuille
4. Créer une liste de protocoles uniques pour l'évaluation des risques
Étape 5 : Évaluation des Risques (Protocoles DeFi Uniquement)
Pour chaque protocole identifié :
A. Récupérer les Données du Protocole (en parallèle) :
- API DefiLlama : curl "https://api.llama.fi/protocol/{slug}"
- Extraire la TVL, les chaînes, les informations d'audit, la catégorie
B. Vérifier les Exploits Récents :
- Rechercher le nom du protocole sur rekt.news
- Filtrer les 90 derniers jours
- Enregistrer tout incident
C. Calculer le Score de Risque :
Risque = Base + Événements + Audit + Tendance TVL
Facteurs :
- Pas d'audit : +5
- Exploit récent (90 jours) : +5
- Baisse de TVL >50% (30 jours) : +3
- Baisse de TVL 20-50% : +2
- Nouveau protocole (<6 mois) : +2
- Audit unique : +1
- Audits multiples : -2
- Éprouvé (>1 an) : -1
D. Attribuer le Niveau de Risque :
- Score > 7 : 🔴 Risque Élevé
- Score 4-7 : 🟡 Risque Moyen
- Score < 4 : 🟢 Risque Faible
E. Gestion des Erreurs :
- DefiLlama échoue : Marquer TVL comme « N/A », continuer
- Rekt.news indisponible : Marquer les exploits comme « Inconnu »
Protocoles Connus Sûrs (auto 🟢) :
- Aave V2/V3, Uniswap V2/V3, Compound V2/V3
- Lido, Curve, MakerDAO/Sky
Étape 6 : Génération du Rapport
Produire un rapport structuré en Markdown en suivant la section Format de Sortie ci-dessous.
Format de Sortie
1) Résumé
Portefeuille : 0x...
Valeur Totale : $X XXX USD
Chaînes : Ethereum, Arbitrum, Base
2) Répartition des Actifs
Répartition des Actifs :
• Natifs : $XXX (XX%)
• Stablecoins : $XXX (XX%)
• Positions DeFi : $XXX (XX%)
• Autres Tokens : $XXX (XX%)
3) Positions Principales
Tableau affichant toutes les positions triées par valeur :
Protocole/Wallet | Type de Position | Valeur | % Portefeuille
----------------|------------------|--------|---------------
Wallet Assets | Wallet | $XXX | XX%
Protocole A | Prêt | $XXX | XX%
Protocole B | LP | $XXX | XX%
4) Principaux Avoirs (>2% du portefeuille)
Tableau :
Chaîne | Actif | Type | Montant | Valeur | % Portefeuille
-------|-------|------|---------|--------|---------------
5) Exposition DeFi
Pour chaque protocole avec risque 🟡 Moyen ou 🔴 Élevé uniquement (sauter 🟢 Risque Faible) :
Nom du Protocole (Chaîne)
• Valeur de la Position : $XXX (XX% du portefeuille)
• Type de Position : Prêt/Staking/LP/etc.
• Risque : 🟡/🔴
• TVL : $XXX (DefiLlama)
• Audit : Oui/Non (noms des auditeurs)
• Problèmes Récents : Aucun / [décrire]
Si tous les protocoles sont à faible risque, afficher : « Toutes les positions DeFi sont dans des protocoles à faible risque (🟢) »
6) Résumé des Risques
Haute Priorité :
- Lister les positions à risque 🔴 élevé avec les actions recommandées
Priorité Moyenne :
- Lister les positions à risque 🟡 moyen avec les considérations
Évaluation Globale :
- Un paragraphe de résumé
- Score de risque : Faible/Moyen/Élevé
7) Sources de Données
- API Zerion : Données du portefeuille (horodatage)
- DefiLlama : TVL et informations des protocoles
- Rekt.news : Incidents de sécurité
- [Autres sources utilisées]
Normes de Qualité
Concision :
- Rapport total : 200-400 mots (hors tableaux)
- Se concentrer uniquement sur les informations exploitables
- Pas de remplissage ni de déclarations génériques
Précision :
- Toutes les données doivent avoir un horodatage
- Toutes les valeurs doivent provenir d'appels API réels
- Les évaluations de risque doivent citer des preuves spécifiques
Utilité :
- Mettre en évidence les positions >5% du portefeuille
- Signaler immédiatement toute exposition à haut risque
- Fournir des actions claires si nécessaire
Fréquence de Mise à Jour
- Base de données des risques : Mise à jour mensuelle avec rekt.news
- Protocoles connus : Mise à jour lors du lancement de nouveaux protocoles majeurs
- Statut des audits : Vérification trimestrielle
Dernière mise à jour : 2026-02-05