Consultar el historial de liquidez
Los cuatro endpoints de operaciones por token aceptanevents y enrich:
events=tradeses el valor predeterminado: solo compras y ventas.events=alldevuelve swaps, depósitos y retiros de liquidez en orden cronológico.events=liquiditydevuelve soloadd_liquidityyremove_liquidity.enrich=identityañade la identidad actual de cada wallet, con los perfiles KOL, etiquetas, plataformas, roles de desarrollador/pool y nombres SNS disponibles. Las wallets desconocidas devuelvenidentity: null.
trades. Estas opciones se aplican a los cuatro endpoints anteriores; los endpoints globales de wallet, ballenas/KOL y perpetuos conservan su comportamiento.
Usar el SDK de TypeScript
Instala@solana-tracker/data-api 0.5.0 o posterior. Los métodos de historial admiten events, enrich, limit y sortDirection; devuelve nextCursor sin modificar para cargar la siguiente página.
Paginación y filtros
Usalimit entre 1 y 500 (por defecto 250), y sortDirection=DESC para empezar por los eventos más recientes o ASC por los más antiguos.
Con events=all y events=liquidity, nextCursor es una cadena opaca. Envíala sin modificar como cursor en la siguiente solicitud y conserva el token, pool, wallet, events y dirección de ordenación. Continúa mientras hasNextPage sea verdadero; al terminar, nextCursor será null.
No sustituyas el cursor por la hora del último evento: puede haber varias acciones en el mismo milisegundo. Las solicitudes predeterminadas de swaps mantienen el cursor de tiempo; los modos nuevos también aceptan una marca de tiempo numérica como límite inicial exclusivo.
showMeta=true añade metadatos de tokens solo a los swaps. Los eventos de liquidez no incluyen precios de ejecución, volumen en USD ni PnL. hideArb no elimina las acciones de liquidez.
Recibir liquidez en vivo
Conecta awss://datastream.solanatracker.io/{apiKey} con tu clave de Data API. Datastream está disponible en los planes Premium, Business y Enterprise.
Elige una sala
liquidity:{mint}— todas las acciones que incluyan un token.liquidity:{mint}:{pool}— actividad de un token en un pool.liquidity:{mint}:{pool}:{wallet}— actividad de una wallet para ese token y pool.liquidity:pool:{pool}— todas las acciones de liquidez de un pool.liquidity:wallet:{wallet}— actividad de un proveedor entre pools y tokens.
Suscribirse con el SDK
El SDK gestiona los latidos y las reconexiones. Usa{ enriched: true } para incluir etiquetas de wallets, u omítelo para la sala base. Cada callback de liquidez recibe un evento.
transaction:* siguen recibiendo swaps; suscríbete por separado a las salas de liquidez.
Identidad de las wallets en vivo
Añade:enriched a cualquier sala de liquidez, por ejemplo liquidity:{mint}:enriched. El sufijo también funciona en las salas de transacciones, wallets y ballenas/KOL.
Cada registro recibe identity. Una búsqueda completada sin identidad conocida devuelve null. Si la búsqueda está incompleta, también aparece identityStatus: "partial". No se envía una corrección posterior para esa notificación.
Las notificaciones enriquecidas pueden llegar más tarde o en otro orden. Las etiquetas son actuales y pueden estar en caché; no representan la identidad histórica. Las salas por token usan el token solicitado como contexto; las de pool y wallet usan el primer token que no sea de cotización, o el primero si ambos lo son.
Leer un evento de liquidez
Este es un ejemplo ilustrativo. WebSocket envuelve los eventos en{ "type": "message", "room": "...", "data": [...] }; REST los devuelve en trades.
typeesadd_liquidityoremove_liquidity. Un rebalanceo puede emitir un retiro y un depósito por separado.pooles una dirección de pool;walletes el propietario o autoridad de la instrucción y puede ser un delegado o una dirección derivada de programa.tokens[]contiene los mints participantes. Una operación unilateral puede tener una sola entrada; se omiten las cantidades cero.amountes una cadena decimal exacta yamountRawuna cadena entera. Conserva las cadenas o usa aritmética decimal yBigIntpara evitar pérdida de precisión.timeestá en milisegundos Unix;slotidentifica el slot de Solana.amountBasis: "transfer"indica transferencias brutas a través de la bóveda, antes de la retención Token-2022. No garantiza la cantidad neta recibida.amountBasis: "principal"separa el principal de las comisiones o reasignaciones internas. Los retiros de Raydium CLMM también pueden incluirfeeAmountRawytransferredAmountRawpor token.