Die Wallet API befindet sich in der Betaphase. Endpoints und response-Formate können sich ändern.
Überblick
Der endpoint für Token-Transfers ruft alle Token-Transferaktivitäten einer Solana-Wallet ab, einschließlich detaillierter Informationen zu Absender und Empfänger. Im Gegensatz zum vollständigen Transaktionsverlauf konzentriert sich dieser endpoint ausschließlich auf Transfers. Dadurch eignet er sich ideal zum Verfolgen von Zahlungen und Überwachen von Transfers. Der endpoint gibt bis zu 100 Transfers pro request zurück (standardmäßig 50). Verwende den Parametercursor zusammen mit pagination.nextCursor, um die nächste Seite abzurufen. Lies pagination.hasMore, um zu erkennen, ob weitere Ergebnisse verfügbar sind.
Wann du dies verwenden solltest
Verwende die Token Transfers API, wenn du Folgendes tun möchtest:- Zahlungen verfolgen: Überwache eingehende Zahlungen für Zahlungsabwickler.
- Einen Transfer-Feed erstellen: Zeige einen einfachen Aktivitäts-Feed mit „gesendet/empfangen“ an.
- Bestimmte Token überwachen: Verfolge Transfers eines bestimmten Tokens, etwa USDC-Zahlungen.
- Gegenparteien identifizieren: Ermittle, wer Token gesendet oder empfangen hat.
- Belege erstellen: Erstelle Zahlungsbelege mit Angaben zu Absender und Empfänger.
- Verdächtige Aktivitäten erkennen: Überwache ungewöhnliche Transfermuster.
Schnellstart
Einfache Transferabfrage
Rufe die neuesten ein- und ausgehenden Transfers ab:- JavaScript
- Python
- cURL
Nach Richtung filtern
Filtere die Ergebnisse clientseitig, um nur ein- oder ausgehende Transfers zu erhalten:- Incoming Only
- Outgoing Only
Abfrageparameter
response-Format
Hinweise zu den Feldern
direction: relativ zu der abgefragten Wallet.insteht für empfangene Token (eingehende Zahlung),outfür gesendete Token (ausgehende Zahlung).counterparty: beiin-Transfers der Absender, beiout-Transfers der Empfänger.amount: lesbarer Transferbetrag, bereits durchdecimalsgeteilt. Verwende diesen Wert für die Anzeige, beispielsweise1.5SOL oder100.0USDC.amountRaw: derselbe Betrag als unverarbeitete Ganzzahl-Zeichenfolge vor der Dezimalanpassung, beispielsweise"1500000000"für 1,5 SOL. Er wird als Zeichenfolge serialisiert, um Präzisionsverluste bei Gleitkommazahlen zu vermeiden. Verwende diesen Wert für On-Chain-Anweisungen oder präzise Berechnungen:amount = parseInt(amountRaw) / 10**decimals.mint: Mint-Adresse des Tokens (So11111111111111111111111111111111111111111für natives SOL).symbol: Token-Symbol. Nicht alle Token haben eines. Verwende stattdessen die Mint-Adresse, wennsymbolden Wertnullhat.
Anwendungsfälle
Zahlungsverlauf eines Händlers verfolgen
Überwache eingehende USDC-Zahlungen:Zahlungsbeleg erstellen
Erstelle einen detaillierten Beleg für einen bestimmten Transfer:Verdächtige Transfermuster überwachen
Erkenne ungewöhnliche Transferaktivitäten:Feed für Transferaktivitäten erstellen
Erstelle einen benutzerfreundlichen Aktivitäts-Feed:Zahlungen abgleichen
Gleiche Transfers mit erwarteten Zahlungen ab:Seitennavigation
Navigiere bei Wallets mit vielen Transfers mithilfe des Parameterscursor und pagination.hasMore durch die Ergebnisse:
Best Practices
- Filtere clientseitig nach bestimmten Token. Die API gibt alle Token-Transfers zurück. Filtere nach der Adresse
mint, um bestimmte Token wie USDC oder SOL zu verfolgen. - Kombiniere sie mit der Identity API. Verwende den Identity-endpoint, um lesbare Namen für bekannte Gegenparteien wie Börsen und Protokolle anzuzeigen.
- Speichere aktuelle Transfers im Cache. Transferdaten ändern sich nicht. Speichere Ergebnisse im Cache und rufe nur Transfers ab, die seit deiner letzten Abfrage hinzugekommen sind.
- Verwende Seitennavigation für den vollständigen Verlauf. Implementiere eine Seitennavigation, um Wallets mit Tausenden von Transfers effizient zu verarbeiten.
- Behandle fehlende Symbole. Nicht alle Token haben ein Feld
symbol. Verwende stattdessen die Mint-Adresse, wennsymbolden Wertnullhat.
Transfers im Vergleich zum Transaktionsverlauf
Verwende Transfers, wenn dich nur Zahlungen interessieren. Verwende den Transaktionsverlauf, wenn du vollständige Daten zu Saldoänderungen benötigst.
Häufige Fehler
Nächste Schritte
Wallet History
Vollständiger Transaktionsverlauf mit Saldoänderungen pro Transaktion.
Wallet API Overview
Alle Endpoints der Wallet API und gemeinsame Konventionen.
API Reference
request- und response-Schemas für Token-Transfers.