Langsung ke konten utama
POST
getHistoricalAccountInfo
getHistoricalAccountInfo berada dalam versi Beta. Parameter, harga, format respons, dan cakupan data dapat berubah.

Ringkasan

getHistoricalAccountInfo mengembalikan akun Solana sebagaimana kondisinya pada slot sebelumnya, atau tepat setelah transaksi tertentu dalam slot tersebut. Ini adalah metode RPC eksklusif Helius. getAccountInfo standar hanya mengembalikan status saat ini. Respons memiliki kolom akun yang sama seperti getAccountInfo, ditambah lastUpdatedAt: slot dan transaksi yang terakhir kali menulis status yang Anda terima. Riwayat tersedia mulai slot 444,959,999 (7 September 2026), yaitu status pada awal epoch 1030. Permintaan untuk slot yang lebih awal mengembalikan kesalahan -32018. getHistoricalAccountInfo tersedia di mainnet untuk paket Business dan yang lebih tinggi, serta dikenai biaya 0 kredit per panggilan selama periode beta. Harga dapat berubah.

Pilih posisi dalam riwayat

Parameter kedua adalah objek kueri yang memilih titik dalam riwayat yang akan dibaca: transactionIndex memerlukan slot. Untuk membaca akun tepat sebelum transaksi pada indeks N, kueri transactionIndex: N - 1. Untuk transaksi pertama dalam sebuah slot, kueri slot sebelumnya tanpa transactionIndex. Penulisan nontransaksi, seperti imbalan epoch, diterapkan pada akhir slot. Kueri dengan transactionIndex tidak pernah menyertakannya.

Contoh permintaan

Baca respons

  • value adalah akun sebagaimana kondisinya pada posisi yang diminta, atau null jika akun belum ada saat itu: akun belum dibuat atau sudah ditutup. Respons null tidak memiliki lastUpdatedAt.
  • lastUpdatedAt.slot dan lastUpdatedAt.transactionIndex mengidentifikasi penulisan yang menghasilkan status ini. Penulisan tersebut berada pada atau sebelum posisi yang Anda minta.
  • lastUpdatedAt.transactionIndex bernilai null saat penulisan terjadi di luar transaksi, seperti imbalan epoch.
  • lastUpdatedAt.slot bernilai 444,959,999 dengan transactionIndex bernilai null berarti akun belum berubah sejak cakupan riwayat dimulai. Ini tidak berarti akun ditulis dalam slot tersebut.
  • context.slot adalah slot terbaru yang telah diindeks Helius saat melayani permintaan, bukan slot yang Anda kueri.
  • Akun token jsonParsed menggunakan jumlah desimal mint pada posisi yang diminta. Jika mint tidak dapat dibaca pada posisi tersebut, akun kembali menggunakan base64.
Untuk mencantumkan setiap status akun sebelumnya, gunakan lastUpdatedAt sebagai kursor. Lihat Telusuri mundur riwayat akun.

Kesalahan

Metode terkait

Historical Accounts Guide

Cara kerja posisi, cakupan, dan lastUpdatedAt untuk metode akun historis

getHistoricalTokenAccountsByOwner

Cantumkan akun token dompet pada slot sebelumnya

getTransactionsForAddress

Temukan slot dan transactionIndex dari transaksi yang ingin Anda periksa

getAccountInfo

Baca status akun saat ini

Parameter Permintaan

string
wajib
Alamat akun yang akan dibaca, dengan pengodean Base-58.
number
Slot tempat status akan dibaca. Mengembalikan akun sebagaimana kondisinya pada akhir slot ini. Slot paling awal yang didukung adalah 444959999, yaitu status pada awal epoch 1030. Jika dihilangkan, membaca slot terindeks terbaru yang dibatasi sesuai tingkat komitmen yang diminta.
number
Posisi transaksi dalam slot. Mengembalikan status akun tepat setelah transaksi tersebut dieksekusi, bukan pada akhir slot. Memerlukan slot.
string
default:"base64"
Format pengodean untuk data akun. base58 dan biner tidak didukung.
  • base64
  • base64+zstd
  • jsonParsed
object
Hanya mengembalikan sebagian data setiap akun. Berlaku untuk pengodean base64 dan base64+zstd.
number
wajib
Offset byte untuk mulai membaca.
number
wajib
Jumlah byte yang akan dikembalikan.
string
default:"finalized"
Tingkat komitmen. processed tidak didukung.
  • finalized
  • confirmed
number
Slot minimum tempat permintaan dapat dievaluasi.

Otorisasi

api-key
string
query
wajib

Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di dasbor.

Body

application/json
jsonrpc
enum<string>
default:2.0
wajib

Versi protokol JSON-RPC.

Opsi yang tersedia:
2.0
Contoh:

"2.0"

id
string
default:1
wajib

Pengidentifikasi unik untuk permintaan.

Contoh:

"1"

method
enum<string>
default:getHistoricalAccountInfo
wajib

Nama metode RPC yang akan dipanggil.

Opsi yang tersedia:
getHistoricalAccountInfo
Contoh:

"getHistoricalAccountInfo"

params
(string | Kueri · object | Konfigurasi · object)[]
wajib

Larik yang berisi alamat akun, objek kueri opsional yang memilih posisi dalam riwayat, dan objek konfigurasi opsional.

Required array length: 1 - 3 elements

Alamat akun yang akan dibaca, dengan pengodean base-58.

Contoh:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Respons

Status akun historis berhasil diambil.

jsonrpc
enum<string>

Versi protokol JSON-RPC.

Opsi yang tersedia:
2.0
Contoh:

"2.0"

id
string

Pengidentifikasi yang cocok dengan permintaan.

Contoh:

"1"

result
object