Skip to main content
POST
getTransfersByAddress

Visão Geral

getTransfersByAddress retorna objetos de transferência analisados e legíveis por humanos para movimento de token e SOL nativo envolvendo um endereço de carteira. Use filtros para restringir os resultados por mint, tempo de bloco, quantidade, slot, direção ou contraparte. A resposta é projetada para visualizações precisas de atividades de carteira, acompanhamento de pagamentos e reconciliação de saldos sem reimplementar a análise de transferência Solana.
Transferências de mint e burn são unilaterais. Mints têm fromUserAccount: null e só podem ser retornados como transferências de entrada para o destinatário. Burns têm toUserAccount: null e só podem ser retornados como transferências de saída para o proprietário que queima.

Parâmetros de Requisição

string
obrigatório
Endereço de carteira do proprietário codificado em Base58 para consultar transferências. Passe o endereço do proprietário da carteira, não uma conta de token associada (ATA).
string
Filtre por endereço de contraparte. Retorna apenas transferências para ou deste endereço.
string
padrão:"any"
Filtre pela direção da transferência em relação ao endereço consultado.
  • in
  • out
  • any
string
Endereço de mint do token. Use So11111111111111111111111111111111111111111 para SOL nativo e So11111111111111111111111111111111111111112 para WSOL.
string
padrão:"merged"
Modo de exibição SOL/WSOL. merged trata WSOL como SOL nativo e exclui linhas de wrap/unwrap para que o histórico denominado em SOL seja mais fácil de reconciliar; separate preserva WSOL como um mint de token SPL distinto e inclui linhas de wrap/unwrap.
  • merged
  • separate
object
Filtros adicionais para quantidade, tempo de bloco e slot.
object
Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
number
Maior que.
number
Maior ou igual a.
number
Menor que.
number
Menor ou igual a.
object
Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
number
Maior que.
number
Maior ou igual a.
number
Menor que.
number
Menor ou igual a.
object
Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
number
Maior que.
number
Maior ou igual a.
number
Menor que.
number
Menor ou igual a.
number
padrão:"100"
Número máximo de transferências a serem retornadas. Intervalo de 1 a 100.
string
Cursor da resposta anterior para paginação.
any
string
padrão:"finalized"
Nível de compromisso de dados.
  • finalized
  • confirmed
number
Slot de contexto mínimo para usar na requisição (opcional).
string
padrão:"desc"
Ordenação dos resultados.
  • asc
  • desc

Autorizações

api-key
string
query
obrigatório

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

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 único para a solicitação.

Exemplo:

"1"

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

O nome do método RPC a ser invocado.

Opções disponíveis:
getTransfersByAddress
Exemplo:

"getTransfersByAddress"

params
tuple
obrigatório

Array contendo o endereço da carteira necessário e o objeto de configuração opcional.

Exemplo:

Resposta

Transferências recuperadas com sucesso para o endereço especificado.

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

Dados de transferência e informações de paginação.