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).
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.
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.
- JavaScript
- Python
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=ascpara ascendente (mais antigo primeiro) ousort-order=descpara 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
limitpara 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 comogetSignaturesForAddress 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.
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:- Vendas de NFT
- Transferências de Token
- Trocas
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.
before-signature para descendente, after-signature para ascendente) em sua próxima solicitação.
Loop de continuação para filtros de tipo (exemplo completo)
Loop de continuação para filtros de tipo (exemplo completo)
- 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-signatureao buscar em ordem descendente (padrão, mais recente primeiro). - Use
after-signatureao 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.Filtrar por intervalo de tempo
Filtrar por intervalo de tempo
Obtenha transações dentro de uma janela de tempo específica:
- Últimas 24 Horas
- Intervalo de Data Específico
Filtrar por intervalo de slots
Filtrar por intervalo de slots
Obtenha transações dentro de um intervalo específico de slots:
Mudar ordem de classificação
Mudar ordem de classificação
Obtenha transações em ordem ascendente (mais antigo primeiro):
Incluir transferências para contas de token relacionadas
Incluir transferências para contas de token relacionadas
Consulte o histórico completo de uma carteira, incluindo endereços de token associados (ATAs):
Combinar múltiplos filtros
Combinar múltiplos filtros
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: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.