Zum Hauptinhalt springen
Die Wallet API befindet sich in der Betaphase. endpoint und Formate von response können sich ändern.

Übersicht

Der endpoint Wallet Funding Source ermittelt, wer eine Solana-Wallet ursprünglich finanziert hat. Dazu analysiert er ihre erste eingehende SOL-Übertragung. Das ist hilfreich für Zuordnungen, Compliance, das Verständnis von Beziehungen zwischen Wallets und die Erkennung von Wallets, die durch Börsen finanziert wurden. Name und Kategorie des Geldgebers stammen aus demselben Identitätssystem, das auch der endpoint Identity verwendet. Ist der Geldgeber eine bekannte Entität, erhältst du direkt in der response eine lesbare Bezeichnung und Kategorie. Dieser endpoint erfordert einen kostenpflichtigen Tarif. Ein request mit einem API key aus dem Free-Tarif gibt 403 Forbidden zurück. Die vollständige Übersicht findest du unter Tarifanforderungen.

Wann du diese Funktion verwenden solltest

Verwende die Wallet Funding Source API für folgende Zwecke:
  • Zuordnung von Wallets: Verfolge, aus welchen Quellen neue Wallets finanziert werden.
  • Erkennung von Börsen: Erkenne Wallets, die direkt von zentralisierten Börsen finanziert wurden.
  • Compliance und AML: Markiere Wallets, die von bekannten Entitäten finanziert wurden, für Compliance-Prüfungen.
  • Bot-Erkennung: Erkenne Bot-Farmen, die aus derselben Quelle finanziert werden.
  • Airdrop-Analyse: Verfolge, welche Wallets ihre ursprüngliche Finanzierung von einem Projekt erhalten haben.
  • Sybil-Erkennung: Finde cluster von Wallets, die von derselben Adresse finanziert wurden.

Schnellstart

Einfache Abfrage der Finanzierungsquelle

Finde heraus, wer eine Wallet finanziert hat:

Format der response

Eine erfolgreiche response beschreibt die erste eingehende SOL-Übertragung der Wallet:
Wenn eine Wallet noch nie SOL erhalten hat, gibt die API den Statuscode 404 zurück:

Hinweise zu den Feldern

  • funder: die Adresse, von der die erste SOL-Übertragung an diese Wallet gesendet wurde.
  • funderName: lesbarer Name, wenn der Geldgeber eine bekannte Entität ist, zum Beispiel eine Börse oder ein Protokoll; andernfalls null.
  • funderType: Kategorie des Geldgebers, zum Beispiel exchange oder defi-protocol; null, wenn er nicht in der Identitätsdatenbank enthalten ist.
  • mint: Mint-Adresse des Tokens (So11111111111111111111111111111111111111111 für SOL).
  • symbol: Symbol des Tokens (bei Finanzierungstransaktionen immer SOL).
  • amount: ursprünglich empfangener SOL-Betrag in lesbarer Form, zum Beispiel 0.05 SOL.
  • amountRaw: Rohbetrag in Lamports als Zeichenfolge, zum Beispiel "50000000" für 0,05 SOL.
  • decimals: Anzahl der Dezimalstellen des Tokens (9 für SOL).
  • date: nach ISO 8601 formatierte Datumszeichenfolge, zum Beispiel "2024-01-01T00:00:00.000Z".
  • signature: Transaktionssignatur der Finanzierungsübertragung.
  • timestamp: Unix-Zeitstempel in Sekunden, zu dem die Wallet finanziert wurde.
  • slot: Solana-slot, in dem die Finanzierungstransaktion bestätigt wurde.
  • explorerUrl: direkter Link zur Transaktion in Orb.

Anwendungsfälle

Von Börsen finanzierte Wallets erkennen

Erkenne Wallets, die direkt von zentralisierten Börsen finanziert wurden:

Wallet-cluster finden (Sybil-Erkennung)

Erkenne Gruppen von Wallets, die aus derselben Quelle finanziert wurden:

Airdrop-Empfänger verfolgen

Analysiere, aus welchen Quellen Airdrop-Empfänger stammen:

Zeitleiste einer Wallet erstellen

Erstelle eine Zeitleiste, die mit der Erstellung der Wallet beginnt:

Risikobewertung für Compliance

Weise anhand der Finanzierungsquelle Risikowerte zu:

Zuordnungen verfolgen

Verfolge, aus welchen Quellen die meisten neuen Wallets stammen:

Arten von Geldgebern

Das Feld funderType gibt die Kategorie der Wallet an, von der die Adresse finanziert wurde. Alle Werte aus den Identitätskategorien werden unterstützt.
Häufige Arten von Geldgebern:Die vollständige Liste umfasst: Airdrop, Authority, Cross-chain Bridge, Casino & Gambling, DAO, DeFi, DePIN, Centralized Exchange, Exploiter/Hackers/Scams, Fees, Fundraise, Game, Genesis Block Distribution, Governance, Hacker, Jito, Key Opinion Leader, Market Maker, Memecoin, Multisig, NFT, Non-Circulating Supply, Oracle, Other, Payments, Proprietary AMM, Restaking, Rugger, Scammer, Spam, Stake Pool, System, Tools, Trading App/Bot, Trading Firm, Transaction Sending, Treasury, Validator, Vault und X402.Die vollständige Liste mit Beschreibungen findest du im Abschnitt Identitätskategorien.

Best Practices

  • Verarbeite 404-responses. Wallets, die noch nie SOL erhalten haben, geben den Statuscode 404 zurück. Das ist bei neu erstellten, aber noch nicht finanzierten Wallets zu erwarten.
  • Kombiniere die Funktion mit der Identity API. Die response enthält funderName und funderType. Für weitere Details kannst du jedoch den endpoint Identity mit der Adresse funder aufrufen.
  • Speichere Finanzierungsdaten im Cache. Die Finanzierungsquelle einer Wallet ändert sich nie. Speichere diese Daten dauerhaft im Cache, um wiederholte API-Aufrufe zu vermeiden.
  • Prüfe das Alter für mehr Kontext. timestamp zeigt dir, wann die Wallet erstmals finanziert wurde. Kombiniere das Alter mit der Finanzierungsquelle, um mehr Kontext zu erhalten.

Häufige Fehler

Einschränkungen

  • Dieser endpoint verfolgt nur die erste SOL-Übertragung an eine Wallet.
  • Wenn eine Wallet über einen Airdrop oder eine Programminitialisierung ohne SOL-Übertragung erstellt wurde, sind keine Finanzierungsdaten verfügbar.
  • Die Finanzierungsquelle bezeichnet den unmittelbaren Geldgeber, nicht unbedingt die ursprüngliche Herkunft der Mittel.
  • Historische Daten sind nur für Wallets verfügbar, die erstellt wurden, nachdem diese Funktion bereitgestellt wurde.

Nächste Schritte

Wallet Identity

Löse die Adresse des Geldgebers in eine vollständige Bezeichnung, Kategorie und Tags auf.

Wallet API Overview

Alle endpoint der Wallet API und die gemeinsamen Konventionen.

API Reference

Schemas für request und response bei der Abfrage der Finanzierungsquelle.