Zum Hauptinhalt springen
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 Parameter cursor 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:

Nach Richtung filtern

Filtere die Ergebnisse clientseitig, um nur ein- oder ausgehende Transfers zu erhalten:

Abfrageparameter

response-Format

Hinweise zu den Feldern

  • direction: relativ zu der abgefragten Wallet. in steht für empfangene Token (eingehende Zahlung), out für gesendete Token (ausgehende Zahlung).
  • counterparty: bei in-Transfers der Absender, bei out-Transfers der Empfänger.
  • amount: lesbarer Transferbetrag, bereits durch decimals geteilt. Verwende diesen Wert für die Anzeige, beispielsweise 1.5 SOL oder 100.0 USDC.
  • 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 (So11111111111111111111111111111111111111111 für natives SOL).
  • symbol: Token-Symbol. Nicht alle Token haben eines. Verwende stattdessen die Mint-Adresse, wenn symbol den Wert null hat.

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 Parameters cursor 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, wenn symbol den Wert null hat.

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.