Skip to main content
Die Enhanced Transactions API ist ein Legacy-Produkt im Wartungsmodus. Sie funktioniert weiterhin und diese Seiten bleiben verfügbar, aber es werden keine neuen Parser-Typen oder Funktionen hinzugefügt. Ihr Nachfolger ist Parsed Events, der Anweisungen über den IDL-Katalog decodiert und sich in der offenen Beta auf kostenpflichtigen Plänen befindet – der Migrationsleitfaden erklärt den Umstieg Schritt für Schritt. Sie können auch getTransactionsForAddress für Transaktionshistorie und Backfill sowie die Wallet API für lesbare Wallet-Daten nutzen.

Übersicht

Der Transaction History-Endpunkt liefert eine lesbare Transaktionshistorie für jede Solana-Adresse. Statt rohen Anweisungsdaten und Kontenlisten erhalten Sie strukturierte Informationen über:
  • Was in der Transaktion passiert ist (Transfers, Swaps, NFT-Aktivitäten).
  • Welche Konten beteiligt waren.
  • Wie viel SOL oder wie viele Tokens transferiert wurden.
  • Zugehörige Metadaten (Token-Mint-Adressen, Token-Namen, Token-Symbole und mehr).
Senden Sie eine GET-Anfrage an /v0/addresses/{address}/transactions. Im Hintergrund wird dieser Endpunkt von der getTransactionsForAddress RPC-Methode betrieben.

Wann verwenden

  • Sie zeigen einem Benutzer die Transaktionshistorie einer Adresse an (Wallets, Portfoliotracking, Explorer).
  • Sie möchten eine vorgeparste, lesbare Historie ohne eigenen Decoder.
  • Sie müssen die Historie nach Transaktionstyp, Zeit- oder Slotbereich filtern.
  • Sie benötigen die vollständige Token-Historie einer Wallet, einschließlich zugehöriger Token-Konten (ATAs) — siehe unten.
Für neue Builds ist getTransactionsForAddress der moderne, Helius-native Weg mit serverseitigen Filtern und Token-Konten-Abfragen.

Schnellstart

1

Holen Sie sich Ihren API-Schlüssel

Melden Sie sich bei dashboard.helius.dev an und kopieren Sie Ihren API-Schlüssel.
2

Abfrage des Transaktionsendpunkts der Adresse

Abrufen der Transaktionshistorie für eine beliebige Solana-Adresse.
3

Filtern und paginieren

Verengen Sie die Ergebnisse mit den unten stehenden type, Zeit- und Slotfiltern, dann durchlaufen Sie Adressen mit hohem Volumen mithilfe von Signatur-Cursorn.

Netzwerkunterstützung

Anforderungsparameter

Zeitbasierte Filterung

Slot-basierte Filterung

Anmerkungen zur Filterung:
  • Zeitparameter verwenden Unix-Zeitstempel (Sekunden seit Epoch); Slot-Parameter verwenden Solana-Slot-Nummern.
  • Sie können Zeit- und Slot-basierte Filter nicht in derselben Anfrage kombinieren.
  • Verwenden Sie sort-order=asc für aufsteigend (älteste zuerst) oder sort-order=desc für absteigend (neueste zuerst).
  • Verwenden Sie Zeit- oder Slot-Filter, um den Suchraum zu reduzieren, wenn Sie den ungefähren Zeitraum kennen, und kombinieren Sie sie mit limit, um die Seitengröße zu steuern.

Zugehörige Token-Konten

Auf Solana hält eine Wallet nicht direkt Tokens. Stattdessen besitzt die Wallet Token-Konten, und diese Token-Konten halten die Tokens. Wenn jemand Ihnen USDC sendet, geht es an Ihr USDC-Token-Konto und nicht an Ihre Haupt-Wallet-Adresse. Dieser Endpunkt ist einzigartig, da er eine Wallets vollständige Token-Historie einschließlich der zugehörigen Token-Konten (ATAs) abfragen kann. Native RPC-Methoden wie getSignaturesForAddress schließen ATAs nicht ein. Der token-accounts-Filter steuert dieses Verhalten:
  • none (Standard) — gibt nur Transaktionen zurück, die direkt auf die Wallet-Adresse verweisen. Verwenden Sie dies, wenn Sie sich nur für direkte Wallet-Interaktionen interessieren.
  • balanceChanged (empfohlen) — gibt Transaktionen zurück, die die Wallet-Adresse referenzieren oder den Saldo eines von der Wallet gehaltenen Token-Kontos ändern. Dies filtert Spam und nicht zusammenhängende Operationen wie Gebühreneinziehungen oder Delegationen heraus und bietet Ihnen einen sauberen Überblick über die wesentliche Wallet-Aktivität.
  • all — gibt alle Transaktionen zurück, die die Wallet-Adresse oder ein von der Wallet gehaltenes Token-Konto referenzieren.
