Die Wallet API befindet sich in der Beta-Phase. Endpunkte und Antwortformate können sich ändern.
Übersicht
Der Wallet Funding Source-Endpunkt identifiziert, wer ursprünglich ein Solana-Wallet finanziert hat, indem er seine erste eingehende SOL-Transaktion analysiert. Dies ist wertvoll für Attribution, Compliance, Verständnis von Wallet-Beziehungen und die Identifizierung von durch Börsen finanzierten Wallets. Der Name und die Kategorie des Finanziers stammen aus demselben Identitätssystem, das auch vom Identity-Endpunkt verwendet wird, sodass Sie bei bekannten Entitäten im Antwortformat ein menschenlesbares Label und eine Kategorie direkt erhalten. Dieser Endpunkt erfordert einen kostenpflichtigen Plan. Anfragen mit einem Free-Plan-API-Schlüssel liefern403 Forbidden. Siehe Plananforderungen für die vollständige Abdeckungstabelle.
Wann zu verwenden
Verwenden Sie die Wallet Funding Source API für:- Wallet-Attribution: Verfolgen, woher neue Wallets finanziert werden.
- Börsenerkennung: Identifizieren von Wallets, die direkt von zentralen Börsen finanziert werden.
- Compliance und AML: Markieren von Wallets, die von bekannten Entitäten finanziert werden, für Compliance-Checks.
- Bot-Erkennung: Identifizieren von Bot-Farmen, die aus derselben Quelle finanziert werden.
- Airdrop-Analyse: Verfolgen, welche Wallets anfängliche Finanzierung von einem Projekt erhalten haben.
- Sybil-Erkennung: Finden von Wallet-Clustern, die von derselben Adresse finanziert werden.
Schnellstart
Grundlegende Finanzierungsabfrage
Finden Sie heraus, wer ein Wallet finanziert hat:- JavaScript
- Python
- cURL
Antwortformat
Eine erfolgreiche Antwort beschreibt die erste eingehende SOL-Überweisung des Wallets:Feldhinweise
funder: die Adresse, die die erste SOL-Überweisung an dieses Wallet gesendet hat.funderName: menschenlesbarer Name, wenn der Financier eine bekannte Entität ist (z.B. Börse, Protokoll); andernfallsnull.funderType: Kategorie des Financiers (z.B.exchange,defi-protocol);null, wenn nicht in der Identitätsdatenbank.mint: Token-Minzadresse (So11111111111111111111111111111111111111111für SOL).symbol: Tokensymbol (immerSOLfür Finanzierungstransaktionen).amount: empfangener Anfangsbetrag von SOL (menschenlesbar, z.B.0.05SOL).amountRaw: roher Betrag in Lamports als Zeichenkette (z.B."50000000"für 0,05 SOL).decimals: Anzahl der Dezimalstellen für das Token (9 für SOL).date: ISO 8601 formatiertes Datumsstring (z.B."2024-01-01T00:00:00.000Z").signature: Transaktionssignatur der Finanzierungstransaktion.timestamp: Unix-Timestamp (in Sekunden), wann das Wallet finanziert wurde.slot: Solana-Slotnummer, als die Finanzierungstransaktion bestätigt wurde.explorerUrl: direkter Link zur Ansicht der Transaktion auf Orb.
Anwendungsfälle
Erkennung von durch Börsen finanzierten Wallets
Identifizieren Sie Wallets, die direkt von zentralen Börsen finanziert werden:Finden von Wallet-Clustern (Sybil-Erkennung)
Identifizieren Sie Gruppen von Wallets, die von derselben Quelle finanziert werden:Verfolgen von Airdrop-Empfängern
Analysieren Sie, woher Airdrop-Empfänger kamen:Erstellen einer Wallet-Zeitlinie
Erstellen Sie eine Zeitlinie beginnend mit der Erstellung des Wallets:Compliance-Risiko-Bewertung
Weisen Sie Risikobewertungen basierend auf der Finanzierungsquelle zu:Attributionsverfolgung
Verfolgen Sie, welche Quellen die meisten neuen Wallets erstellen:Finanzer Arten
Das FeldfunderType gibt die Kategorie des Wallets an, das die Adresse finanziert hat. Alle Werte aus den Identity Categories werden unterstützt.
Unterstützte Finanzerarten
Unterstützte Finanzerarten
Häufige Finanzerarten:
Die vollständige Liste umfasst: Airdrop, Authority, Cross-chain Bridge, Casino & Gambling, DAO, DeFi, DePIN, Zentralisierte Börse, Exploiter/Hacker/Betrügereien, Gebühren, Fundraise, Spiel, Genesis Block-Verteilung, Governance, Hacker, Jito, Key Opinion Leader, Market Maker, Memecoin, Multisig, NFT, Nicht zirkulierendes Angebot, Oracle, Sonstiges, Zahlungen, Proprietäres AMM, Restaking, Abzocker, Betrüger, Spam, Stake Pool, System, Tools, Trading-App/Bot, Handelsfirma, Transaktionsversand, Treasury, Validator, Tresor und X402.Siehe den Abschnitt Identity Categories für die vollständige Liste mit Beschreibungen.
Best Practices
- Umgang mit 404-Antworten. Wallets, die nie SOL erhalten haben, geben einen 404-Fehler zurück. Dies ist bei neu erstellten, aber nicht finanzierten Wallets zu erwarten.
- Kombination mit der Identity API. Die Antwort enthält
funderNameundfunderType, aber Sie können den Identity-Endpunkt auf derfunder-Adresse für mehr Details aufrufen. - Caching von Finanzierungsdaten. Die Finanzierungsquelle eines Wallets ändert sich nie. Cache diese Daten dauerhaft, um wiederholte API-Aufrufe zu vermeiden.
- Alter für Kontext prüfen. Der
timestampzeigt Ihnen, wann das Wallet erstmals finanziert wurde. Kombinieren Sie das Alter mit der Finanzierungsquelle für einen besseren Kontext.
Häufige Fehler
Einschränkungen
- Dieser Endpunkt verfolgt nur die erste SOL-Überweisung an ein Wallet.
- Wenn ein Wallet durch Airdrop oder Programminitialisierung ohne SOL-Überweisung erstellt wurde, werden keine Finanzierungsdaten vorhanden sein.
- Die Finanzierungsquelle stellt den unmittelbaren Finanzierer dar, nicht unbedingt die endgültige Quelle der Mittel.
- Historische Daten sind nur für Wallets verfügbar, die nach der Implementierung dieser Funktion erstellt wurden.
Nächste Schritte
Wallet-Identität
Lösen Sie die Financier-Adresse zu einem vollständigen Label, einer Kategorie und Tags auf.
Wallet API Übersicht
Alle Wallet API-Endpunkte und gemeinsame Konventionen.
API-Referenz
Anforderungs- und Antwortschemata für die Abfrage der Finanzierungsquelle.