Zum Hauptinhalt springen
POST
getHistoricalAccountInfo
getHistoricalAccountInfo befindet sich in der Betaphase. Parameter, Preise, response-Formate und Datenabdeckung können sich ändern.

Übersicht

getHistoricalAccountInfo gibt ein Solana-Konto so zurück, wie es in einem vergangenen slot oder direkt nach einer bestimmten Transaktion in diesem slot war. Diese RPC-Methode ist exklusiv bei Helius verfügbar. Das standardmäßige getAccountInfo gibt nur den aktuellen Zustand zurück. Die response enthält dieselben Kontofelder wie getAccountInfo sowie lastUpdatedAt: den slot und die Transaktion des letzten Schreibvorgangs, der den empfangenen Zustand erzeugt hat. Der Verlauf ist ab slot 444,959,999 (7. September 2026) verfügbar. Das entspricht dem Zustand zu Beginn der Epoche 1030. Requests für frühere slots geben den Fehler -32018 zurück. getHistoricalAccountInfo ist im Mainnet für Business-Tarife und höher verfügbar. Während der Betaphase kostet jeder Aufruf 0 Credits. Die Preise können sich ändern.

Position im Verlauf auswählen

Der zweite Parameter ist ein Abfrageobjekt, das den zu lesenden Zeitpunkt im Verlauf auswählt: transactionIndex erfordert slot. Um ein Konto direkt vor der Transaktion mit dem Index N zu lesen, frage transactionIndex: N - 1 ab. Frage für die erste Transaktion in einem slot den vorherigen slot ohne transactionIndex ab. Schreibvorgänge außerhalb von Transaktionen, etwa Epochenbelohnungen, werden am Ende des slot angewendet. Eine Abfrage mit transactionIndex enthält sie nie.

Beispiel-request

response lesen

  • value ist das Konto, wie es an der angeforderten Position war, oder null, wenn das Konto damals nicht existierte: Es war entweder noch nicht erstellt oder bereits geschlossen. Eine null-response enthält kein lastUpdatedAt.
  • lastUpdatedAt.slot und lastUpdatedAt.transactionIndex identifizieren den Schreibvorgang, der diesen Zustand erzeugt hat. Der Schreibvorgang liegt an oder vor der angeforderten Position.
  • lastUpdatedAt.transactionIndex ist null, wenn der Schreibvorgang außerhalb einer Transaktion erfolgte, etwa bei Epochenbelohnungen.
  • lastUpdatedAt.slot mit dem Wert 444,959,999 und einem null-Wert für transactionIndex bedeutet, dass sich das Konto seit Beginn der Verlaufsabdeckung nicht geändert hat. Es bedeutet nicht, dass das Konto in diesem slot geschrieben wurde.
  • context.slot ist der neueste slot, den Helius beim Verarbeiten des request indiziert hatte, nicht der von dir abgefragte slot.
  • jsonParsed token Konten verwenden die Dezimalstellen des Mint zum Zeitpunkt der angeforderten Position. Wenn der Mint an dieser Position nicht gelesen werden kann, verwendet das Konto ersatzweise base64.
Verwende lastUpdatedAt als Cursor, um alle früheren Zustände eines Kontos aufzulisten. Siehe Kontoverlauf rückwärts durchlaufen.

Fehler

Verwandte Methoden

Historical Accounts Guide

So funktionieren Positionen, Abdeckung und lastUpdatedAt bei Methoden für historische Konten

getHistoricalTokenAccountsByOwner

Liste die token Konten einer Wallet in einem vergangenen slot auf

getTransactionsForAddress

Finde den slot und den transactionIndex der Transaktionen, die du untersuchen möchtest

getAccountInfo

Lies den aktuellen Zustand eines Kontos

Request-Parameter

string
erforderlich
Base58-codierte Adresse des zu lesenden Kontos.
number
slot, an dem der Zustand gelesen werden soll. Gibt das Konto so zurück, wie es am Ende dieses slot war. Der früheste unterstützte slot ist 444959999. Das entspricht dem Zustand zu Beginn der Epoche 1030. Wenn dieser Parameter weggelassen wird, liest die Methode den neuesten indizierten slot, begrenzt auf das angeforderte commitment.
number
Position einer Transaktion innerhalb des slot. Gibt den Kontozustand direkt nach Ausführung dieser Transaktion zurück, nicht am Ende des slot. Erfordert slot.
string
Standard:"base64"
Codierungsformat für Kontodaten. base58 und binary werden nicht unterstützt.
  • base64
  • base64+zstd
  • jsonParsed
object
Gibt nur einen Ausschnitt der Daten jedes Kontos zurück. Gilt für die Codierungen base64 und base64+zstd.
number
erforderlich
Byte-Offset, ab dem gelesen werden soll.
number
erforderlich
Anzahl der zurückzugebenden Bytes.
string
Standard:"finalized"
commitment-Stufe. processed wird nicht unterstützt.
  • finalized
  • confirmed
number
Der minimale slot, an dem der request ausgewertet werden kann.

Autorisierungen

api-key
string
query
erforderlich

Dein Helius API key. Du erhältst ihn kostenlos im Dashboard.

Body

application/json
jsonrpc
enum<string>
Standard:2.0
erforderlich

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
Beispiel:

"2.0"

id
string
Standard:1
erforderlich

Eine eindeutige Kennung für den request.

Beispiel:

"1"

method
enum<string>
Standard:getHistoricalAccountInfo
erforderlich

Der Name der aufzurufenden RPC-Methode.

Verfügbare Optionen:
getHistoricalAccountInfo
Beispiel:

"getHistoricalAccountInfo"

params
(string | Abfrage · object | Konfiguration · object)[]
erforderlich

Array mit der Kontoadresse, einem optionalen Abfrageobjekt zur Auswahl der Position im Verlauf und einem optionalen Konfigurationsobjekt.

Required array length: 1 - 3 elements

Base58-kodierte Adresse des zu lesenden Kontos.

Beispiel:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Antwort

Der historische Kontozustand wurde erfolgreich abgerufen.

jsonrpc
enum<string>

Die Version des JSON-RPC-Protokolls.

Verfügbare Optionen:
2.0
Beispiel:

"2.0"

id
string

Kennung, die dem request entspricht.

Beispiel:

"1"

result
object