Historische Konten
getHistoricalTokenAccountsByOwner
Liste die SPL-Token- und Token-2022-Konten auf, die einer Solana-Wallet bei einem früheren slot oder direkt nach einer bestimmten Transaktion gehörten. Unterstützt Mint-Filter und Seitennavigation.
POST
/
getHistoricalTokenAccountsByOwner
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalTokenAccountsByOwner",
"params": [
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
{
"slot": 445000000
},
{
"encoding": "jsonParsed",
"limit": 2
}
]
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalTokenAccountsByOwner",
"params": [
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
{ "slot": 445000000 },
{
"encoding": "jsonParsed",
"limit": 2
}
]
}
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: 'getHistoricalTokenAccountsByOwner',
params: [
'86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
{slot: 445000000},
{encoding: 'jsonParsed', limit: 2}
]
})
};
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' => 'getHistoricalTokenAccountsByOwner',
'params' => [
'86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
[
'slot' => 445000000
],
[
'encoding' => 'jsonParsed',
'limit' => 2
]
]
]),
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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 468129571
},
"value": {
"accounts": [
{
"pubkey": "EKyGnXReqmmXyqBHmMjV2CKCLafJS47xyhXXZ5WuFMxD",
"account": {
"lamports": 531589475273,
"owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"data": [
"<string>"
],
"executable": false,
"rentEpoch": 123,
"space": 82,
"lastUpdatedAt": {
"slot": 444999837,
"transactionIndex": 700
}
}
}
],
"paginationKey": "11112zAgXhc6hGfdfr5anSY91mq7Cs4HHpSVEQc4ASG:EKyGnXReqmmXyqBHmMjV2CKCLafJS47xyhXXZ5WuFMxD"
}
}
}{
"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"
}getHistoricalTokenAccountsByOwner befindet sich in der Betaphase. Parameter, Preise, response-Formate und Datenabdeckung können sich ändern.Übersicht
getHistoricalTokenAccountsByOwner gibt die SPL-Token- und Token-2022-Konten zurück, die einer Wallet bei einem früheren slot oder unmittelbar nach einer bestimmten Transaktion in diesem slot gehörten. Diese RPC-Methode ist exklusiv bei Helius verfügbar. Die standardmäßige Methode getTokenAccountsByOwner gibt nur den aktuellen Zustand zurück.
Bei der Kodierung jsonParsed verwenden Token-Beträge die Dezimalstellen des jeweiligen Mint an der angefragten Position. Die Guthaben spiegeln somit wider, was die Wallet zu diesem Zeitpunkt hielt.
Der Verlauf ist ab slot 444.959.999 (7. September 2026) verfügbar. Dies entspricht dem Zustand zu Beginn von Epoche 1030.
getHistoricalTokenAccountsByOwner 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.
Unterschiede zu getTokenAccountsByOwner
- Der Mint- oder Programmfilter ist optional. Ohne Filter erhältst du alle Token-Konten, die der Wallet gehörten. Um die Ergebnisse einzugrenzen, lege entweder
mintoderprogramIdim Konfigurationsobjekt (dem dritten Parameter) fest, aber nicht beides. - Der zweite Parameter ist das Abfrageobjekt, das die Position im Verlauf auswählt, und kein Mint- oder Programmfilter.
result.valueist ein Objekt mitaccountsundpaginationKey, kein Array.
Position im Verlauf auswählen
Der zweite Parameter ist ein Abfrageobjekt:- Weggelassen oder
{}: der neueste indexierte slot, begrenzt durch das angefragte commitment. { "slot": 445000000 }: das Ende von slot 445.000.000.{ "slot": 445000000, "transactionIndex": 10 }: unmittelbar nachdem die Transaktion mit Index 10 in diesem slot ausgeführt wurde.
Beispiel-request
Dieser request gibt die USDC-Token-Konten der Wallet am Ende von slot 445.000.000 zurück:curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalTokenAccountsByOwner",
"params": [
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
{ "slot": 445000000 },
{ "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "encoding": "jsonParsed" }
]
}'
Durch alle Token-Konten blättern
Die Ergebnisse werden zuerst nach Mint und dann nach der Adresse des Token-Kontos sortiert. Jede response gibtvalue.accounts und value.paginationKey zurück. Letzteres ist ein Cursor im Format <mint>:<tokenAccount>. Übergib ihn im nächsten request erneut, bis er null ist.
Eine Seite kann kurz oder sogar leer sein und trotzdem
paginationKey enthalten. Erst wenn paginationKey den Wert null hat, hast du das Ende erreicht.slot. Wenn du den Wert weglässt, liest jede Seite den neuesten indexierten slot. Die Seiten können dann von unterschiedlichen Zeitpunkten stammen.
const url = `https://mainnet.helius-rpc.com/?api-key=${process.env.HELIUS_API_KEY}`;
async function getTokenAccountsAt(owner: string, slot: number) {
const accounts = [];
let paginationKey: string | null = null;
do {
const response = await fetch(url, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
jsonrpc: "2.0",
id: "1",
method: "getHistoricalTokenAccountsByOwner",
params: [
owner,
{ slot },
{ encoding: "jsonParsed", limit: 1000, ...(paginationKey && { paginationKey }) },
],
}),
});
const { result, error } = await response.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
accounts.push(...result.value.accounts);
paginationKey = result.value.paginationKey;
} while (paginationKey);
return accounts;
}
const tokenAccounts = await getTokenAccountsAt("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY", 445000000);
response lesen
Jeder Eintrag invalue.accounts enthält pubkey des Token-Kontos und ein account-Objekt. Das Kontoobjekt hat dieselben Felder wie getAccountInfo sowie lastUpdatedAt:
lastUpdatedAt.slotundlastUpdatedAt.transactionIndexidentifizieren den Schreibvorgang, der diesen Zustand erzeugt hat.- Ein
lastUpdatedAt.slotvon 444.959.999 mit einemnull-Wert fürtransactionIndexbedeutet, dass sich das Token-Konto seit Beginn der Verlaufsabdeckung nicht geändert hat. context.slotist der neueste slot, den Helius beim Verarbeiten des request indexiert hatte, nicht der von dir abgefragte slot.
Fehler
| Code | Bedeutung |
|---|---|
-32018 | Der slot liegt vor dem Beginn der Verlaufsabdeckung (slot 444.959.999) |
-32004 | Der slot ist neuer, als es das angefragte commitment erlaubt. Verwende confirmed oder frage einen älteren slot ab |
-32602 | Ungültige Parameter, zum Beispiel sowohl mint als auch programId, ein programId, das kein Token-Programm ist, oder ein paginationKey, dessen Mint nicht mit mint übereinstimmt |
-32601 | Methode nicht gefunden. Rufe deinen Helius-mainnet- oder Gatekeeper-endpoint auf. Die Methode ist im devnet nicht verfügbar |
Zugehörige Methoden
Historical Accounts Guide
So funktionieren Positionen, Abdeckung und lastUpdatedAt bei Methoden für historische Konten
getHistoricalAccountInfo
Lies ein einzelnes Konto bei einem früheren slot
getTransactionsForAddress
Finde slot und transactionIndex der Transaktionen, die du untersuchen möchtest
getTokenAccountsByOwnerV2
Blättere durch die aktuellen Token-Konten einer Wallet
request-Parameter
Base-58-kodierte Adresse der Wallet, der die Token-Konten gehörten. Übergib die Wallet des Inhabers, nicht ein Token-Konto.
slot, dessen Zustand gelesen werden soll. Gibt das Konto am Ende dieses slot zurück. Der früheste unterstützte slot ist 444959999. Dies entspricht dem Zustand zu Beginn von Epoche 1030. Wenn du den Wert weglässt, wird der neueste indexierte slot gelesen, begrenzt durch das angefragte commitment.
Position einer Transaktion innerhalb des slot. Gibt den Kontozustand unmittelbar nach Ausführung dieser Transaktion zurück, statt am Ende des slot. Erfordert slot.
Gibt nur Token-Konten zurück, die diesem Token-Programm gehören. Kann nicht mit mint kombiniert werden.
TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DATokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Kodierungsformat für Kontodaten. Bei jsonParsed verwenden Token-Beträge die Dezimalstellen des Mint an der angefragten Position. base58 und binary werden nicht unterstützt.
base64base64+zstdjsonParsed
Gibt nur einen Ausschnitt der Daten jedes Kontos zurück. Gilt für die Kodierungen base64 und base64+zstd.
Cursor aus paginationKey der vorherigen response im Format
<mint>:<tokenAccount>. Wenn du außerdem mint festlegst, muss der Mint des Cursor damit übereinstimmen.Stufe für commitment. processed wird nicht unterstützt.
finalizedconfirmed
Autorisierungen
Dein Helius API key. Du kannst ihn kostenlos im Dashboard abrufen.
Body
application/json
Array mit der Wallet-Adresse des Eigentümers, einem optionalen Abfrageobjekt zur Auswahl der Position im Verlauf und einem optionalen Konfigurationsobjekt.
Required array length:
1 - 3 elementsBase-58-codierte Adresse der Wallet, der die token accounts gehörten. Übergib die Wallet des Eigentümers, nicht die Adresse eines token account.
Beispiel:
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
War diese Seite hilfreich?
⌘I
getHistoricalTokenAccountsByOwner
curl --request POST \
--url 'https://mainnet.helius-rpc.com/?api-key=' \
--header 'Content-Type: application/json' \
--data '
{
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalTokenAccountsByOwner",
"params": [
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
{
"slot": 445000000
},
{
"encoding": "jsonParsed",
"limit": 2
}
]
}
'import requests
url = "https://mainnet.helius-rpc.com/?api-key="
payload = {
"jsonrpc": "2.0",
"id": "1",
"method": "getHistoricalTokenAccountsByOwner",
"params": [
"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
{ "slot": 445000000 },
{
"encoding": "jsonParsed",
"limit": 2
}
]
}
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: 'getHistoricalTokenAccountsByOwner',
params: [
'86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
{slot: 445000000},
{encoding: 'jsonParsed', limit: 2}
]
})
};
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' => 'getHistoricalTokenAccountsByOwner',
'params' => [
'86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
[
'slot' => 445000000
],
[
'encoding' => 'jsonParsed',
'limit' => 2
]
]
]),
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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\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\": \"getHistoricalTokenAccountsByOwner\",\n \"params\": [\n \"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY\",\n {\n \"slot\": 445000000\n },\n {\n \"encoding\": \"jsonParsed\",\n \"limit\": 2\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"id": "1",
"result": {
"context": {
"slot": 468129571
},
"value": {
"accounts": [
{
"pubkey": "EKyGnXReqmmXyqBHmMjV2CKCLafJS47xyhXXZ5WuFMxD",
"account": {
"lamports": 531589475273,
"owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"data": [
"<string>"
],
"executable": false,
"rentEpoch": 123,
"space": 82,
"lastUpdatedAt": {
"slot": 444999837,
"transactionIndex": 700
}
}
}
],
"paginationKey": "11112zAgXhc6hGfdfr5anSY91mq7Cs4HHpSVEQc4ASG:EKyGnXReqmmXyqBHmMjV2CKCLafJS47xyhXXZ5WuFMxD"
}
}
}{
"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"
}