Communitygithub.com

Starchild-ai-agent/official-skills

Analytiques de jetons et de portefeuilles sur Solana et EVM : vérifications de sécurité, détenteurs, valeur nette.

Qu'est-ce que official-skills ?

Cette compétence tire parti de l'API Birdeye pour fournir une analyse approfondie des jetons et des portefeuilles sur les blockchains Solana et EVM (Ethereum, Arbitrum, Base, BSC, etc.). Elle se compose de trois fonctions principales : `birdeye_token_security` pour évaluer les risques de rug pull et la sécurité des contrats, `birdeye_token_overview` pour obtenir des données complètes sur un jeton (prix, liquidité, capitalisation), et `birdeye_wallet_networth` pour calculer la valeur nette d'un portefeuille et sa répartition par jeton. L'outil est particulièrement utile pour vérifier la fiabilité d'un jeton avant un investissement, analyser un portefeuille de whale, ou surveiller ses propres avoirs. Les données sont wrappées dans un objet `{data: {...}}` et nécessitent une clé API (`BIRDEYE_API_KEY`). L'accent est mis sur la sécurité et la transparence, avec des seuils d'interprétation pour les scores de sécurité et les niveaux de liquidité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/birdeye

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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).

FonctionDescription
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é

ScoreNiveau de risqueAction
90-100Très faiblePeut trader en toute sécurité, contrat vérifié
70-89FaibleGénéralement sûr, risques standards
50-69MoyenProcéder avec prudence, vérifier la liste des problèmes
30-49ÉlevéRisque élevé — examiner les problèmes attentivement
0-29Trè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

  1. birdeye_token_security — Score de sécurité et vérification des risques
  2. 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

  1. 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 jeton
  • chain (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 jeton
  • chain (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 portefeuille
  • chain (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 chain pour 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.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Skills associés