Resumen de wallet
Empieza aquí. El resumen de wallet te da la vista de alto nivel: PnL total, win rate, número de tokens operados y distribución del ROI.Posiciones de tokens
El endpoint de posiciones lista cada token que ha operado un wallet. Ordena por PnL, ROI o valor. Filtra por estado de holding, mercado, mínimo invertido, etc.Modo PnL
Los endpoints de resumen, posiciones y posición individual soportan?pnlMode=strict|adjusted|raw. El valor por defecto es strict, que filtra las posiciones donde la cantidad vendida supera a la comprada (normalmente inválidas). Cambia a adjusted para una vista con cost basis corregido, o raw para verlo todo sin filtrar. Detalles en los Esenciales.
Filtros comunes
Mostrar solo posiciones rentables
Mostrar solo posiciones rentables
Mostrar tokens en cartera actualmente
Mostrar tokens en cartera actualmente
Filtrar por inversión mínima
Filtrar por inversión mínima
Filtrar por mercado específico (p. ej. pump.fun)
Filtrar por mercado específico (p. ej. pump.fun)
Posición individual
Para profundizar en un token, usa el endpoint de posición de token del wallet:Calendario de PnL
El endpoint de calendario de PnL muestra cómo cambió el PnL del wallet día a día.
- Totales acumulados — PnL, invertido y proceeds a la fecha
- Actividad diaria — PnL realizado, volumen y conteos de operaciones de ese día
Datos del gráfico
El endpoint de chart devuelve hasta 180 puntos de datos diarios para trazar equity, PnL realizado y actividad.
time_from y time_to (segundos Unix) para paginar datos antiguos.
Rendimiento
El endpoint de performance te da estadísticas en ventana móvil:
Highlights
El endpoint de highlights devuelve las posiciones más destacadas de un wallet:
Mayor ganador
La posición con mayor PnL realizado
Mayor perdedor
La posición con la peor pérdida realizada
Flip más rápido
Menor tiempo de tenencia con beneficio
Tenencia más larga
La posición mantenida durante más tiempo
Bag más grande
Holding actual con mayor valor en USD
Más operado
El token con más transacciones de compra/venta
Riesgo
El endpoint de riesgo evalúa la exposición actual del portfolio:
- Concentración del portfolio — cuánto hay en la top 1 y top 5 posiciones
- Mezcla realizado vs no realizado — ¿el wallet tiene ganancias en papel o beneficios asegurados?
- Valor de posiciones abiertas — valor total en USD de las tenencias actuales
- Holdings de riesgo — lista de tokens con liquidez baja o riesgo de concentración alto
Actualizaciones en vivo
Mantén un wallet sincronizado con las salas Datastream PnL V2 en lugar de hacer polling:pnl:{wallet}:summary— resumen total del PnL del wallet con PnL realizado/no realizado, ROI, conteos, medias y totales de posiciones abiertas.pnl:{wallet}— cada token que el wallet toca,tradeUpdate/balanceUpdate.pnl:{wallet}:{token}— una posición individual.
GET /v2/pnl/wallets/:wallet, luego suscríbete a la sala summary. Consulta la guía Datastream PnL para los payloads completos.
Traders del token
Mira cómo se operó un token específico entre wallets.
Referencia de la API
Detalles completos del esquema para la respuesta de resumen de wallet.