Übersicht
Der Transaction History endpoint gibt einen lesbaren Transaktionsverlauf für jede Solana-Adresse zurück. Statt rohe Anweisungsdaten und Kontolisten zu verarbeiten, erhältst du strukturierte Informationen zu folgenden Punkten:- Was in der Transaktion passiert ist (Übertragungen, Swaps, NFT-Aktivitäten).
- Welche Konten beteiligt waren.
- Wie viel SOL oder wie viele token übertragen wurden.
- Zugehörige Metadaten (Mint-Adressen der token, Namen und Symbole der token und mehr).
GET request an /v0/addresses/{address}/transactions. Intern basiert dieser endpoint auf der RPC-Methode getTransactionsForAddress.
Verwendung
- Du zeigst Nutzern den Transaktionsverlauf einer Adresse an, etwa in Wallets, Portfolio-Trackern oder Explorern.
- Du möchtest einen vorab geparsten, lesbaren Verlauf, ohne einen eigenen Decoder zu schreiben.
- Du musst den Verlauf nach Transaktionstyp, Zeitraum oder slot-Bereich filtern.
- Du benötigst den vollständigen token-Verlauf einer Wallet einschließlich zugehöriger token accounts (ATAs) – siehe unten.
getTransactionsForAddress der moderne, Helius-native Weg mit serverseitiger Filterung und Abfragen von token accounts.
Schnellstart
1
Get your API key
Registriere dich unter dashboard.helius.dev und kopiere deinen API key.
2
GET the address transactions endpoint
Rufe den Transaktionsverlauf für eine beliebige Solana-Adresse ab.
- JavaScript
- Python
3
Filter and paginate
Grenze die Ergebnisse mit den folgenden
type-, Zeit- und slot-Filtern ein. Durchlaufe anschließend Adressen mit hohem Volumen seitenweise mithilfe von Signatur-Cursorn.Netzwerkunterstützung
Request-Parameter
Zeitbasierte Filterung
slot-basierte Filterung
Hinweise zur Filterung:
- Zeitparameter verwenden Unix-Zeitstempel (Sekunden seit der Epoche). slot-Parameter verwenden Solana-slot-Nummern.
- Du kannst zeitbasierte und slot-basierte Filter nicht im selben request kombinieren.
- Verwende
sort-order=ascfür eine aufsteigende Reihenfolge (älteste zuerst) odersort-order=descfür eine absteigende Reihenfolge (neueste zuerst). - Verwende Zeit- oder slot-Filter, um den Suchbereich einzugrenzen, wenn du den ungefähren Zeitraum kennst. Kombiniere sie mit
limit, um die Seitengröße zu steuern.
Zugehörige token accounts
Auf Solana hält eine Wallet token nicht direkt. Stattdessen besitzt die Wallet token accounts, in denen sich die token befinden. Wenn dir jemand USDC sendet, landet es in deinem USDC-token account und nicht unter deiner primären Wallet-Adresse. Dieser endpoint ist einzigartig, weil er den vollständigen token-Verlauf einer Wallet einschließlich zugehöriger token accounts (ATAs) abfragen kann. Native RPC-Methoden wiegetSignaturesForAddress schließen ATAs nicht ein.
Der Filter token-accounts steuert dieses Verhalten:
none(Standardwert) – gibt nur Transaktionen zurück, die direkt auf die Wallet-Adresse verweisen. Verwende diese Option, wenn dich nur direkte Interaktionen mit der Wallet interessieren.balanceChanged(empfohlen) – gibt Transaktionen zurück, die auf die Wallet-Adresse verweisen oder den Saldo eines token account ändern, das der Wallet gehört. Dadurch werden Spam und nicht zugehörige Vorgänge wie Gebührenerhebungen oder Delegierungen herausgefiltert. Du erhältst eine übersichtliche Ansicht relevanter Wallet-Aktivitäten.all– gibt alle Transaktionen zurück, die auf die Wallet-Adresse oder ein token account der Wallet verweisen.
Filter
Nach Transaktionstyp filtern
Rufe nur bestimmte Transaktionstypen ab, etwa NFT-Verkäufe, Übertragungen von token oder Swaps:- NFT Sales
- Token Transfers
- Swaps
Typfilterung zur Laufzeit
Die Typfilterung erfolgt zur Laufzeit: Die API durchsucht Transaktionen nacheinander, bis sie mindestens 50 übereinstimmende Elemente findet. Wenn sie innerhalb des Suchfensters keine Treffer findet, gibt sie einen Fehler mit einer Signatur zurück, ab der du die Suche fortsetzen kannst. Das ist das erwartete Verhalten und kein Ausfall.
before-signature für absteigende oder after-signature für aufsteigende Reihenfolge.
Continuation loop for type filters (full example)
Continuation loop for type filters (full example)
- Bei Typfiltern durchsucht die API jeweils bis zu 50 Transaktionen.
- Wenn keine Treffer gefunden werden, setze die Suche mit der Signatur aus der Fehlermeldung fort.
- Verwende
before-signaturefür die Suche in absteigender Reihenfolge (Standardwert, neueste zuerst). - Verwende
after-signaturefür die Suche in aufsteigender Reihenfolge (älteste zuerst). Dies ist für chronologische Suchen erforderlich. - Lege eine maximale Anzahl von Wiederholungsversuchen fest, um Endlosschleifen zu verhindern.
Beispiele
Die folgenden Szenarien decken Zeit- und slot-Bereiche, die Sortierreihenfolge, ATAs und kombinierte Filter ab.Filter by time range
Filter by time range
Rufe Transaktionen innerhalb eines bestimmten Zeitfensters ab:
- Last 24 Hours
- Specific Date Range
Filter by slot range
Filter by slot range
Rufe Transaktionen innerhalb eines bestimmten slot-Bereichs ab:
Change sort order
Change sort order
Rufe Transaktionen in aufsteigender Reihenfolge ab (älteste zuerst):
Combine multiple filters
Combine multiple filters
Kombiniere die Typfilterung mit einem Zeitraum und einer benutzerdefinierten Sortierreihenfolge:
Paginierung
Durchlaufe bei Adressen mit hohem Volumen die Ergebnisse seitenweise. Verwende dazu die letzte Signatur jedes Batches als Cursor:before-signature in jedem Schleifendurchlauf:
Nächste Schritte
getTransactionsForAddress
Der moderne, Helius-native Ersatz für Transaktionsverläufe und backfill.
Wallet API
REST endpoints für lesbare Wallet-Daten: Salden, Verläufe und Übertragungen.
Parse Transactions
Parse eine oder mehrere Transaktionssignaturen in lesbare Daten.
Getting Data overview
Vergleiche alle Helius-Optionen zum Abfragen von Solana-Daten.