Akun Historis
getHistoricalAccountInfo
Baca akun Solana apa pun sebagaimana kondisinya pada slot sebelumnya atau tepat setelah transaksi tertentu, dengan pengodean getAccountInfo dan posisi penulisan terakhir.
POST
/
getHistoricalAccountInfo
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalAccountInfo",
"params": [
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
{
"slot": 445000000
},
{
"encoding": "jsonParsed"
}
]
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalAccountInfo",
"params": ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", { "slot": 445000000 }, { "encoding": "jsonParsed" }]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getHistoricalAccountInfo',
params: [
'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
{slot: 445000000},
{encoding: 'jsonParsed'}
]
})
};
fetch('https://mainnet.helius-rpc.com/?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => '1',
'method' => 'getHistoricalAccountInfo',
'params' => [
'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
[
'slot' => 445000000
],
[
'encoding' => 'jsonParsed'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mainnet.helius-rpc.com/?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.helius-rpc.com/?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 468129571
},
"value": {
"lamports": 531589475273,
"owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"data": [
"<string>"
],
"executable": false,
"rentEpoch": 123,
"space": 82,
"lastUpdatedAt": {
"slot": 444999837,
"transactionIndex": 700
}
}
}
}{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Invalid params"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Unauthorized"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32005,
"message": "Too many requests"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32603,
"message": "Internal error"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32002,
"message": "Service unavailable"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "Gateway timeout"
},
"id": "1"
}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:| Kueri | Mengembalikan akun |
|---|---|
Dihilangkan atau {} | Pada slot terindeks terbaru, dibatasi sesuai tingkat komitmen yang diminta |
{ "slot": 445000000 } | Pada akhir slot 445,000,000 |
{ "slot": 445000000, "transactionIndex": 10 } | Tepat setelah transaksi pada indeks 10 di slot 445,000,000 dieksekusi |
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
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalAccountInfo",
"params": [
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
{ "slot": 445000000 },
{ "encoding": "jsonParsed" }
]
}'
Baca respons
valueadalah akun sebagaimana kondisinya pada posisi yang diminta, ataunulljika akun belum ada saat itu: akun belum dibuat atau sudah ditutup. Responsnulltidak memilikilastUpdatedAt.lastUpdatedAt.slotdanlastUpdatedAt.transactionIndexmengidentifikasi penulisan yang menghasilkan status ini. Penulisan tersebut berada pada atau sebelum posisi yang Anda minta.lastUpdatedAt.transactionIndexbernilainullsaat penulisan terjadi di luar transaksi, seperti imbalan epoch.lastUpdatedAt.slotbernilai 444,959,999 dengantransactionIndexbernilainullberarti akun belum berubah sejak cakupan riwayat dimulai. Ini tidak berarti akun ditulis dalam slot tersebut.context.slotadalah slot terbaru yang telah diindeks Helius saat melayani permintaan, bukan slot yang Anda kueri.- Akun token
jsonParsedmenggunakan jumlah desimal mint pada posisi yang diminta. Jika mint tidak dapat dibaca pada posisi tersebut, akun kembali menggunakan base64.
lastUpdatedAt sebagai kursor. Lihat Telusuri mundur riwayat akun.
Kesalahan
| Kode | Arti |
|---|---|
-32018 | Slot berada sebelum cakupan riwayat dimulai (slot 444,959,999) |
-32004 | Slot lebih baru daripada yang diizinkan oleh tingkat komitmen yang diminta. Gunakan confirmed atau kueri slot yang lebih lama |
-32602 | Parameter tidak valid, seperti transactionIndex tanpa slot, pengodean base58, atau kolom konfigurasi yang tidak dikenal |
-32601 | Metode tidak ditemukan. Panggil endpoint mainnet Helius atau Gatekeeper Anda; metode ini tidak tersedia di devnet |
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
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.
Posisi transaksi dalam slot. Mengembalikan status akun tepat setelah transaksi tersebut dieksekusi, bukan pada akhir slot. Memerlukan slot.
Format pengodean untuk data akun. base58 dan biner tidak didukung.
base64base64+zstdjsonParsed
Hanya mengembalikan sebagian data setiap akun. Berlaku untuk pengodean base64 dan base64+zstd.
Otorisasi
Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di dasbor.
Body
application/json
Larik yang berisi alamat akun, objek kueri opsional yang memilih posisi dalam riwayat, dan objek konfigurasi opsional.
Required array length:
1 - 3 elementsAlamat akun yang akan dibaca, dengan pengodean base-58.
Contoh:
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
Apakah halaman ini membantu?
⌘I
getHistoricalAccountInfo
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalAccountInfo",
"params": [
"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
{
"slot": 445000000
},
{
"encoding": "jsonParsed"
}
]
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalAccountInfo",
"params": ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", { "slot": 445000000 }, { "encoding": "jsonParsed" }]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getHistoricalAccountInfo',
params: [
'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
{slot: 445000000},
{encoding: 'jsonParsed'}
]
})
};
fetch('https://mainnet.helius-rpc.com/?api-key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'jsonrpc' => '2.0',
'id' => '1',
'method' => 'getHistoricalAccountInfo',
'params' => [
'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
[
'slot' => 445000000
],
[
'encoding' => 'jsonParsed'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://mainnet.helius-rpc.com/?api-key="
payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
.header("Content-Type", "application/json")
.body("{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.helius-rpc.com/?api-key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"jsonrpc\": \"2.0\",\n \"id\": \"1\",\n \"method\": \"getHistoricalAccountInfo\",\n \"params\": [\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 468129571
},
"value": {
"lamports": 531589475273,
"owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"data": [
"<string>"
],
"executable": false,
"rentEpoch": 123,
"space": 82,
"lastUpdatedAt": {
"slot": 444999837,
"transactionIndex": 700
}
}
}
}{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Invalid params"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Unauthorized"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32005,
"message": "Too many requests"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32603,
"message": "Internal error"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32002,
"message": "Service unavailable"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "Gateway timeout"
},
"id": "1"
}