Saltar al contenido principal
GET
Liquidity events
Consulta actividad dentro del alcance de token, pool y wallet de este endpoint. Usa events=all para combinar swaps con depósitos y retiros de liquidez, o events=liquidity para obtener solo liquidez. Omite events para conservar la respuesta de swaps. Añade enrich=identity para identificar wallets en ambos tipos de evento. Los eventos de liquidez usan add_liquidity o remove_liquidity, un único pool y cantidades exactas como cadenas en tokens[]; no incluyen precios de swap, volumen ni PnL. Consulta la guía de liquidez para ejemplos REST, paginación y salas en vivo.

SDK Example

Autorizaciones

x-api-key
string
header
requerido

Clave API para autenticación

Parámetros de ruta

tokenAddress
string
requerido
poolAddress
string
requerido

Parámetros de consulta

events
enum<string>
predeterminado:trades

Elige trades (predeterminado), all (swaps y liquidez) o liquidity (solo depósitos y retiros). Todos los modos devuelven un array trades. Los valores no válidos devuelven HTTP 400.

Opciones disponibles:
trades,
all,
liquidity
enrich
string

Usa identity para añadir la identidad actual de la wallet a cada swap o evento de liquidez: perfiles KOL, etiquetas, plataformas, roles de desarrollador/pool y nombres SNS disponibles. Las wallets desconocidas devuelven identity: null. Si se omite, no se consulta la identidad. all y * también la activan; pool y developer son alias de compatibilidad.

cursor
string

Devuelve nextCursor sin modificar. El modo predeterminado usa una marca de tiempo; events=all y events=liquidity usan una cadena opaca asociada al token, pool, wallet, events y sortDirection. Mantén esos filtros entre páginas.

limit
integer
predeterminado:250

Número de resultados: 250 por defecto, máximo 500. Con events=all o events=liquidity, el rango es 1–500.

Rango requerido: 1 <= x <= 500
sortDirection
enum<string>
predeterminado:DESC

Orden cronológico: DESC (más recientes primero) o ASC (más antiguos primero). Los valores no válidos devuelven HTTP 400.

Opciones disponibles:
ASC,
DESC
showMeta
boolean

Usa true para añadir metadatos de los tokens de origen y destino a los swaps. Los eventos de liquidez conservan su array tokens sin metadatos de swap.

hideArb
boolean

Usa true para conservar los swaps que incluyan el token solicitado. Las acciones de liquidez se mantienen.

currency
enum<string>

Añade price (por token) a cada swap, en esta moneda en el momento del trade. sol: los trades contra SOL usan las cantidades de SOL y de token del propio swap; los demás trades dividen el precio en USD entre el tipo SOL/USD de ese segundo. eur: el precio en USD dividido entre el tipo EUR/USD en el momento del trade. price es null cuando el trade no tiene precio en USD o no hay tipo de cambio disponible. Las filas de liquidez no cambian. Los valores no válidos devuelven HTTP 400.

Opciones disponibles:
usd,
eur,
sol
marketCap
boolean
predeterminado:false

Usa true para añadir marketCap a cada swap: price (en currency, USD por defecto) multiplicado por el supply del pool principal del token. Usa el supply actual, así que un token que haya quemado o acuñado desde el trade se valora con el supply de hoy.

Respuesta

Successful response

trades
object[]
nextCursor

Timestamp for trades-only requests; opaque string for events=all/liquidity. Pass back unchanged with the same filters. Null at the end.

hasNextPage
boolean
sortDirection
enum<string>
Opciones disponibles:
ASC,
DESC
currency
enum<string>

Moneda de price y marketCap. Aparece cuando se indica currency o marketCap.

Opciones disponibles:
usd,
eur,
sol