Skip to main content
A Enhanced Transactions API é um produto legado em modo de manutenção. Ainda funciona e estas páginas continuam disponíveis, mas não está recebendo novos tipos de parser ou desenvolvimentos de recursos. Seu sucessor é o Parsed Events, que decodifica instruções através do catálogo IDL e está em beta aberto em planos pagos — o guia de migração cobre a mudança passo a passo. Você também pode usar getTransactionsForAddress para histórico de transações e preenchimento retroativo, e a Wallet API para dados de carteira legíveis por humanos.

Visão Geral

O endpoint de Histórico de Transações retorna um histórico de transações legível para qualquer endereço Solana. Em vez de lidar com dados brutos de instruções e listas de contas, você obtém informações estruturadas sobre:
  • O que aconteceu na transação (transferências, trocas, atividades de NFT).
  • Quais contas estavam envolvidas.
  • Quantos SOL ou quantos tokens foram transferidos.
  • Metadados associados (endereços de mint de tokens, nomes de tokens, símbolos de tokens e mais).
Envie uma solicitação GET para /v0/addresses/{address}/transactions. Sob o capô, este endpoint é alimentado pelo método RPC getTransactionsForAddress.

Quando usar isso

  • Você está exibindo o histórico de transações de um endereço para usuários (carteiras, rastreadores de portfólio, exploradores).
  • Você deseja um histórico pré-analisado e legível sem escrever seu próprio decodificador.
  • Você precisa filtrar o histórico por tipo de transação, intervalo de tempo ou intervalo de slots.
  • Você precisa do histórico completo de tokens de uma carteira, incluindo contas de token associadas (ATAs) — veja abaixo.
Para novos projetos, getTransactionsForAddress é o caminho nativo moderno da Helius com filtragem no servidor e buscas de contas de token.

Início Rápido

1

Obtenha sua chave de API

Inscreva-se em dashboard.helius.dev e copie sua chave de API.
2

GET no endpoint de transações do endereço

Recupere o histórico de transações para qualquer endereço Solana.
3

Filtrar e paginar

Restrinja os resultados com os filtros type, de tempo e de slot abaixo, depois pagine por endereços de alto volume com cursores de assinatura.

Suporte de Rede

Parâmetros da Solicitação

Filtragem baseada em tempo

Filtragem baseada em slots

Notas sobre filtragem:
  • Parâmetros de tempo usam timestamps Unix (segundos desde a época); parâmetros de slot usam números de slots Solana.
  • Você não pode combinar filtros baseados em tempo e em slots na mesma solicitação.
  • Use sort-order=asc para ascendente (mais antigo primeiro) ou sort-order=desc para descendente (mais recente primeiro).
  • Use filtros de tempo ou de slots para reduzir o espaço de busca quando você souber o período aproximado, e emparelhe-os com limit para controlar o tamanho da página.

Contas de token associadas

No Solana, uma carteira não possui tokens diretamente. Em vez disso, a carteira possui contas de token, e essas contas de token possuem os tokens. Quando alguém te envia USDC, ele vai para sua conta de token USDC em vez de para o endereço principal da sua carteira. Este endpoint é único porque pode consultar o histórico completo de tokens de uma carteira, incluindo contas de token associadas (ATAs). Métodos nativos de RPC como getSignaturesForAddress não incluem ATAs. O filtro token-accounts controla este comportamento:
  • none (padrão) — apenas retorna transações que referenciam diretamente o endereço da carteira. Use isso quando você se importa apenas com interações diretas da carteira.
  • balanceChanged (recomendado) — retorna transações que referenciam o endereço da carteira ou modificam o saldo de uma conta de token possuída pela carteira. Isso filtra spam e operações não relacionadas como cobrança de taxas ou delegações, oferecendo uma visão limpa da atividade significativa da carteira.
  • all — retorna todas as transações que referenciam o endereço da carteira ou qualquer conta de token possuída pela carteira.
O filtro token-accounts depende do campo owner nos metadados de saldo de tokens, que não estava disponível antes do slot 111,491,819 (~dezembro de 2022). Transações envolvendo contas de token ativas antes deste slot podem estar ausentes dos resultados balanceChanged e all. Veja o tutorial getTransactionsForAddress para uma solução alternativa com um exemplo completo de código.

Filtros

Filtrar por tipo de transação

Obtenha apenas tipos específicos de transação, como vendas de NFT, transferências de tokens ou trocas:
Para a lista completa de tipos de transação suportados, veja a referência da API de Histórico de Transações.

Filtragem por tipo em tempo de execução

A filtragem por tipo acontece em tempo de execução: a API busca transações sequencialmente até encontrar pelo menos 50 itens correspondentes. Se não encontrar nenhuma correspondência dentro da janela de busca, retorna um erro com uma assinatura para continuar a busca a partir de. Isso é um comportamento esperado, não uma falha.
Quando nenhuma transação correspondente é encontrada dentro da janela de busca atual, a API retorna uma resposta de erro assim:
Para continuar, use a assinatura da mensagem de erro com o parâmetro apropriado (before-signature para descendente, after-signature para ascendente) em sua próxima solicitação.
Pontos chave:
  • A API busca até 50 transações por vez ao usar filtros de tipo.
  • Se não encontrar correspondências, use a assinatura da mensagem de erro para continuar buscando.
  • Use before-signature ao buscar em ordem descendente (padrão, mais recente primeiro).
  • Use after-signature ao buscar em ordem ascendente (mais antigo primeiro) — necessário para buscas cronológicas.
  • Implemente um limite máximo de tentativas para prevenir loops infinitos.

Exemplos

Os seguintes cenários cobrem intervalos de tempo e slots, ordem de classificação, ATAs e filtros combinados.
Obtenha transações dentro de uma janela de tempo específica:
Obtenha transações dentro de um intervalo específico de slots:
Obtenha transações em ordem ascendente (mais antigo primeiro):
Consulte o histórico completo de uma carteira, incluindo endereços de token associados (ATAs):
Combine filtragem de tipo com um intervalo de tempo e ordem de classificação personalizada:

Paginação

Para endereços de alto volume, pagine através dos resultados usando a última assinatura em cada lote como cursor:
Para paginar dentro de um intervalo de tempo, mantenha os filtros de tempo em cada solicitação e avance o cursor before-signature a cada loop:

Próximos passos

getTransactionsForAddress

O substituto moderno e nativo da Helius para histórico de transações e preenchimento retroativo.

Wallet API

Endpoints REST para dados de carteira legíveis: saldos, histórico e transferências.

Parse Transactions

Analise uma ou mais assinaturas de transação em dados legíveis.

Visão geral de Obtenção de Dados

Compare cada opção da Helius para consulta de dados Solana.