> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Analizar el rendimiento de wallets KOL en Solana

> Compara el PnL de wallets KOL, consulta actividad diaria y posiciones, y conecta el análisis con trades en vivo.

Los endpoints KOL cubren wallets seguidas con identidad pública. Elige una clasificación y un periodo, y consulta las posiciones para entender sus resultados.

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/kolscan-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=41ee74323643314e245c054c9283d73d" alt="Leaderboard de KOLScan mostrando PnL, volumen y días activos de wallets de KOLs" width="3054" height="1834" data-path="images/guides/kolscan-leaderboard.png" />

## Listar todos los KOLs

El [leaderboard de KOLs](/es/data-api/pnl-v2/leaderboard/get-kol-leaderboard) devuelve todas las wallets de KOLs monitorizadas ordenadas por rendimiento.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols?sort=realized&direction=desc&limit=25" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://data.solanatracker.io/v2/pnl/leaderboard/kols?sort=realized&direction=desc&limit=25",
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );
  const { traders } = await res.json();

  traders.forEach((kol, i) => {
    console.log(`#${i + 1} ${kol.identity.name} (@${kol.identity.twitter})`);
    console.log(`   PnL: $${kol.pnl.realized.toLocaleString()}, Win Rate: ${kol.winRate}%`);
  });
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://data.solanatracker.io/v2/pnl/leaderboard/kols",
      params={"sort": "realized", "direction": "desc", "limit": 25},
      headers={"x-api-key": "YOUR_API_KEY"}
  )

  for i, kol in enumerate(res.json()["traders"], 1):
      print(f"#{i} {kol['identity']['name']}: ${kol['pnl']['realized']:,.2f}")
  ```
</CodeGroup>

### Opciones de ordenación

| Campo | Descripción |
| - | - |
| `total` | PnL total (realizado + no realizado) |
| `realized` | Beneficio asegurado |
| `unrealized` | Beneficio sobre el papel en posiciones abiertas. Las posiciones abiertas son tokens aún en cartera. |
| `invested` | Total en USD invertido |
| `roi` | Retorno de la inversión |
| `win_percentage` | Tasa de aciertos |
| `trades` | Número de operaciones |
| `tokens` | Número de tokens operados |
| `last_trade` | Última actividad |

## Comparar KOLs en un periodo de tiempo

Usa el [leaderboard por periodo](/es/data-api/pnl-v2/leaderboard/get-kol-leaderboard-for-a-period) para rankear KOLs dentro de una ventana específica. Útil para encontrar quién está rindiendo bien *recientemente*, no solo all-time.

<CodeGroup>
  ```bash Últimos 7 días theme={null}
  curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/period?period=7d&sort=realized&direction=desc" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```bash Rango personalizado theme={null}
  curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/period?start=2025-03-01&end=2025-03-31&sort=realized" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

Atajos de `period` soportados: `1d`, `7d`, `14d`, `30d`, `90d`.

## Calendario de KOLs (heatmap mensual)

El [endpoint de calendario](/es/data-api/pnl-v2/leaderboard/get-kol-calendar) devuelve el rendimiento agregado de KOLs para cada día de un mes. Perfecto para construir UIs de heatmap.

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/calendar?year=2025&month=3" \
  -H "x-api-key: YOUR_API_KEY"
```

Cada día incluye el PnL total, número de operaciones y conteo de KOLs activos en el conjunto monitorizado.

<Tip>
  Colorea los días por el PnL agregado para detectar tendencias del mercado de un vistazo.
</Tip>

## Desglose por día de KOLs

El [desglose diario](/es/data-api/pnl-v2/leaderboard/get-kol-daily-breakdown) muestra la actividad de cada KOL monitorizado para un día concreto.

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/date?date=2025-03-15" \
  -H "x-api-key: YOUR_API_KEY"
```

Úsalo para responder preguntas como "¿qué operaron los KOLs el día del lanzamiento?" o "¿quién tuvo el mejor día durante el pump?"

## Profundiza en la wallet de un KOL

Una vez encuentres un KOL que te interese investigar, pasa su dirección de wallet a los endpoints de análisis de wallet:

```javascript theme={null}
// Get the KOL's full wallet summary
const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"; // from leaderboard

const summary = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());

console.log(`Total PnL: $${summary.summary.pnl.total.toFixed(2)}`);
console.log(`Win Rate: ${summary.analysis.winRate}%`);
console.log(`Tokens Traded: ${summary.summary.counts.tokensTraded}`);

// Then get their current positions
const positions = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}/positions?sort=value&direction=desc&limit=10`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
).then(r => r.json());

positions.data.forEach(p => {
  console.log(`${p.meta.symbol}: $${p.pnl.total.toFixed(2)} PnL, holding $${p.position.valueUsd.toFixed(2)}`);
});
```

## Sigue nuevos trades de KOLs

Carga actividad reciente con `GET /trades/kols` y recibe nuevos trades en la sala `transaction:kol`. Usa el leaderboard para comparar resultados y el stream para alertas. Consulta los ejemplos del [feed de ballenas y KOLs](/guides/whale-kol).

<CardGroup cols={2}>
  <Card title="PnL de la wallet" href="/es/guides/pnl-v2/wallet-analysis">
    Guía completa para inspeccionar el PnL, posiciones y riesgo de cualquier wallet.
  </Card>

  <Card title="Rankings de traders" href="/es/guides/pnl-v2/leaderboards">
    Rankings de KOLs y top traders con todas las opciones de ordenación y filtro.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.