Skip to main content
POST
getTransfersByAddress

Descripción general

getTransfersByAddress devuelve objetos de transferencia analizados y legibles correspondientes al movimiento de tokens y SOL nativo que involucra a una dirección de billetera. Usa filtros para limitar los resultados por acuñación, tiempo de bloque, cantidad, slot, dirección de la transferencia o contraparte. La respuesta está diseñada para mostrar con precisión la actividad de la billetera, hacer seguimiento de pagos y conciliar saldos sin volver a implementar el análisis de transferencias de Solana.
Las transferencias de acuñación y quema son unilaterales. Las acuñaciones tienen fromUserAccount: null y solo pueden devolverse como transferencias entrantes para el destinatario. Las quemas tienen toUserAccount: null y solo pueden devolverse como transferencias salientes para el propietario que realiza la quema.

Parámetros de la solicitud

string
requerido
Dirección de la billetera del propietario codificada en Base58 cuyas transferencias quieres consultar. Proporciona la dirección del propietario de la billetera, no una cuenta de token asociada (ATA).
string
Filtra por dirección de la contraparte. Devuelve solo las transferencias hacia o desde esta dirección.
string
predeterminado:"any"
Filtra por la dirección de la transferencia en relación con la dirección consultada.
  • in
  • out
  • any
string
Dirección de acuñación del token. Usa So11111111111111111111111111111111111111111 para SOL nativo y So11111111111111111111111111111111111111112 para WSOL.
string
predeterminado:"merged"
Modo de visualización de SOL/WSOL. merged trata WSOL como SOL nativo y excluye las filas de envoltura y desenvoltura para facilitar la conciliación del historial denominado en SOL; separate conserva WSOL como una acuñación de token SPL independiente e incluye las filas de envoltura y desenvoltura.
  • merged
  • separate
object
Filtros adicionales de cantidad, tiempo de bloque y slot.
object
Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
number
Mayor que.
number
Mayor o igual que.
number
Menor que.
number
Menor o igual que.
object
Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
number
Mayor que.
number
Mayor o igual que.
number
Menor que.
number
Menor o igual que.
object
Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
number
Mayor que.
number
Mayor o igual que.
number
Menor que.
number
Menor o igual que.
number
predeterminado:"100"
Número máximo de transferencias que se devolverán. Rango de 1 a 100.
string
Cursor de la respuesta anterior para la paginación.
string
predeterminado:"finalized"
Nivel de compromiso de los datos.
  • finalized
  • confirmed
number
Slot de contexto mínimo que se usará para la solicitud (opcional).
string
predeterminado:"desc"
Orden de los resultados.
  • asc
  • desc

Autorizaciones

api-key
string
query
requerido

Tu clave de API de Helius. Puedes obtener una gratis en el panel.

Cuerpo

application/json
jsonrpc
enum<string>
predeterminado:2.0
requerido

La versión del protocolo JSON-RPC.

Opciones disponibles:
2.0
Ejemplo:

"2.0"

id
string
predeterminado:1
requerido

Un identificador único para la solicitud.

Ejemplo:

"1"

method
enum<string>
predeterminado:getTransfersByAddress
requerido

El nombre del método RPC que se invocará.

Opciones disponibles:
getTransfersByAddress
Ejemplo:

"getTransfersByAddress"

params
(string | object)[]
requerido

Arreglo que contiene la dirección de billetera obligatoria y el objeto de configuración opcional.

Required array length: 1 - 2 elements

Dirección de la billetera del propietario codificada en Base58 cuyas transferencias quieres consultar. Proporciona la dirección de la billetera del propietario, no una cuenta de tokens asociada (ATA).

Ejemplo:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Respuesta

Se recuperaron correctamente las transferencias de la dirección especificada.

jsonrpc
enum<string>

La versión del protocolo JSON-RPC.

Opciones disponibles:
2.0
Ejemplo:

"2.0"

id
string

Identificador que coincide con la solicitud.

Ejemplo:

"1"

result
object

Datos de las transferencias e información de paginación.