getTokenAccountsByOwnerV2
getTokenAccountsByOwnerV2 adalah versi getTokenAccountsByOwner yang disempurnakan dengan paginasi berbasis kursor dan pembaruan changedSinceSlot untuk portofolio token Solana berskala besar.
Ikhtisar
getTokenAccountsByOwnerV2 adalah versi yang disempurnakan dari metode standar getTokenAccountsByOwner, yang dirancang khusus untuk membuat kueri portofolio token secara efisien dan menangani dompet dengan kepemilikan token yang sangat banyak. Metode ini memperkenalkan paginasi berbasis kursor dan kemampuan pembaruan inkremental.
- Paginasi berbasis kursor: Konfigurasikan batas dari 1 hingga 10.000 akun token per permintaan
- Pembaruan inkremental: Gunakan
changedSinceSlotuntuk mengambil hanya akun token yang baru saja diubah - Skalabilitas portofolio: Tangani dompet dengan ribuan akun token secara efisien
- Kompatibilitas mundur: Mendukung semua parameter dan filter
getTokenAccountsByOwneryang ada withContextopsional:truemenambahkanslotdanapiVersiondi bawahresult.context; hilangkan atau gunakanfalseagar keduanya tidak disertakan
Manfaat Utama
Large Portfolios
Real-time Tracking
changedSinceSlot untuk pembaruan inkrementalwithContext (opsional)
Boolean pada objek konfigurasi (params[2]). Hanya struktur result yang berubah, bukan filter, batas, atau paginasi. Jika dihilangkan atau bernilai false: result.value adalah array akun token. Jika bernilai true: result.context ditambah result.value sebagai objek (accounts, paginationKey). Jika Anda menangani keduanya, buat percabangan berdasarkan Array.isArray(result.value).
Praktik Terbaik Paginasi
Kueri Portofolio Dasar
Pembaruan Portofolio Inkremental
Dukungan Program Token
Migrasi dari getTokenAccountsByOwner
Migrasinya sederhana—cukup tambahkan parameter paginasi ke kueri Anda yang sudah ada:Metode Terkait
getTokenAccountsByOwner
getProgramAccountsV2
Parameter Permintaan
confirmedfinalizedprocessed
true, mengembalikan result.context (metadata snapshot: slot, apiVersion) dan menempatkan
accounts serta paginationKey di bawah result.value sebagai objek. Jika bernilai false
atau dihilangkan, result.value adalah array akun token untuk halaman ini, dengan paginationKey
pada result. Filter dan batas yang sama berlaku.base58base64base64+zstdjsonParsed
Otorisasi
Body
Versi protokol JSON-RPC.
2.0 "2.0"
Pengidentifikasi unik untuk permintaan.
"1"
Nama metode RPC yang akan dipanggil.
getTokenAccountsByOwnerV2 "getTokenAccountsByOwnerV2"
Parameter untuk mengueri akun token berpaginasi yang dimiliki oleh kunci publik tertentu.
Alamat dompet Solana (pubkey) milik pemilik akun yang kepemilikan tokennya akan dikueri, sebagai string yang dikodekan dalam base-58.
"A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd"
Respons
Berhasil mengambil akun token berpaginasi berdasarkan pemilik.
Versi protokol JSON-RPC.
2.0 "2.0"
Pengidentifikasi yang cocok dengan permintaan.
"1"
Akun token berpaginasi saat withContext bernilai false atau tidak dicantumkan. Sesuai dengan struktur umum tempat daftar akun berupa array di result.value (tidak disarangkan di bawah accounts).
- tanpa withContext
- dengan withContext