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

# Build Solana Trader and KOL Leaderboards

> Rank Solana traders and KOLs by PnL, ROI, or activity. Apply time windows, platform filters, and minimum trade thresholds.

Choose the KOL leaderboard for the tracked public-wallet roster or the top-trader leaderboard for broader Solana rankings. Keep the period and filters consistent when comparing results.

## KOL leaderboards

KOLs are tracked wallets with a public identity. Each entry can include a name, Twitter handle, and avatar.

![KOLScan leaderboard with KOL activity calendar and ranked wallet performance](https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/kolscan-leaderboard.png?fit=max\&auto=format\&n=ZM5vWoSAJUJFeh6A\&q=85\&s=41ee74323643314e245c054c9283d73d)

### All-time

The [KOL leaderboard](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-leaderboard.md) ranks KOL wallets by lifetime performance.

```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(`   Realized: $${kol.pnl.realized.toLocaleString()}`);
  console.log(`   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):
    name = kol["identity"]["name"]
    pnl = kol["pnl"]["realized"]
    print(f"#{i} {name}: ${pnl:,.2f}")
```

#### Sort options

| Field | Description |
| - | - |
| `total` | Total PnL (realized + unrealized) |
| `realized` | Realized PnL |
| `unrealized` | Unrealized PnL |
| `invested` | Total invested |
| `proceeds` | Total proceeds from sells |
| `trades` | Number of trades |
| `tokens` | Number of tokens traded |
| `roi` | Return on investment |
| `win_percentage` | Win rate |
| `last_trade` | Most recent trade |

### By time period

The [period leaderboard](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-leaderboard-for-a-period.md) ranks KOLs within a specific window. Use shortcuts like `7d`, `30d`, or set explicit `start`/`end` dates.

```bash theme={null}
# Last 7 days
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/period?period=7d&sort=realized" \
  -H "x-api-key: YOUR_API_KEY"

# Custom range
curl "https://data.solanatracker.io/v2/pnl/leaderboard/kols/period?start=2025-03-01&end=2025-03-31" \
  -H "x-api-key: YOUR_API_KEY"
```

> [card] KOLs = named wallets
>
> Best when identity matters and you want to compare public figures.

> [card] Top traders = raw performance
>
> Better when you care about results regardless of reputation.

### Monthly calendar

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

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

> [!TIP]
>
> Color each day by total KOL PnL to quickly spot market-wide trends.

### Single day

The [daily breakdown endpoint](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/get-kol-daily-breakdown.md) shows each KOL's trades and PnL 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"
```

## Solana traders leaderboard

The [top-trader leaderboard](https://docs.solanatracker.io/data-api/pnl-v2/leaderboard/solana-traders-leaderboard.md) ranks wallets over a `1`, `7`, `30`, or `90` day window. It is not limited to the KOL roster; coverage is capped at the top 500,000 wallets per period.

```bash cURL theme={null}
curl "https://data.solanatracker.io/v2/pnl/leaderboard/top?days=30&sort=realized&direction=desc&limit=50" \
  -H "x-api-key: YOUR_API_KEY"
```

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

traders.forEach((t, i) => {
  console.log(`#${i + 1} ${t.wallet}`);
  console.log(`   Realized: $${t.period.realized.toLocaleString()}, ROI: ${t.period.roi}%`);
});
```

### Filters

Filter by trade count, active days, platform, or concentration to define the ranked set:

![Photon leaderboard filtered to wallets trading through Photon](https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/photon-leaderboard.png?fit=max\&auto=format\&n=ZM5vWoSAJUJFeh6A\&q=85\&s=0a717216be77f259ce972667008dd200)

![Bloom leaderboard filtered to wallets trading through Bloom](https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/bloom-leaderboard.png?fit=max\&auto=format\&n=ZM5vWoSAJUJFeh6A\&q=85\&s=d6d52d69a709b4bb1b06b4a89645f22e)

| Parameter | Default | Description |
| - | - | - |
| `days` | `90` | Rolling window in days. Use `1`, `7`, `30`, or `90` for exact supported windows. |
| `sort` | `realized` | `realized`, `volume`, `days`, `roi`, `win_percentage`, `trades`, `tokens` |
| `minTrades` | `20` | Minimum number of trades |
| `minInvested` | `1` | Minimum total USD invested |
| `minDays` | `3` | Minimum active trading days |
| `minWinRate` | — | Minimum win percentage |
| `minRoi` | — | Minimum ROI percentage |
| `minClosedTokens` | — | Minimum number of closed positions |
| `maxSingleTokenPct` | — | Maximum % of PnL from a single token (filters one-hit wonders) |
| `excludeArbitrage` | `true` | Arbitrage wallets are excluded by default. Set to `false` to include them. |
| `platform` | — | Filter by platform (`axiom`, `bloom`, `photon`). Comma-separated for multiple. `axiom-flash` is accepted as an `axiom` alias. |
| `pnlMode` | `strict` | `strict`, `adjusted`, or `raw`. See [Essentials](https://docs.solanatracker.io/guides/pnl-v2/overview.md#essentials). |

> [!WARNING]
>
> **Coverage:** the top-traders leaderboard ranks the **top 500k wallets** per period. A wallet can trade and still not appear in this ranked list. To inspect any wallet directly, call `/v2/pnl/wallets/:wallet`.

> [!TIP]
>
> For example, combine `maxSingleTokenPct=30`, `minDays=10`, and `minTrades=50` to limit single-token concentration and require a minimum activity history. These filters do not predict future returns.

> [card] [Batch requests](https://docs.solanatracker.io/guides/pnl-v2/batch-operations.md)
>
> After you shortlist wallets, use batch endpoints to enrich them in bulk.

> [card] [Wallet PnL](https://docs.solanatracker.io/guides/pnl-v2/wallet-analysis.md)
>
> Drill into a single wallet's full history and risk profile.


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