Der token-accounts-Filter baut auf dem owner-Feld in den Token-Saldo-Metadaten auf, das vor Slot 111,491,819 (~Dezember 2022) nicht verfügbar war. Transaktionen, die vor diesem Slot mit Token-Konten aktiv waren, können in den balanceChanged- und all-Ergebnissen fehlen. Sehen Sie sich das getTransactionsForAddress-Tutorial für einen Workaround mit einem vollständigen Code-Beispiel an.

Filter

Nach Transaktionstyp filtern

Erhalten Sie nur bestimmte Transaktionstypen, wie NFT-Verkäufe, Token-Transfers oder Swaps:
Für die vollständige Liste der unterstützten Transaktionstypen sehen Sie sich die Transaction History API-Referenz an.

Filterung zur Laufzeit

Die Typfilterung erfolgt zur Laufzeit: Die API durchsucht Transaktionen nacheinander, bis sie mindestens 50 passende Elemente findet. Wenn innerhalb des Suchfensters keine Übereinstimmungen gefunden werden können, wird ein Fehler mit einer Signatur zurückgegeben, um die Suche fortzusetzen. Dies ist erwartetes Verhalten, kein Fehler.
Wenn innerhalb des aktuellen Suchfensters keine übereinstimmenden Transaktionen gefunden werden, gibt die API eine Fehlermeldung wie diese zurück:
Um fortzufahren, verwenden Sie die Signatur aus der Fehlermeldung mit dem entsprechenden Parameter (before-signature für absteigend, after-signature für aufsteigend) bei Ihrer nächsten Anfrage.
Wichtige Punkte:
  • Die API durchsucht bei der Verwendung von Typfiltern bis zu 50 Transaktionen auf einmal.
  • Wenn keine Übereinstimmungen gefunden werden, verwenden Sie die Signatur aus der Fehlermeldung, um die Suche fortzusetzen.
  • Verwenden Sie before-signature bei der Suche in absteigender Reihenfolge (Standard, neueste zuerst).
  • Verwenden Sie after-signature bei der Suche in aufsteigender Reihenfolge (älteste zuerst) — erforderlich für chronologische Suchen.
  • Implementieren Sie ein maximales Wiederholungs-Limit, um Endlosschleifen zu vermeiden.

Beispiele

Die folgenden Szenarien umfassen Zeit- und Slotbereiche, Sortierreihenfolge, ATAs und kombinierte Filter.
Erhalten Sie Transaktionen innerhalb eines bestimmten Zeitfensters:
Erhalten Sie Transaktionen innerhalb eines bestimmten Slotbereichs:
Erhalten Sie Transaktionen in aufsteigender Reihenfolge (älteste zuerst):
Abfrage der vollständigen Historie einer Wallet, einschließlich zugehöriger Token-Adressen (ATAs):
Kombinieren Sie Typfilterung mit einem Zeitbereich und benutzerdefinierter Sortierreihenfolge:

Paginierung

Bei Adressen mit hohem Volumen blättern Sie durch die Ergebnisse, indem Sie die letzte Signatur in jedem Batch als Cursor verwenden:
Um innerhalb eines Zeitbereichs zu paginieren, behalten Sie die Zeitfilter bei jeder Anfrage bei und geben Sie den before-signature-Cursor in jeder Schleife weiter:

Nächste Schritte

getTransactionsForAddress

Der moderne, Helius-native Ersatz für Transaktionshistorie und Backfill.

Wallet API

REST-Endpunkte für lesbare Wallet-Daten: Salden, Historie und Überweisungen.

Transaktionen parsen

Parsen Sie eine oder mehrere Transaktionssignaturen in lesbare Daten.

Datenübersicht abrufen

Vergleichen Sie jede Helius-Option zur Abfrage von Solana-Daten.