Skip to main content
PnL V2 calcula rendimientos a partir de trades indexados en Solana. Para comparar wallets, mantén el mismo modo de cálculo, moneda y periodo.
URL base: https://data.solanatracker.io
Auth: Pasa tu clave de API en la cabecera x-api-key.
Valores: Todos los importes monetarios son USD. Los timestamps son milisegundos Unix salvo que se indique lo contrario.

​
Esenciales

​
Qué incluye PnL V2

  • Cobertura de tokens. Cada token SPL es soportado excepto las stablecoins y SOL.
  • Endpoints de wallet. Usa los endpoints de wallet para cualquier wallet, incluso si no está en un leaderboard.
  • Etiquetas de identidad. Las wallets pueden incluir un objeto identity con etiquetas como KOL, bot, exchange, pool, developer o plataforma de trading.

​
Qué excluye PnL V2

Las stablecoins y SOL se excluyen intencionalmente de las posiciones de PnL porque son activos de cotización. Un activo de cotización es el token usado para fijar el precio de una operación, no la posición que se mide. Las wallets de arbitraje se excluyen por defecto con excludeArbitrage=true. El PnL de arbitraje puede ser ruidoso porque esas wallets a menudo operan por diferencias minúsculas entre pools. Pasa excludeArbitrage=false para incluirlas. El leaderboard de top traders cubre las top 500k wallets por periodo. Si una wallet está fuera de ese conjunto rankeado, consúltala directamente con los endpoints de wallet.

​
Etiquetas de identidad

Cada wallet puede llevar un identity estructurado. Hoy se soportan:
  • Bots y MEV — potential_bot (heurística), bot (bots con nombre, curados, como Mayhem Bot) y arbitrage (MEV confirmado).
  • Plataformas — axiom, bloom y photon. La API también acepta axiom-flash como alias de axiom.
  • Etiquetas de seguridad / infraestructura — hacker, spam_dusting y exchange curadas cuando se conocen.
  • Los roles pool y developer se resuelven automáticamente en endpoints con scope de token.

​
Modos de PnL

Los endpoints de resumen de wallet, posiciones, posición individual, leaderboard de top traders y batch de posiciones aceptan ?pnlMode=. Los endpoints que aceptan pnlMode lo devuelven en la respuesta. pnl.realized usa el modo solicitado y pnl.realizedRaw conserva el valor original. Cambiar de modo requiere otra petición para recuperar posiciones filtradas. Los endpoints de leaderboards de KOLs, history, chart, performance, highlights, risk, token-traders, first-buyers y wallet-summary batch no aceptan pnlMode; devuelven la vista fija del servidor para ese conjunto de datos.

​
Grupos de endpoints

​
Endpoints de wallet

​
Endpoints de token

​
Endpoints de leaderboard

​
Endpoints batch

​
Conceptos clave

​
PnL realizado vs no realizado

Ganancia o pérdida de tokens que has vendido. Está asegurado — no cambia.
Ganancia o pérdida sobre el papel de tokens que aún mantienes. Cambia con cada tick de precio.
realizado + no realizado. La imagen completa.

​
Cobertura de wallets

PnL V2 cubre todas las wallets de Solana desde diciembre de 2023 en adelante. Las wallets no se indexan bajo demanda.

​
Paginación

Los endpoints de lista usan paginación por cursor. Toma pagination.nextCursor de la respuesta y pásalo como parámetro de consulta cursor para obtener la siguiente página.

​
Identidad del wallet

Cada respuesta con scope de wallet incluye un objeto identity estructurado. Combina varias fuentes para que una wallet pueda llevar varias etiquetas a la vez (por ejemplo ["kol", "developer", "axiom"]). Solo se devuelven los campos poblados: En endpoints con scope de token (/tokens/:token/traders, /first-buyers, /tokens/:token/positions/batch) los roles pool y developer se resuelven para el token exacto en el path, así que puedes identificar devs, LPs y snipers en línea sin solicitudes adicionales. Consulta la guía de Etiquetas de Wallets de Solana para la lista completa de etiquetas soportadas.

​
Enriquecimiento en /tokens/:tokenAddress/holders

El endpoint clásico de holders acepta un parámetro opcional ?enrich=:
  • ?enrich=identity — añade identidad pool / developer / plataforma por holder.
  • ?enrich=walletPnl — añade PnL lifetime de la wallet más PnL por token por holder.
  • ?enrich=all — ambos.
Si se omite, el endpoint se comporta exactamente como antes sin trabajo extra.

​
En tiempo real vía Datastream

Combina estos endpoints REST con las salas de PnL V2 Datastream para actualizaciones en vivo. Disponible en los planes Premium, Business y Enterprise: Patrón típico: llama a GET /v2/pnl/wallets/:wallet una vez para sembrar el estado y luego suscríbete a pnl:{wallet}:summary para mantenerlo sincronizado. Para los ticks de PnL no realizado más rápidos, combina una sala de PnL con un stream de precios — price:aggregated:{token} (multi-pool, recomendado) o price-by-token:{token} (pool principal). Las salas de PnL emiten tradeUpdate y balanceUpdate en cada fill más un priceUpdate ocasional con throttle; las salas de precio emiten en cada movimiento del mercado. Walkthrough en la guía PnL V2 Datastream.