Ü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).
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.
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.
- JavaScript
- Python
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=ascfür aufsteigend (älteste zuerst) odersort-order=descfü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 wiegetSignaturesForAddress 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.
Filter
Nach Transaktionstyp filtern
Erhalten Sie nur bestimmte Transaktionstypen, wie NFT-Verkäufe, Token-Transfers oder Swaps:- NFT-Verkäufe
- Token-Transfers
- Swaps
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.
before-signature für absteigend, after-signature für aufsteigend) bei Ihrer nächsten Anfrage.
Fortsetzungsschleife für Typfilter (vollständiges Beispiel)
Fortsetzungsschleife für Typfilter (vollständiges Beispiel)
- 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-signaturebei der Suche in absteigender Reihenfolge (Standard, neueste zuerst). - Verwenden Sie
after-signaturebei 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.Nach Zeitbereich filtern
Nach Zeitbereich filtern
Erhalten Sie Transaktionen innerhalb eines bestimmten Zeitfensters:
- Letzte 24 Stunden
- Bestimmter Datumsbereich
Nach Slotbereich filtern
Nach Slotbereich filtern
Erhalten Sie Transaktionen innerhalb eines bestimmten Slotbereichs:
Sortierreihenfolge ändern
Sortierreihenfolge ändern
Erhalten Sie Transaktionen in aufsteigender Reihenfolge (älteste zuerst):
Transfers für verwandte Token-Konten einbeziehen
Transfers für verwandte Token-Konten einbeziehen
Abfrage der vollständigen Historie einer Wallet, einschließlich zugehöriger Token-Adressen (ATAs):
Mehrere Filter kombinieren
Mehrere Filter kombinieren
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: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.