Die Wallet API befindet sich im Beta-Stadium. Endpunkte und Antwortformate können sich ändern.
Überblick
Der Token Transfers-Endpunkt ruft alle Token-Übertragungsaktivitäten für ein Solana-Wallet ab, einschließlich detaillierter Absender- und Empfängerinformationen. Im Gegensatz zur vollständigen Transaktionshistorie konzentriert sich dieser Endpunkt speziell auf Überweisungen, was ihn ideal für die Zahlungsnachverfolgung und Überwachungen von Übertragungen macht. Der Endpunkt liefert bis zu 100 Überweisungen pro Anfrage (Standard 50). Verwenden Sie dencursor-Parameter mit pagination.nextCursor, um die nächste Seite abzurufen, und lesen Sie pagination.hasMore, um zu wissen, wann mehr Ergebnisse verfügbar sind.
Wann man dies verwenden sollte
Verwenden Sie die Token Transfers API, wenn Sie:- Zahlungen nachverfolgen: Überwachen eingehender Zahlungen für Zahlungsabwickler.
- Einen Überweisungs-Feed erstellen: Zeigen Sie einen einfachen “gesendet/empfangen”-Aktivitäts-Feed an.
- Bestimmte Tokens überwachen: Verfolgen Sie Transfers eines bestimmten Tokens (z.B. USDC-Zahlungen).
- Gegenparteien identifizieren: Sehen Sie, wer Tokens gesendet oder empfangen hat.
- Belege generieren: Erstellen Sie Zahlungsbelege mit Absender-/Empfängerangaben.
- Verdächtige Aktivitäten erkennen: Überwachen Sie ungewöhnliche Übertragungsmuster.
Schnellstart
Basisabfrage für Übertragungen
Abrufen der letzten eingehenden und ausgehenden Überweisungen:- JavaScript
- Python
- cURL
Nach Richtung filtern
Filtern Sie die Ergebnisse auf der Client-Seite, um nur eingehende oder ausgehende Überweisungen zu erhalten:- Nur eingehend
- Nur ausgehend
Abfrageparameter
Antwortformat
Feldnotizen
direction: relativ zu dem Wallet, das Sie abfragen.insind Tokens empfangen (eingehende Zahlung);outsind Tokens gesendet (ausgehende Zahlung).counterparty: fürin-Überweisungen der Absender; fürout-Überweisungen der Empfänger.amount: menschlich lesbarer Überweisungsbetrag, bereits geteilt durchdecimals. Verwenden Sie dies zur Anzeige (z.B.1.5SOL,100.0USDC).amountRaw: derselbe Betrag als rohe Ganzzahlzeichenfolge, vor Dezimalanpassung (z.B."1500000000"für 1,5 SOL). Als Zeichenfolge serialisiert, um Verlust von Gleitkommapräzision zu vermeiden. Verwenden Sie dies für On-Chain-Anweisungen oder präzise Arithmetik:amount = parseInt(amountRaw) / 10**decimals.mint: Token-Mint-Adresse (So11111111111111111111111111111111111111111für nativen SOL).symbol: Token-Symbol. Nicht alle Tokens haben eins; verwenden Sie die Mint-Adresse, wennsymbolnullist.
Anwendungsfälle
Zahlungshistorie für einen Händler verfolgen
Überwachen eingehender USDC-Zahlungen:Einen Zahlungsbeleg generieren
Erstellen Sie einen detaillierten Beleg für eine bestimmte Überweisung:Verdächtige Übertragungsmuster überwachen
Erkennen Sie ungewöhnliche Übertragungsaktivitäten:Einen Überweisungsaktivitäts-Feed erstellen
Erstellen Sie einen benutzerfreundlichen Aktivitäts-Feed:Zahlungen abgleichen
Abgleichen von Überweisungen mit erwarteten Zahlungen:Paginierung
Für Wallets mit vielen Überweisungen, blättern Sie durch die Ergebnisse mit demcursor-Parameter und pagination.hasMore:
Beste Praktiken
- Filtern Sie clientseitig nach bestimmten Tokens. Die API gibt alle Token-Überweisungen zurück. Filtern Sie nach
mint-Adresse, um bestimmte Tokens wie USDC oder SOL nachzuverfolgen. - Mit der Identity API kombinieren. Verwenden Sie den Identity-Endpunkt, um menschenlesbare Namen für bekannte Gegenparteien anzuzeigen (Börsen, Protokolle und andere).
- Speichern Sie zuletzt durchgeführte Überweisungen im Cache. Überweisungsdaten ändern sich nicht. Speichern Sie Ergebnisse im Cache und rufen Sie nur neue Transfers seit Ihrer letzten Abfrage ab.
- Paginy für komplette Historie. Implementieren Sie die Paginierung, um Wallets mit Tausenden von Überweisungen effizient zu verwalten.
- Ein fehlendes Symbol handhaben. Nicht alle Tokens haben ein
symbol-Feld. Verwenden Sie die Mint-Adresse, wennsymbolnullist.
Überweisungen vs Transaktionshistorie
Verwenden Sie Transfers, wenn Sie sich nur für Zahlungen interessieren. Verwenden Sie Transaction History, wenn Sie vollständige Saldoänderungsdaten benötigen.
Häufige Fehler
Nächste Schritte
Wallet-Historie
Komplette Transaktionshistorie mit Saldoänderungen pro Transaktion.
Wallet API-Übersicht
Alle Wallet API-Endpunkte und gemeinsame Konventionen.
API-Referenz
Anfrage- und Antwortschemata für Token-Überweisungen.