> ## 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.

# Solana KOL Tracker API: Wallets, PnL, Leaderboard

> Track Solana KOL wallets with the leaderboard, daily PnL calendar, and per-wallet positions. Connect the results to live KOL trade feeds.

The KOL endpoints cover tracked wallets with public identity labels. Start with the leaderboard, choose a time window, and open a wallet's positions to understand its results.

![KOLScan leaderboard showing KOL wallet PnL, volume, and active days](https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/kolscan-leaderboard.png?fit=max\&auto=format\&n=ZM5vWoSAJUJFeh6A\&q=85\&s=41ee74323643314e245c054c9283d73d)

## List all KOLs

The [KOL leaderboard](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-leaderboard.md) returns the tracked KOL roster with performance metrics and available identity labels.

```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}")
```

### Sort options

| Field | Description |
| - | - |
| `total` | Total PnL (realized + unrealized) |
| `realized` | Locked-in profit |
| `unrealized` | Paper profit on open positions. Open positions are tokens still held. |
| `invested` | Total USD put in |
| `roi` | Return on investment |
| `win_percentage` | Win rate |
| `trades` | Number of trades |
| `tokens` | Number of tokens traded |
| `last_trade` | Most recent activity |

## Compare KOLs over a time period

Use the [period leaderboard](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-leaderboard-for-a-period.md) to compare wallets over the same window. Lifetime totals and recent returns answer different questions.

```bash Last 7 days 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 Custom range 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"
```

Supported `period` shortcuts: `1d`, `7d`, `14d`, `30d`, `90d`.

## KOL calendar (monthly heatmap)

The [calendar endpoint](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-calendar.md) returns daily aggregate performance for the tracked KOL set.

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

Each day includes total PnL, trade count, and active KOL count across the tracked set.

> [!TIP]
>
> Color days by aggregate PnL to spot market-wide trends at a glance.

## Single-day KOL breakdown

The [daily breakdown](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-daily-breakdown.md) shows every tracked KOL's activity for one specific day.

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

Use the daily breakdown to inspect which wallets traded and how their PnL changed on that date.

## Drill into a KOL's wallet

Pass a leaderboard wallet address to the summary and position endpoints for the underlying holdings and returns:

```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)}`);
});
```

## Follow new KOL trades

Use the [whale and KOL trade feed](https://docs.solanatracker.io/guides/whale-kol.md) for new swaps. `GET /trades/kols` loads recent activity; the `transaction:kol` Datastream room keeps it current. Use the leaderboard for performance comparisons and the trade feed for alerts.

> [card] [Wallet PnL](https://docs.solanatracker.io/guides/pnl-v2/wallet-analysis.md)
>
> Full guide for inspecting any wallet's PnL, positions, and risk.

> [card] [Trader rankings](https://docs.solanatracker.io/guides/pnl-v2/leaderboards.md)
>
> KOL and top trader rankings with all sort and filter options.


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