Saltar al contenido principal
GET
USDC recibido

SDK Example

Autorizaciones

x-api-key
string
header
requerido

Clave API para autenticación

Parámetros de ruta

address
string
requerido

Dirección de la wallet o cuenta. Las transferencias SPL se buscan a través de las token accounts de esta wallet.

Parámetros de consulta

limit
integer
predeterminado:100

Transferencias por página. Una página contiene transacciones completas, así que puede tener algunas más o menos. Con grouped=true cuenta transacciones, salvo que se use dex=include sin type, sin los filtros de direcciones, cantidad o slot, y sin excludeZero. Como máximo 100 con minValue o maxValue.

Rango requerido: 1 <= x <= 1000
cursor
string

pagination.next de la página anterior. Mantén los demás parámetros iguales entre páginas. Un cursor= vacío devuelve la primera página.

sortOrder
enum<string>
predeterminado:desc

desc devuelve primero las más recientes; asc, las más antiguas.

Opciones disponibles:
desc,
asc
start
integer

Hora de bloque desde, en segundos Unix, inclusiva. Los milisegundos se rechazan.

Rango requerido: x >= 0
end
integer

Hora de bloque hasta, en segundos Unix, inclusiva. Debe ser mayor o igual que start.

Rango requerido: x >= 0
startSlot
integer

Slot desde, inclusivo.

Rango requerido: x >= 0
endSlot
integer

Slot hasta, inclusivo.

Rango requerido: x >= 0
direction
enum<string>
predeterminado:all

Transferencias recibidas por (in) o enviadas desde (out) la dirección.

Opciones disponibles:
all,
in,
out
type
enum<string>

sol para transferencias de SOL nativo, spl para transferencias SPL y Token-2022 (incluido wrapped SOL). Ambos por defecto.

Opciones disponibles:
sol,
spl
mint
string

Solo transferencias de este token. El mint de wrapped SOL So11111111111111111111111111111111111111112 devuelve las transferencias de SOL nativo y de wrapped SOL.

status
enum<string>
predeterminado:success

Resultado de la transacción: success (por defecto), failed o any. Cada transferencia indica su propio status.

Opciones disponibles:
success,
failed,
any
dex
enum<string>
predeterminado:exclude

exclude (por defecto) descarta todas las transferencias de una transacción con actividad DEX, only devuelve solo esas e include lo devuelve todo. Una transacción tiene actividad DEX cuando una de sus transferencias va hacia o viene de un pool (una cuenta propiedad de un programa DEX o launchpad, o una vault authority de Raydium o Meteora): swaps, depósitos y retiros de liquidez, y cobros de comisiones o recompensas. También cuenta una transacción en la que la dirección envió un token y recibió otro.

Opciones disponibles:
exclude,
include,
only
from
string

Hasta 5 direcciones de remitente separadas por comas (wallet o token account).

to
string

Hasta 5 direcciones de destinatario separadas por comas (wallet o token account).

counterparty
string

Hasta 5 direcciones separadas por comas en cualquiera de los dos lados (wallet o token account).

excludeFrom
string

Descarta las transferencias desde estas direcciones (hasta 5, separadas por comas).

excludeTo
string

Descarta las transferencias hacia estas direcciones (hasta 5, separadas por comas).

minAmount
number

Cantidad mínima en unidades del token (uiAmount), inclusiva.

Rango requerido: x >= 0
maxAmount
number

Cantidad máxima en unidades del token (uiAmount), inclusiva.

Rango requerido: x >= 0
minValue
number

Valor mínimo en USD en el momento de la transferencia, inclusivo. Activa historicPrices, y limit puede ser como máximo 100. Cada página revisa las siguientes limit transferencias y devuelve las que coinciden, así que puede tener menos, o ninguna, aunque hasMore sea true.

Rango requerido: x >= 0
maxValue
number

Valor máximo en USD en el momento de la transferencia, inclusivo. Activa historicPrices, y limit puede ser como máximo 100.

Rango requerido: x >= 0
historicPrices
boolean
predeterminado:false

Añade price.usd y value.usd a cada transferencia: el precio en USD del token según la última vela de 1 minuto en el momento de la transferencia o antes, con una antigüedad máxima de una hora; si no, null. USDC, USDT y USD1 se valoran a 1. Sin esta opción, las transferencias no tienen price ni value.

grouped
boolean
predeterminado:false

Devuelve también transactions: las transferencias de la página agrupadas por transacción, con totales, dex y detección de swaps.

excludeZero
boolean
predeterminado:false

Descarta las transferencias de cantidad cero.

Respuesta

Transferencias de la dirección

account
string
requerido
transfers
object[]
requerido

Transferencias de esta página. Con grouped=true, todas las transferencias de las transacciones devueltas.

pagination
object
requerido
grouped
boolean

Presente y true cuando grouped=true

transactions
object[]

Solo con grouped=true

enrichmentStatus
enum<string>

Presente cuando la consulta de precios se quedó sin tiempo: los precios que no encontró son null. Una página así no se guarda en caché.

Opciones disponibles:
partial