과거 계정
getHistoricalTokenAccountsByOwner
과거 슬롯 또는 특정 트랜잭션 직후에 Solana 지갑이 소유했던 SPL Token 및 Token-2022 계정을 민트 필터와 페이지네이션을 사용해 나열합니다.
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": "유효하지 않은 매개변수"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "인증되지 않음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32005,
"message": "요청이 너무 많음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32603,
"message": "내부 오류"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32002,
"message": "서비스를 사용할 수 없음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "게이트웨이 시간 초과"
},
"id": "1"
}getHistoricalTokenAccountsByOwner은 베타 버전입니다. 매개변수, 가격, 응답 형식 및 데이터 범위가 변경될 수 있습니다.개요
getHistoricalTokenAccountsByOwner은 과거 슬롯 또는 해당 슬롯의 특정 트랜잭션 직후에 지갑이 소유했던 SPL Token 및 Token-2022 계정을 반환합니다. Helius 전용 RPC 메서드입니다. 표준 getTokenAccountsByOwner은 현재 상태만 반환합니다.
jsonParsed 인코딩을 사용하면 토큰 수량에 요청한 위치 시점의 각 민트 소수 자릿수가 적용되므로, 잔액에는 해당 시점에 지갑이 보유했던 수량이 반영됩니다.
기록은 슬롯 444,959,999(2026년 9월 7일)부터 사용할 수 있으며, 이는 에포크 1030 시작 시점의 상태입니다.
getHistoricalTokenAccountsByOwner은 Business 이상 요금제의 메인넷에서 사용할 수 있으며, 베타 기간에는 호출당 0크레딧이 부과됩니다. 가격은 변경될 수 있습니다.
getTokenAccountsByOwner와의 차이점
- 민트 또는 프로그램 필터는 선택 사항입니다. 필터를 지정하지 않으면 지갑이 소유했던 모든 토큰 계정을 가져옵니다. 결과 범위를 좁히려면 구성 객체(세 번째 매개변수)에
mint또는programId중 하나만 설정하세요. - 두 번째 매개변수는 쿼리 객체입니다. 민트 또는 프로그램 필터가 아니라 기록에서의 위치를 선택합니다.
result.value은 객체입니다. 배열이 아니라accounts및paginationKey이 포함된 객체입니다.
기록에서 위치 선택
두 번째 매개변수는 쿼리 객체입니다.- 생략하거나
{}: 요청한 커밋먼트를 상한으로 하는 가장 최근에 인덱싱된 슬롯입니다. { "slot": 445000000 }: 슬롯 445,000,000의 끝입니다.{ "slot": 445000000, "transactionIndex": 10 }: 해당 슬롯에서 인덱스 10의 트랜잭션이 실행된 직후입니다.
요청 예시
이 요청은 슬롯 445,000,000의 끝에서 지갑이 보유한 USDC 토큰 계정을 반환합니다.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" }
]
}'
모든 토큰 계정 페이지네이션
결과는 민트순으로 정렬된 후 토큰 계정 주소순으로 정렬됩니다. 각 응답은value.accounts과 <mint>:<tokenAccount> 형식의 커서인 value.paginationKey을 반환합니다. null이 될 때까지 다음 요청에 다시 전달하세요.
페이지가 짧거나 비어 있어도
paginationKey이 포함될 수 있습니다. paginationKey이 null인 경우에만 마지막에 도달한 것입니다.slot을 명시적으로 전달하세요. 이를 생략하면 각 페이지가 가장 최근에 인덱싱된 슬롯을 읽으므로 서로 다른 시점의 페이지가 반환될 수 있습니다.
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);
응답 읽기
value.accounts의 각 항목에는 토큰 계정의 pubkey와 account 객체가 있습니다. 계정 객체에는 getAccountInfo과 동일한 필드에 더해 lastUpdatedAt이 포함됩니다.
- **
lastUpdatedAt.slot**과 **lastUpdatedAt.transactionIndex**은 이 상태를 생성한 쓰기 작업을 식별합니다. lastUpdatedAt.slot이 444,959,999이고transactionIndex이null인 경우 기록 범위가 시작된 후 토큰 계정이 변경되지 않았음을 의미합니다.- **
context.slot**은 쿼리한 슬롯이 아니라 Helius가 요청을 처리할 때 인덱싱한 가장 최근 슬롯입니다.
오류
| 코드 | 의미 |
|---|---|
-32018 | 슬롯이 기록 범위 시작점(슬롯 444,959,999)보다 이전입니다. |
-32004 | 슬롯이 요청한 커밋먼트에서 허용하는 범위보다 최신입니다. confirmed을 사용하거나 이전 슬롯을 쿼리하세요. |
-32602 | mint과 programId을 모두 지정했거나, programId이 토큰 프로그램이 아니거나, paginationKey의 민트가 mint과 일치하지 않는 등 매개변수가 잘못되었습니다. |
-32601 | 메서드를 찾을 수 없습니다. Helius 메인넷 또는 Gatekeeper 엔드포인트를 호출하세요. 이 메서드는 devnet에서 사용할 수 없습니다. |
관련 메서드
Historical Accounts Guide
과거 계정 메서드에서 위치, 범위 및 lastUpdatedAt이 작동하는 방식
getHistoricalAccountInfo
과거 슬롯의 단일 계정 읽기
getTransactionsForAddress
검사하려는 트랜잭션의 슬롯 및 transactionIndex 찾기
getTokenAccountsByOwnerV2
지갑의 현재 토큰 계정 페이지네이션
요청 매개변수
상태를 읽을 슬롯입니다. 이 슬롯의 끝 시점에 해당하는 계정을 반환합니다. 지원되는 가장 이른 슬롯은 에포크 1030 시작 시점의 상태인 444959999입니다. 생략하면 요청한 커밋먼트를 상한으로 하는 가장 최근에 인덱싱된 슬롯을 읽습니다.
이 토큰 프로그램이 소유한 토큰 계정만 반환합니다. mint와 함께 사용할 수 없습니다.
TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DATokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
계정 데이터의 인코딩 형식입니다. jsonParsed를 사용하면 토큰 수량에 요청한 위치 시점의 민트 소수 자릿수가 적용됩니다. base58 및 binary는 지원되지 않습니다.
base64base64+zstdjsonParsed
이전 응답의 paginationKey에서 가져온
<mint>:<tokenAccount> 형식의 커서입니다. mint도 설정하면 커서의 민트가 해당 값과 일치해야 합니다.인증
Helius API 키입니다. 대시보드에서 무료로 받을 수 있습니다.
본문
application/json
이 페이지가 도움이 되었나요?
⌘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": "유효하지 않은 매개변수"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "인증되지 않음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32005,
"message": "요청이 너무 많음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32603,
"message": "내부 오류"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32002,
"message": "서비스를 사용할 수 없음"
},
"id": "1"
}{
"jsonrpc": "2.0",
"error": {
"code": -32003,
"message": "게이트웨이 시간 초과"
},
"id": "1"
}