> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getTransactionsForAddress
> API de histórico de transações aprimorada com recursos poderosos de filtragem, ordenação e paginação para recuperar dados abrangentes de transações para qualquer endereço. Suporta ordenação bidirecional, filtragem por tempo/slot/status e paginação eficiente por chave.
## Parâmetros da Solicitação
Endereço da conta Solana para recuperar o histórico de transações (carteira, token, programa, NFT, etc.).
Nível de detalhe da transação a ser retornado.
* `signatures`
* `full`
Ordem de classificação para as transações retornadas.
* `asc`
* `desc`
O nível de compromisso para a solicitação. O `processed` compromisso não é suportado.
* `confirmed`
* `finalized`
Slot de contexto mínimo a ser usado para a solicitação (opcional).
Número máximo de transações por solicitação. Use 1–1000 para transactionDetails:"signatures" e 1–1000 para transactionDetails:"full".
Token de paginação da resposta anterior para obter a próxima página de resultados (formato "slot:position").
Formato de codificação para dados de transação (aplica-se somente quando transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Versão máxima de transação a ser retornada (aplica-se somente quando transactionDetails=full).
Filtros avançados para restringir os resultados das transações.
Filtrar por número de slot.
Maior ou igual ao número de slot.
Maior que o número de slot.
Menor ou igual ao número de slot.
Menor que o número de slot.
Filtrar por timestamp do bloco (timestamp Unix).
Maior ou igual ao timestamp.
Maior que o timestamp.
Menor ou igual ao timestamp.
Menor que o timestamp.
Igual ao timestamp.
Filtrar por assinatura de transação.
Obter transações com assinaturas maiores ou iguais a este valor.
Obter transações após esta assinatura.
Obter transações com assinaturas menores ou iguais a este valor.
Obter transações antes desta assinatura.
Filtrar por status da transação.
* `succeeded`
* `failed`
* `any`
Filtrar transações para contas de token relacionadas. Controla se deve incluir transações envolvendo contas de token de propriedade do endereço.
* `none`
* `balanceChanged`
* `all`
Restringe os resultados às transações onde o endereço consultado participou de uma transferência de token que corresponde a critérios específicos. Todos os campos são opcionais e combinados com a semântica AND.
Endereço da contraparte. Corresponde a transferências cujo outro lado é este endereço.
Direção da transferência em relação ao endereço consultado.
* `in`
* `out`
* `any`
Mint do token para filtrar.
Filtro de intervalo de quantidade bruta na cadeia. Todos os campos são opcionais e podem ser combinados.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de histórico de transações avançado Solana com poderosos recursos de
filtragem, ordenação e paginação para recuperar dados abrangentes de
transações para qualquer endereço.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Ponto de extremidade Mainnet RPC
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade Devnet RPC
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
API de histórico de transações aprimorada que oferece poderosos recursos
de filtragem, ordenação e paginação para recuperar dados de transações
associados a qualquer endereço Solana. Este método avançado supera as
limitações de getSignaturesForAddress oferecendo:
- Ordenação bidirecional (ordem cronológica ascendente/descendente)
- Filtragem avançada por slot, tempo, assinatura e status da transação
- Suporte a contas de token (inclui transações para contas de token
associadas)
- Filtragem de transferências de tokens por contraparte, direção, mint e
valor bruto
- Paginação eficiente de conjunto de chaves usando chaves baseadas em
slot
- Opção para retornar detalhes completos da transação ou apenas
assinaturas
- Suporte para consultas de intervalo de tempo e filtragem de status
Perfeito para criar históricos abrangentes de carteiras, painéis de
análise, trilhas de auditoria e qualquer aplicação que exija análise
detalhada de transações com controle preciso sobre a recuperação de
dados.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: A versão do protocolo JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Um identificador único para a solicitação.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: O nome do método RPC a ser invocado.
default: getTransactionsForAddress
params:
type: array
description: >-
Array contendo o endereço da conta necessária e um objeto de
configuração opcional.
minItems: 1
maxItems: 2
prefixItems:
- type: string
description: >-
Endereço da conta Solana para recuperar o histórico de
transações (carteira, token, programa, NFT, etc.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Configuração de consulta avançada para filtragem,
ordenação e paginação.
properties:
transactionDetails:
type: string
description: Nível de detalhe da transação a ser retornado.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: >-
Ordem de classificação para as transações
retornadas.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
O nível de comprometimento para a solicitação. O
compromisso `processed` não é suportado.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot de contexto mínimo a ser usado para a
solicitação (opcional).
example: 1000
limit:
type: integer
description: >-
Número máximo de transações por solicitação. Use
1-1000 para transactionDetails:"signatures" e 1-1000
para transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Token de paginação da resposta anterior para obter a
próxima página de resultados (formato
"slot:posição").
example: '1053:13'
encoding:
type: string
description: >-
Formato de codificação para dados de transação
(aplica-se apenas quando transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Versão máxima da transação a ser retornada
(aplica-se apenas quando transactionDetails=full).
example: 0
filters:
type: object
description: >-
Filtros avançados para restringir os resultados das
transações.
properties:
slot:
type: object
description: Filtrar por número de slot.
properties:
gte:
type: integer
description: Maior ou igual ao número de slot.
example: 100
gt:
type: integer
description: Maior que o número de slot.
example: 100
lte:
type: integer
description: Menor ou igual ao número de slot.
example: 200
lt:
type: integer
description: Menor que o número de slot.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Filtrar por carimbo de data/hora do bloco
(timestamp Unix).
properties:
gte:
type: integer
description: Maior ou igual ao timestamp.
example: 1640995200
gt:
type: integer
description: Maior que o timestamp.
example: 1640995200
lte:
type: integer
description: Menor ou igual ao timestamp.
example: 1641081600
lt:
type: integer
description: Menor que o timestamp.
example: 1641081600
eq:
type: integer
description: Igual ao timestamp.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filtrar por assinatura de transação.
properties:
gte:
type: string
description: >-
Obter transações com assinaturas maiores ou
iguais a este valor.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: Obter transações após esta assinatura.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Obter transações com assinaturas menores ou
iguais a este valor.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: Obter transações antes desta assinatura.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filtrar por status da transação.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filtrar transações para contas de tokens
relacionadas. Controla se deve incluir
transações envolvendo contas de token de
propriedade do endereço.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filtrar transações onde o endereço consultado
participou de uma transferência de token que
atende a uma contraparte, direção, mint ou faixa
de valor bruto.
additionalProperties: false
items: false
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
responses:
'200':
description: Transações recuperadas com sucesso para o endereço especificado.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
result:
type: object
description: Dados da transação e informações de paginação.
properties:
data:
type: array
description: Lista de informações da transação.
items:
oneOf:
- type: object
description: >-
Resumo da transação no nível de assinatura
(quando transactionDetails é "signatures").
properties:
signature:
type: string
description: >-
Assinatura da transação como uma string
codificada em base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: O slot que contém o bloco com a transação.
example: 1054
transactionIndex:
type: integer
description: >-
O índice baseado em zero da transação dentro
do seu bloco. Útil para determinar a ordem
das transações dentro de um bloco.
example: 42
err:
oneOf:
- type: object
description: Erro se a transação falhou
- type: 'null'
description: >-
Erro se a transação falhou, ou nulo se
bem-sucedido.
example: null
memo:
oneOf:
- type: string
description: Memo associado à transação
- type: 'null'
description: >-
Memo associado à transação, ou nulo se não
houver.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Tempo de produção estimado como
timestamp Unix
- type: 'null'
description: >-
Tempo de produção estimado como timestamp
Unix (segundos desde a época), ou nulo se
não disponível.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Status de confirmação do cluster da
transação
- type: 'null'
description: >-
Status de confirmação do cluster da
transação.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Transação completa com metadados de status
(quando transactionDetails é "full").
properties:
slot:
type: integer
description: O slot que contém o bloco com a transação.
example: 1054
transactionIndex:
type: integer
description: >-
O índice baseado em zero da transação dentro
do seu bloco. Útil para determinar a ordem
das transações dentro de um bloco.
example: 42
transaction:
type: object
description: >-
Objeto de transação codificado ou analisado
conforme a codificação selecionada.
meta:
type: object
description: Metadados de status da transação.
blockTime:
oneOf:
- type: integer
description: >-
Tempo de produção estimado como
timestamp Unix
- type: 'null'
description: >-
Tempo de produção estimado como timestamp
Unix (segundos desde a época), ou nulo se
não disponível.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: >-
Token para recuperar a próxima página de
resultados
- type: 'null'
description: >-
Token de paginação para a próxima página, ou nulo se
não houver mais resultados.
example: '1055:5'
examples:
signaturesResponse:
summary: Resposta com detalhes apenas da assinatura
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: Resposta com detalhes completos da transação
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: >-
Requisição Inválida - Parâmetros de solicitação inválidos ou
solicitação malformada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Parâmetros inválidos
id: '1'
'401':
description: Não Autorizado - Chave de API inválida ou ausente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Não autorizado
id: '1'
'429':
description: Muitas Solicitações - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Muitas solicitações
id: '1'
'500':
description: Erro Interno do Servidor - Um erro ocorreu no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Erro interno
id: '1'
'503':
description: Serviço Indisponível - O serviço está temporariamente indisponível.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Serviço indisponível
id: '1'
'504':
description: Tempo Limite do Gateway - A solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite do gateway
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: O código de erro.
example: -32602
message:
type: string
description: A mensagem de erro.
data:
type: object
description: Dados adicionais sobre o erro.
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````