Skip to main content
Consulta el resumen para los resultados totales y las posiciones para ver qué tokens los explican. Usa el historial para cambios diarios y los datos de riesgo para la exposición actual.

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

Posición individual

Para profundizar en un token, usa el endpoint de posición de token del wallet:
Devuelve la posición completa: PnL realizado/no realizado, cost basis, valor actual, conteos de compras/ventas, timing de operaciones y metadatos del token.

Calendario de PnL

El endpoint de calendario de PnL muestra cómo cambió el PnL del wallet día a día. Calendario de PnL mostrando celdas verdes y rojas de ganancia y pérdida diarias
Cada día incluye:
  • Totales acumulados — PnL, invertido y proceeds a la fecha
  • Actividad diaria — PnL realizado, volumen y conteos de operaciones de ese día
Usa history cuando necesites explicar qué cambió cada día. Usa chart cuando necesites una curva de equity visual.

Datos del gráfico

El endpoint de chart devuelve hasta 180 puntos de datos diarios para trazar equity, PnL realizado y actividad. Gráfico de PnL mostrando beneficio realizado a lo largo del tiempo, volumen, win rate y drawdown
Usa time_from y time_to (segundos Unix) para paginar datos antiguos.

Rendimiento

El endpoint de performance te da estadísticas en ventana móvil: Panel de rendimiento del wallet mostrando mejor día, peor día, rachas y drawdown

Highlights

El endpoint de highlights devuelve las posiciones más destacadas de un wallet: Panel de highlights de PnL mostrando mayor ganador, perdedor, bag y flip más rápido

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: Panel de exposición del wallet mostrando posiciones abiertas, cost basis, valor actual y mezcla de PnL
  • 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
Risk solo cubre holdings actuales. Las posiciones vendidas no se incluyen.

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.
Siembra tu UI con 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.