Skip to main content
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 den cursor-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:

Nach Richtung filtern

Filtern Sie die Ergebnisse auf der Client-Seite, um nur eingehende oder ausgehende Überweisungen zu erhalten:

Abfrageparameter

Antwortformat

Feldnotizen

  • direction: relativ zu dem Wallet, das Sie abfragen. in sind Tokens empfangen (eingehende Zahlung); out sind Tokens gesendet (ausgehende Zahlung).
  • counterparty: für in-Überweisungen der Absender; für out-Überweisungen der Empfänger.
  • amount: menschlich lesbarer Überweisungsbetrag, bereits geteilt durch decimals. Verwenden Sie dies zur Anzeige (z.B. 1.5 SOL, 100.0 USDC).
  • 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 (So11111111111111111111111111111111111111111 für nativen SOL).
  • symbol: Token-Symbol. Nicht alle Tokens haben eins; verwenden Sie die Mint-Adresse, wenn symbol null ist.

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 dem cursor-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, wenn symbol null ist.

Ü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.