Pular para o conteúdo principal
POST
getHistoricalAccountInfo
getHistoricalAccountInfo está em beta. Os parâmetros, preços, formatos de resposta e cobertura de dados podem mudar.

Visão geral

getHistoricalAccountInfo retorna uma conta da Solana como ela estava em um slot anterior ou imediatamente após uma transação específica nesse slot. Esse é um método RPC exclusivo da Helius. O método padrão getAccountInfo retorna apenas o estado atual. A resposta contém os mesmos campos de conta que getAccountInfo, além de lastUpdatedAt: o slot e a transação que gravaram por último o estado que você recebeu. O histórico está disponível a partir do slot 444.959.999 (7 de setembro de 2026), que corresponde ao estado no início da época 1030. As solicitações de slots anteriores retornam o erro -32018. getHistoricalAccountInfo está disponível na mainnet para planos Business ou superiores e custa 0 créditos por chamada durante o período beta. Os preços estão sujeitos a alterações.

Escolha uma posição no histórico

O segundo parâmetro é um objeto de consulta que seleciona qual ponto do histórico será lido: transactionIndex exige slot. Para ler uma conta logo antes da transação no índice N, consulte transactionIndex: N - 1. Para a primeira transação de um slot, consulte o slot anterior sem transactionIndex. Gravações que não são transações, como recompensas de época, são aplicadas no final do slot. Uma consulta com transactionIndex nunca as inclui.

Exemplo de solicitação

Leia a resposta

  • value é a conta como ela estava na posição solicitada ou null se a conta não existia naquele momento: ela ainda não havia sido criada ou já havia sido fechada. Uma resposta null não contém lastUpdatedAt.
  • lastUpdatedAt.slot e lastUpdatedAt.transactionIndex identificam a gravação que produziu esse estado. A gravação ocorreu na posição solicitada ou antes dela.
  • lastUpdatedAt.transactionIndex é null quando a gravação ocorreu fora de uma transação, como no caso de recompensas de época.
  • lastUpdatedAt.slot igual a 444.959.999 com um transactionIndex null significa que a conta não mudou desde o início da cobertura do histórico. Isso não significa que a conta foi gravada nesse slot.
  • context.slot é o slot mais recente que a Helius havia indexado quando atendeu à solicitação, não o slot consultado.
  • Contas de token jsonParsed usam as casas decimais do mint na posição solicitada. Se o mint não puder ser lido nessa posição, a conta usará base64 como alternativa.
Para listar todos os estados anteriores de uma conta, use lastUpdatedAt como cursor. Consulte Percorrer o histórico da conta retroativamente.

Erros

Métodos relacionados

Historical Accounts Guide

Como posições, cobertura e lastUpdatedAt funcionam nos métodos de contas históricas

getHistoricalTokenAccountsByOwner

Liste as contas de token de uma carteira em um slot anterior

getTransactionsForAddress

Encontre o slot e o transactionIndex das transações que você deseja inspecionar

getAccountInfo

Leia o estado atual de uma conta

Parâmetros da solicitação

string
obrigatório
Endereço da conta a ser lida, codificado em Base-58.
number
Slot no qual o estado será lido. Retorna a conta como ela estava no final desse slot. O slot mais antigo compatível é 444959999, que corresponde ao estado no início da época 1030. Quando omitido, lê o slot indexado mais recente, limitado pelo commitment solicitado.
number
Posição de uma transação dentro do slot. Retorna o estado da conta imediatamente após a execução dessa transação, em vez de no final do slot. Exige slot.
string
padrão:"base64"
Formato de codificação dos dados da conta. base58 e binário não são compatíveis.
  • base64
  • base64+zstd
  • jsonParsed
object
Retorna apenas uma parte dos dados de cada conta. Aplica-se às codificações base64 e base64+zstd.
number
obrigatório
Deslocamento em bytes a partir do qual a leitura deve começar.
number
obrigatório
Número de bytes a serem retornados.
string
padrão:"finalized"
Nível de commitment. processed não é compatível.
  • finalized
  • confirmed
number
O slot mínimo no qual a solicitação pode ser avaliada.

Autorizações

api-key
string
query
obrigatório

Sua chave de API da Helius. Você pode obter uma gratuitamente no painel.

Corpo

application/json
jsonrpc
enum<string>
padrão:2.0
obrigatório

A versão do protocolo JSON-RPC.

Opções disponíveis:
2.0
Exemplo:

"2.0"

id
string
padrão:1
obrigatório

Um identificador exclusivo para a solicitação.

Exemplo:

"1"

method
enum<string>
padrão:getHistoricalAccountInfo
obrigatório

O nome do método RPC a ser invocado.

Opções disponíveis:
getHistoricalAccountInfo
Exemplo:

"getHistoricalAccountInfo"

params
(string | Consulta · object | Configuração · object)[]
obrigatório

Array contendo o endereço da conta, um objeto de consulta opcional que seleciona a posição no histórico e um objeto de configuração opcional.

Required array length: 1 - 3 elements

Endereço codificado em base 58 da conta a ser consultada.

Exemplo:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Resposta

O estado histórico da conta foi recuperado com sucesso.

jsonrpc
enum<string>

A versão do protocolo JSON-RPC.

Opções disponíveis:
2.0
Exemplo:

"2.0"

id
string

Identificador correspondente à solicitação.

Exemplo:

"1"

result
object