Utilisation du script
Compétence en mode script — lisez ce fichier, puis invoquez depuis un bloc bash :
python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/birdeye")
from exports import birdeye_token_overview, birdeye_token_security, birdeye_wallet_networth
# Aperçu SOL
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF
Fonctions disponibles dans exports.py : birdeye_token_security,
birdeye_token_overview, birdeye_wallet_networth. Lisez exports.py
directement pour les signatures exactes.
Birdeye
Fournisseur de données multi-chaîne pour l'intelligence des jetons et l'analyse de portefeuilles. Couvre Solana + les chaînes EVM (Ethereum, Arbitrum, Base, etc.). Mise en avant des capacités uniques de Birdeye pour l'analyse de sécurité et le suivi de portefeuille.
Référence des fonctions (signatures)
Toutes les fonctions se trouvent dans exports.py. chain par défaut est solana. Les chaînes EVM
supportées sont : ethereum, bsc, polygon, arbitrum, optimism,
base, avalanche, zksync, sui. L'adresse du jeton pour Solana est
l'adresse du mint (ex. SOL = So11111111111111111111111111111111111111112).
| Fonction | Description |
|---|---|
birdeye_token_overview(address, chain='solana') | Données complètes du jeton : prix, marketCap, FDV, offre, détenteurs, liquidité, volume sur 24h, liens sociaux. Renvoie un wrapper {data: {...}}. |
birdeye_token_security(address, chain='solana') | Audit de sécurité : propriété, possibilité de mint, possibilité de geler, concentration des principaux détenteurs, métadonnées mutables, indicateurs de rug pull. |
birdeye_wallet_networth(wallet, chain='solana') | Valeur nette du portefeuille + répartition des jetons. wallet = adresse du portefeuille. |
Birdeye utilise des champs en camelCase (marketCap, priceChange24h, etc.).
Toutes les réponses sont wrappées dans une enveloppe {data: {...}} — extrayez via
result.get('data', {}).
Outils disponibles (3)
Intelligence des jetons (2 outils)
- birdeye_token_security : Score de sécurité et analyse des risques de rug pull
- birdeye_token_overview : Données complètes du jeton (prix, volume, capitalisation, liquidité)
Analytics de portefeuille (1 outil)
- birdeye_wallet_networth : Valeur nette actuelle du portefeuille et répartition
Quand utiliser chaque outil
« Ce jeton est-il sûr ? » → birdeye_token_security
Score de sécurité, analyse des risques de rug pull, et détection des vulnérabilités du contrat.
« Donne-moi le rapport complet sur ce jeton » → birdeye_token_overview
Prix, volume, capitalisation, liquidité et variations de prix en un seul appel.
« Quelle est la valeur de ce portefeuille ? » → birdeye_wallet_networth
Valeur actuelle du portefeuille et répartition détaillée des jetons avec soldes et valeurs.
Support multi-chaîne
Tous les outils acceptent un paramètre chain :
- Solana :
solana(par défaut pour la plupart des requêtes) - EVM :
ethereum,arbitrum,base,optimism,polygon,bsc,avalanche,zksync,sui
Recommandations pour le choix de la chaîne :
- Solana : Trading le plus actif, idéal pour les memecoins
- Ethereum : Jetons blue-chip, protocoles DeFi
- Arbitrum/Base : Trading L2, DeFi à faibles frais
- Utilisez la chaîne d'origine du jeton/portefeuille
Guides d'interprétation
Scores de sécurité
| Score | Niveau de risque | Action |
|---|---|---|
| 90-100 | Très faible | Peut trader en toute sécurité, contrat vérifié |
| 70-89 | Faible | Généralement sûr, risques standards |
| 50-69 | Moyen | Procéder avec prudence, vérifier la liste des problèmes |
| 30-49 | Élevé | Risque élevé — examiner les problèmes attentivement |
| 0-29 | Très élevé | Probablement un rug pull ou une arnaque — éviter |
Signaux d'alarme courants :
- Autorité de mint non renoncée (le propriétaire peut imprimer des jetons)
- Autorité de gel activée (le propriétaire peut geler les transactions)
- Faible liquidité (< 10k $ = risque de rug élevé)
- Détention concentrée (top 10 détenteurs > 80% de l'offre)
- Absence de liens sociaux ou de site web
Métriques de l'aperçu du jeton
Prix et capitalisation : Valeur actuelle et prix de négociation Volume : L'activité de trading indique la liquidité et l'intérêt Liquidité : Liquidité disponible pour les échanges (plus élevée = sorties plus sûres) Variation de prix % : Mouvements de prix sur 1h/24h/7j
Interprétation de la liquidité :
- < 10k $ : Risque très élevé, facile à manipuler
- 10k $ - 100k $ : Risque modéré, surveiller les grosses sorties
- 100k $ - 1M $ : Bonne liquidité pour les petites/moyennes transactions
-
1M $ : Liquidité solide, plus sûr pour les positions importantes
Valeur nette du portefeuille
Valeur totale en USD : Somme de toutes les participations aux prix actuels Répartition des jetons : Participations individuelles avec soldes et valeurs Concentration du portefeuille : Le portefeuille est-il diversifié ?
Indicateurs de santé du portefeuille :
- Forte concentration (>80% dans un seul jeton) = risque élevé
- Participations équilibrées = meilleure gestion des risques
- Gains latents importants = potentiel de prise de bénéfices
Workflows courants
Due diligence sur un jeton
- birdeye_token_security — Score de sécurité et vérification des risques
- birdeye_token_overview — Prix, volume, capitalisation, liquidité
Signaux d'alarme : Faible score de sécurité (<50) + faible liquidité (<10k $) = risque de rug pull
Exemple :
Utilisateur : « Ce jeton est-il sûr ? [adresse Solana] »
1. Vérifier birdeye_token_security → Score 85 (Risque faible)
2. Vérifier birdeye_token_overview → 500k $ de liquidité, 2M $ de volume
3. Résultat : Généralement sûr, bonne liquidité pour trader
Analyse de portefeuille
- birdeye_wallet_networth — Valeur actuelle du portefeuille et répartition
Cas d'usage :
- Suivre la valeur de votre propre portefeuille
- Analyser les portefeuilles de whales
- Surveiller les participations des concurrents
Exemple :
Utilisateur : « Que contient ce portefeuille ? [adresse] »
1. Vérifier birdeye_wallet_networth → Valeur totale de 45k $
2. Répartition : 60% SOL, 25% USDC, 15% memecoins
3. Résultat : Portefeuille Solana équilibré avec couverture en stablecoin
Vérification rapide d'un jeton
Pour une validation rapide avant de trader :
birdeye_token_overview → Obtenez le prix, la liquidité et le volume en un seul appel
Si liquidité < 10k $ ou volume < 1k $ → Risque élevé, procédez avec prudence
Détails des outils
birdeye_token_security
Paramètres :
address(obligatoire) : Adresse du contrat du jetonchain(optionnel) : Blockchain (par défaut :solana)
Renvoie :
- Score de sécurité (0-100)
- Niveau de risque
- Liste des problèmes détectés
- Résultats de l'analyse du contrat
Exemple :
bird-eye_token_security(
address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
chain="solana"
)
birdeye_token_overview
Paramètres :
address(obligatoire) : Adresse du contrat du jetonchain(optionnel) : Blockchain (par défaut :solana)
Renvoie :
- Symbole, nom
- Prix actuel
- Volume sur 24h
- Capitalisation
- Liquidité
- Variations de prix (1h, 24h, 7j)
Exemple :
bird-eye_token_overview(
address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
chain="solana"
)
birdeye_wallet_networth
Paramètres :
wallet(obligatoire) : Adresse du portefeuillechain(optionnel) : Blockchain (par défaut :solana)
Renvoie :
- Valeur totale en USD
- Répartition des participations :
- Symbole, nom du jeton
- Solde
- Prix actuel
- Valeur en USD
- Pourcentage du portefeuille
Exemple :
bird-eye_wallet_networth(
wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
chain="solana"
)
Remarque : Les APIs des portefeuilles ont des limites de débit (5 req/s, 75 req/min). Espacez les requêtes.
Notes spécifiques aux chaînes
Solana :
- Chaîne la mieux supportée par Birdeye
- Les adresses de jetons sont encodées en base58
- Trading le plus liquide sur Raydium, Orca
- Utiliser pour l'analyse de memecoins et le suivi de portefeuille
Ethereum :
- Jetons blue-chip et protocoles DeFi
- Les adresses de jetons sont au format 0x...
- Frais de gaz plus élevés = moins de micro-trading
Arbitrum/Base :
- Solutions de mise à l'échelle L2 avec des frais réduits
- Écosystème DeFi en croissance
- Idéal pour les projets natifs L2
Intégration avec d'autres compétences
Complémentaire à CoinGecko :
- Utilisez Birdeye pour : Vérifications de sécurité, jetons Solana, analytics de portefeuille
- Utilisez CoinGecko pour : Données de marché générales, prix historiques, classements par capitalisation
Ne pas dupliquer : Chaque service a ses forces uniques. Utilisez Birdeye pour ses données spécialisées (sécurité, focus Solana, suivi de portefeuille).
Notes
- Clé API requise : Définissez la variable d'environnement
BIRDEYE_API_KEY - Limites de débit : Les endpoints de portefeuille sont limités à 5 req/s, 75 req/min
- Multi-chaîne : Spécifiez toujours le paramètre
chainpour les requêtes non-Solana - Scores de sécurité : Analyse automatisée — validez manuellement pour les transactions de grande valeur
- Données en temps réel : Les prix et les données sont mis à jour fréquemment, idéal pour les décisions de trading actif
Limitations
- Pas de jetons tendance : Utilisez CoinGecko pour les listes de jetons tendance/top
- Pas de répartition des détenteurs : Impossible de vérifier qui détient un jeton
- Pas d'historique des transactions : Impossible de voir les transactions récentes
- Pas de signaux « smart money » : Utilisez d'autres sources pour le suivi des whales
- Outils de portefeuille limités : Seulement la valeur nette disponible (pas de PnL, détails des participations ou transferts)
Concentrez-vous sur les 3 outils disponibles pour les vérifications de sécurité, les aperçus de jetons et les valorisations de portefeuilles.