Analyse de portefeuille d'actifs EVM
Objectif : Fournir une analyse concise de la distribution 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 <adresse>
# Obtenir uniquement les positions DeFi
python3 zerion-portfolio.py <adresse> --only-defi
Environnement : ZERION_API_KEY doit être définie. Sinon, obtenez votre clé API sur : https://www.zerion.io/api
Workflow d'exécution
Étape 1 : Valider 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érer les données du portefeuille
# Exécuter le script Zerion
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <adresse>
Gérer les cas particuliers :
- Portefeuille vide → Signaler "Portefeuille vide"
- Échec API → Quitter avec erreur, impossible de continuer
- Positions sans valeur → Ignorer
Étape 3 : Catégoriser les actifs
Grouper par type :
Native : ETH, MATIC, BNB, etc.
Stablecoins : USDC, USDT, DAI, USDS
Positions DeFi : Attribut protocol + position_type != 'wallet'
Autres jetons : Tout le reste
Suivre la valeur totale par catégorie pour les pourcentages de distribution
Étape 4 : Identifier les protocoles DeFi
Pour chaque position DeFi :
1. Extraire le nom du protocole à partir de attributes.protocol
2. Identifier le type de position (Lending/Staking/LP/etc.)
3. Enregistrer la valeur de la position et son 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 TVL, blockchains, informations d'audit, catégorie
B. Vérifier les exploits récents :
- Rechercher rekt.news pour le nom du protocole
- 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 TVL >50 % (30 jours) : +3
- Baisse 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/D", continuer
- Rekt.news indisponible : Marquer exploits comme "Inconnu"
Protocoles connus comme sûrs (automatiquement 🟢) :
- Aave V2/V3, Uniswap V2/V3, Compound V2/V3
- Lido, Curve, MakerDAO/Sky
Étape 6 : Générer le rapport
Produire un rapport structuré en Markdown suivant la section Format de sortie ci-dessous.
Format de sortie
1) Résumé
Portefeuille : 0x...
Valeur totale : X XXX $ USD
Blockchains : Ethereum, Arbitrum, Base
2) Distribution des actifs
Répartition des actifs :
• Native : XXX $ (XX %)
• Stablecoins : XXX $ (XX %)
• Positions DeFi : XXX $ (XX %)
• Autres jetons : XXX $ (XX %)
3) Positions principales
Format tableau montrant toutes les positions triées par valeur :
Protocole/Portefeuille | Type de position | Valeur | % Portefeuille
----------------|---------------|-------|------------
Actifs du portefeuille | Portefeuille | XXX $ | XX %
Protocole A | Prêt | XXX $ | XX %
Protocole B | LP | XXX $ | XX %
4) Avoirs principaux (>2 % du portefeuille)
Format tableau :
Blockchain | Actif | Type | Quantité | Valeur | % Portefeuille
------|-------|------|--------|-------|------------
5) Exposition DeFi
Pour chaque protocole avec risque 🟡 Moyen ou 🔴 Élevé uniquement (ignorer les 🟢 Faible) :
Nom du protocole (Blockchain)
• 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 se trouvent dans des protocoles à faible risque (🟢)"
6) Résumé des risques
Haute priorité :
- Lister les positions 🔴 à haut risque avec actions recommandées
Moyenne priorité :
- Lister les positions 🟡 à risque moyen avec 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 du protocole
- 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 comporter un horodatage
- Toutes les valeurs doivent provenir d'appels API réels
- Les évaluations des risques 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 au lancement de nouveaux protocoles majeurs
- Statut des audits : Vérification trimestrielle
Dernière mise à jour : 2026-02-05