Skip to main content
Die Wallet-API befindet sich im Beta-Stadium. Endpunkte und Antwortformate können sich ändern.

Überblick

Der Transaktionshistorie-Endpunkt ruft die vollständige Transaktionshistorie für ein Solana-Wallet unter Verwendung der Enhanced Transactions API ab. Er gibt menschenlesbare, geparste Transaktionen mit Saldoänderungen für jede Transaktion in umgekehrt chronologischer Reihenfolge (neueste zuerst) zurück. Der Endpunkt gibt bis zu 100 Transaktionen pro Anfrage zurück, daher ist die Paginierung manuell. Verwenden Sie den Parameter before mit pagination.nextCursor, um die nächste Seite abzurufen, und lesen Sie pagination.hasMore, um zu erfahren, wann mehr Ergebnisse verfügbar sind. Jede Anfrage ist ein einzelner API-Aufruf und kostet 100 Credits. Der Parameter tokenAccounts steuert, ob Transaktionen, die Token-Konten betreffen, die dem Wallet gehören, einbezogen werden:
  • balanceChanged (empfohlen): Enthält Transaktionen, die Token-Kontosaldi geändert haben, und filtert Spam.
Der Filter tokenAccounts stützt sich auf das Feld owner in den Token-Saldo-Metadaten, das vor Slot 111.491.819 (~Dezember 2022) nicht verfügbar war. Transaktionen mit aktiven Token-Konten vor diesem Slot könnten fehlen. Siehe das getTransactionsForAddress-Tutorial für einen Workaround.

Wann man dies verwendet

Verwenden Sie die Transaction History API, wenn Sie Folgendes benötigen:
  • Anzeigen eines Transaktions-Feeds: Zeigen Sie Benutzern ihre vollständige Transaktionshistorie an.

Schnellstart

Grundlegende Abfrage der Historie

Holen Sie sich die neuesten Transaktionen mit Saldoänderungen:

Paginierung für vollständige Historie

Holen Sie alle Transaktionen mit Paginierung unter Verwendung des Parameters before ab:

Abfrageparameter

Verfügbare Transaktionstypen

Der Parameter type unterstützt die Filterung nach diesen Transaktionstypen: SWAP, TRANSFER, NFT_SALE, NFT_BID, NFT_LISTING, NFT_MINT, NFT_CANCEL_LISTING, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT, COMPRESSED_NFT_TRANSFER, COMPRESSED_NFT_BURN, CREATE_STORE, WHITELIST_CREATOR, ADD_TO_WHITELIST, REMOVE_FROM_WHITELIST, AUCTION_MANAGER_CLAIM_BID, EMPTY_PAYMENT_ACCOUNT, UPDATE_PRIMARY_SALE_METADATA, ADD_TOKEN_TO_VAULT, ACTIVATE_VAULT, INIT_VAULT, INIT_BANK, INIT_STAKE, MERGE_STAKE, SPLIT_STAKE, CREATE_AUCTION_MANAGER, START_AUCTION, CREATE_AUCTION_MANAGER_V2, UPDATE_EXTERNAL_PRICE_ACCOUNT, EXECUTE_TRANSACTION

Filterbeispiele

Antwortformat

Felderklärungen

  • timestamp: Unix-Sekunden. Kann null sein für sehr neue Transaktionen, die noch nicht vollständig verarbeitet wurden.

Beispielhafte Saldoänderungen

Anwendungsfälle

Gesamtes Handelsvolumen berechnen

Alle Überweisungen summieren, um das Handelsvolumen zu erhalten:

Steuerbericht erstellen

Erstellen Sie einen Transaktionsbericht für die Steuererklärung:

Fehlgeschlagene Transaktionen verfolgen

Alle fehlgeschlagenen Transaktionen finden, um Fehler zu verstehen:

Historischen Saldo rekonstruieren

Berechnen, wie der Saldo zu einem bestimmten Zeitpunkt war:
Für den genauen Saldo eines einzelnen Tokens zu einem bestimmten Zeitpunkt liest der Historical Balance Endpunkt ihn direkt aus den On-Chain-Post-Saldi anstelle von clientseitigen Summenänderungen.

Transaktionsgebühren analysieren

Gesamte gezahlte Gebühren berechnen:

Beste Praktiken

  • Verwenden Sie Paginierung für die vollständige Historie. Einige Wallets haben Hunderttausende von Transaktionen; paginieren Sie immer, wenn Sie alle abrufen.

Häufige Fehler

Nächste Schritte

Token Transfers

Eine reine Überweisungsansicht mit Sender-/Empfängerinformationen — einfacher als die vollständige Historie.

Wallet API Übersicht

Alle Wallet-API-Endpunkte und gemeinsamen Konventionen.

API-Referenz

Anfrage- und Antwortschemata für die Transaktionshistorie.