L’API Wallet est en version bêta. Les points de terminaison et les formats de réponse peuvent changer.
Aperçu
Le point de terminaison Wallet Funding Source identifie qui a initialement financé un portefeuille Solana en analysant son premier transfert SOL entrant. Il est précieux pour l’attribution, la conformité, la compréhension des relations de portefeuille et l’identification des portefeuilles financés par échange. Le nom et la catégorie du financeur proviennent du même système d’identité utilisé par le point de terminaison Identity, donc lorsque le financeur est une entité connue, vous obtenez une étiquette lisible par l’homme et une catégorie directement dans la réponse. Ce point de terminaison nécessite un plan payant. Les demandes faites avec une clé API du plan gratuit renvoient403 Forbidden. Voir Exigences du plan pour le tableau de couverture complet.
Quand l’utiliser
Utilisez l’API Wallet Funding Source pour :- Attribution de portefeuille : suivez d’où proviennent les financements des nouveaux portefeuilles.
- Détection d’échange : identifiez les portefeuilles financés directement par des échanges centralisés.
- Conformité et AML : signalez les portefeuilles financés par des entités connues pour des vérifications de conformité.
- Détection de bots : identifiez les fermes de bots financées par la même source.
- Analyse de largage : suivez quels portefeuilles ont reçu un financement initial d’un projet.
- Détection Sybil : trouvez des groupes de portefeuilles financés par la même adresse.
Démarrage rapide
Recherche de financement de base
Découvrez qui a financé un portefeuille :- JavaScript
- Python
- cURL
Format de réponse
Une réponse réussie décrit le premier transfert SOL entrant du portefeuille :Notes sur les champs
funder: l’adresse qui a envoyé le premier transfert SOL à ce portefeuille.funderName: nom lisible par l’homme si le financeur est une entité connue (par exemple, échange, protocole) ;nullsinon.funderType: catégorie du financeur (par exemple,exchange,defi-protocol) ;nullsi non dans la base de données d’identité.mint: adresse de la frappe du jeton (So11111111111111111111111111111111111111111pour SOL).symbol: symbole du jeton (toujoursSOLpour les transactions de financement).amount: montant initial de SOL reçu (lisible par l’homme, par exemple,0.05SOL).amountRaw: montant brut en lamports en tant que chaîne (par exemple,"50000000"pour 0,05 SOL).decimals: nombre de décimales pour le jeton (9 pour SOL).date: chaîne de date formatée ISO 8601 (par exemple,"2024-01-01T00:00:00.000Z").signature: signature de la transaction du transfert de financement.timestamp: horodatage Unix (en secondes) lorsque le portefeuille a été financé.slot: numéro de slot Solana lorsque la transaction de financement a été confirmée.explorerUrl: lien direct pour voir la transaction sur Orb.
Cas d’utilisation
Détecter les portefeuilles financés par échange
Identifiez les portefeuilles financés directement par des échanges centralisés :Trouver des clusters de portefeuilles (détection Sybil)
Identifiez les groupes de portefeuilles financés par la même source :Suivre les destinataires de largage
Analysez d’où viennent les destinataires de largage :Construire une chronologie de portefeuille
Créez une chronologie à partir de la création du portefeuille :Évaluation du risque de conformité
Attribuez des scores de risque en fonction de la source de financement :Suivi de l’attribution
Suivez quelles sources créent le plus de nouveaux portefeuilles :Types de financeurs
Le champfunderType indique la catégorie du portefeuille qui a financé l’adresse. Toutes les valeurs des Catégories d’identité sont prises en charge.
Types de financeurs pris en charge
Types de financeurs pris en charge
Types de financeurs courants :
La liste complète comprend : Largage, Autorité, Pont inter-chaînes, Casino & Jeux, DAO, DeFi, DePIN, Échange centralisé, Exploiteur/Pirates/Arnaques, Frais, Levée de fonds, Jeu, Distribution du bloc de genèse, Gouvernance, Pirate, Jito, Leader d’opinion clé, Teneur de marché, Memecoin, Multisig, NFT, Offre non circulante, Oracle, Autre, Paiements, AMM propriétaire, Re-staking, Rugger, Arnaqueur, Spam, Pool de staking, Système, Outils, Application/Bot de trading, Société de trading, Envoi de transactions, Trésorerie, Validateur, Coffre-fort et X402.Voir la section Catégories d’identité pour la liste complète avec descriptions.
Meilleures pratiques
- Gérez les réponses 404. Les portefeuilles qui n’ont jamais reçu de SOL renvoient un 404. C’est attendu pour les portefeuilles nouvellement créés mais non financés.
- Combinez avec l’API d’identité. La réponse inclut
funderNameetfunderType, mais vous pouvez appeler le point de terminaison Identity sur l’adressefunderpour plus de détails. - Mettez en cache les données de financement. La source de financement d’un portefeuille ne change jamais. Mettez ces données en cache de manière permanente pour éviter les appels d’API répétés.
- Vérifiez l’âge pour le contexte.
timestampvous indique quand le portefeuille a été financé pour la première fois. Combinez l’âge avec la source de financement pour un meilleur contexte.
Erreurs courantes
Limitations
- Ce point de terminaison suit uniquement le premier transfert SOL vers un portefeuille.
- Si un portefeuille a été créé par largage ou initialisation de programme sans transfert SOL, il n’aura pas de données de financement.
- La source de financement représente le financeur immédiat, pas nécessairement la source ultime des fonds.
- Les données historiques ne sont disponibles que pour les portefeuilles créés après le déploiement de cette fonctionnalité.
Prochaines étapes
Identité du portefeuille
Résolvez l’adresse du financeur en une étiquette complète, une catégorie et des balises.
Présentation de l'API Wallet
Tous les points de terminaison de l’API Wallet et conventions partagées.
Référence de l'API
Schémas de requête et de réponse pour la recherche de source de financement.