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

Ikhtisar

getHistoricalTokenAccountsByOwner mengembalikan akun SPL Token dan Token-2022 yang dimiliki dompet pada slot sebelumnya, atau tepat setelah transaksi tertentu dalam slot tersebut. Ini adalah metode RPC eksklusif Helius. getTokenAccountsByOwner standar hanya mengembalikan status saat ini. Dengan pengodean jsonParsed, jumlah token menggunakan nilai desimal setiap mint pada posisi yang diminta sehingga saldo mencerminkan jumlah yang dimiliki dompet pada saat tersebut. Riwayat tersedia mulai slot 444,959,999 (7 September 2026), yaitu status pada awal epoch 1030. getHistoricalTokenAccountsByOwner tersedia di mainnet untuk paket Business dan yang lebih tinggi, serta dikenai biaya 0 kredit per panggilan selama periode beta. Harga dapat berubah.

Perbedaannya dari getTokenAccountsByOwner

  • Filter mint atau program bersifat opsional. Tanpa filter, Anda mendapatkan setiap akun token yang dimiliki dompet. Untuk mempersempit hasil, tetapkan mint atau programId dalam objek konfigurasi (parameter ketiga), bukan keduanya.
  • Parameter kedua adalah objek kueri yang memilih posisi dalam riwayat, bukan filter mint atau program.
  • result.value adalah objek dengan accounts dan paginationKey, bukan array.

Pilih posisi dalam riwayat

Parameter kedua adalah objek kueri:
  • Dihilangkan atau {}: slot terindeks terbaru, dibatasi pada tingkat komitmen yang diminta.
  • { "slot": 445000000 }: akhir slot 445,000,000.
  • { "slot": 445000000, "transactionIndex": 10 }: tepat setelah transaksi pada indeks 10 dalam slot tersebut dieksekusi.
Lihat Panduan Akun Historis untuk mengetahui cara kerja posisi.

Contoh permintaan

Permintaan ini mengembalikan akun token USDC milik dompet pada akhir slot 445,000,000:

Lakukan paginasi pada semua akun token

Hasil diurutkan berdasarkan mint, lalu berdasarkan alamat akun token. Setiap respons mengembalikan value.accounts dan value.paginationKey, yaitu kursor dalam format <mint>:<tokenAccount>. Teruskan kembali dalam permintaan berikutnya hingga nilainya menjadi null.
Sebuah halaman dapat berisi sedikit data, atau bahkan kosong, tetapi tetap menyertakan paginationKey. Hanya paginationKey dengan nilai null yang berarti Anda telah mencapai akhir.
Selalu teruskan slot secara eksplisit saat Anda melakukan paginasi. Jika Anda menghilangkannya, setiap halaman membaca slot terindeks terbaru sehingga halaman dapat berasal dari waktu yang berbeda.

Baca respons

Setiap entri dalam value.accounts memiliki pubkey milik akun token dan objek account. Objek akun memiliki bidang yang sama seperti getAccountInfo, ditambah lastUpdatedAt:
  • lastUpdatedAt.slot dan lastUpdatedAt.transactionIndex mengidentifikasi penulisan yang menghasilkan status ini.
  • lastUpdatedAt.slot sebesar 444,959,999 dengan transactionIndex bernilai null berarti akun token belum berubah sejak cakupan riwayat dimulai.
  • context.slot adalah slot terbaru yang telah diindeks Helius saat melayani permintaan, bukan slot yang Anda kueri.

Kesalahan

Metode terkait

Historical Accounts Guide

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

getHistoricalAccountInfo

Baca satu akun pada slot sebelumnya

getTransactionsForAddress

Temukan slot dan transactionIndex dari transaksi yang ingin Anda periksa

getTokenAccountsByOwnerV2

Lakukan paginasi pada akun token dompet saat ini

Parameter Permintaan

string
wajib
Alamat dompet yang memiliki akun token, dengan pengodean Base-58. Teruskan dompet pemilik, bukan akun token.
number
Slot tempat status akan dibaca. Mengembalikan akun sebagaimana keadaannya 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 pada tingkat komitmen yang diminta.
number
Posisi transaksi dalam slot. Mengembalikan status akun tepat setelah transaksi tersebut dieksekusi, bukan pada akhir slot. Memerlukan slot.
string
Hanya kembalikan akun token untuk mint ini. Tidak dapat digabungkan dengan programId.
string
Hanya kembalikan akun token yang dimiliki oleh program token ini. Tidak dapat digabungkan dengan mint.
  • TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
  • TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
string
default:"base64"
Format pengodean untuk data akun. Dengan jsonParsed, jumlah token menggunakan nilai desimal mint pada posisi yang diminta. base58 dan biner tidak didukung.
  • base64
  • base64+zstd
  • jsonParsed
object
Hanya kembalikan sebagian data setiap akun. Berlaku untuk pengodean base64 dan base64+zstd.
number
wajib
Offset byte tempat pembacaan dimulai.
number
wajib
Jumlah byte yang akan dikembalikan.
number
default:"5000"
Jumlah maksimum akun token yang akan dikembalikan (1-5,000).
string
Kursor dari paginationKey respons sebelumnya, dalam format &lt;mint&gt;:&lt;tokenAccount&gt;. Jika Anda juga menetapkan mint, mint kursor harus cocok dengannya.
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 bisa mendapatkannya 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:getHistoricalTokenAccountsByOwner
wajib

Nama metode RPC yang akan dipanggil.

Opsi yang tersedia:
getHistoricalTokenAccountsByOwner
Contoh:

"getHistoricalTokenAccountsByOwner"

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

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

Required array length: 1 - 3 elements

Alamat dompet dengan pengodean base-58 yang memiliki akun token. Masukkan dompet pemilik, bukan akun token.

Contoh:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Respons

Berhasil mengambil halaman akun token historis.

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