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

# 排行榜

> 按 PnL、胜率、ROI 或交易笔数对 Solana KOL 与顶级交易者进行排名——通过 Solana Tracker PnL V2 API 按周期、日期或代币查询排行榜。

## KOL 排行榜

KOL 是具有公开身份的受追踪钱包。每个条目可以包含姓名、Twitter 账号和头像。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/kolscan-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=41ee74323643314e245c054c9283d73d" alt="带有 KOL 活动日历和钱包表现排名的 KOLScan 排行榜" width="3054" height="1834" data-path="images/guides/kolscan-leaderboard.png" />

### 全时段

[KOL 排行榜](/cn/data-api/pnl-v2/get-kol-leaderboard)按终身表现对 KOL 钱包进行排名。

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

#### 排序选项

| 字段               | 描述               |
| ---------------- | ---------------- |
| `total`          | 总 PnL(已实现 + 未实现) |
| `realized`       | 已实现 PnL          |
| `unrealized`     | 未实现 PnL          |
| `invested`       | 总投资              |
| `proceeds`       | 卖出获得的总收益         |
| `trades`         | 交易笔数             |
| `tokens`         | 交易过的代币数量         |
| `roi`            | 投资回报率            |
| `win_percentage` | 胜率               |
| `last_trade`     | 最近交易             |

***

### 按时间段

[期间排行榜](/cn/data-api/pnl-v2/get-kol-leaderboard-for-a-period)在特定窗口内对 KOL 进行排名。使用 `7d`、`30d` 等简写,或设置显式的 `start`/`end` 日期。

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

<CardGroup cols={2}>
  <Card title="KOL = 具名钱包">
    当身份重要并且您希望比较公众人物时最适合。
  </Card>

  <Card title="顶级交易者 = 原始表现">
    当您只关心结果而不在乎声誉时更合适。
  </Card>
</CardGroup>

***

### 月度日历

[日历端点](/cn/data-api/pnl-v2/get-kol-calendar)返回某月每日的聚合 KOL 表现。非常适合热图可视化。

```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>
  按总 KOL PnL 为每一天着色,可以快速发现全市场趋势。
</Tip>

***

### 单日

[每日细分端点](/cn/data-api/pnl-v2/get-kol-daily-breakdown)显示每个 KOL 在特定一天的交易和 PnL。

```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 交易者排行榜

[Solana 交易者排行榜](/cn/data-api/pnl-v2/get-top-traders)按支持的滚动窗口(`1`、`7`、`30` 或 `90` 天)对 Solana 交易钱包进行排名。与 KOL 排行榜不同,这涵盖**所有钱包**,而不仅是已知钱包。

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

### 过滤器

使用最小阈值过滤掉幸运的一次性事件:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/photon-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=0a717216be77f259ce972667008dd200" alt="过滤为通过 Photon 交易的钱包的 Photon 排行榜" width="2712" height="1890" data-path="images/guides/photon-leaderboard.png" />

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/bloom-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=d6d52d69a709b4bb1b06b4a89645f22e" alt="过滤为通过 Bloom 交易的钱包的 Bloom 排行榜" width="2620" height="2152" data-path="images/guides/bloom-leaderboard.png" />

| 参数                  | 默认         | 描述                                                                          |
| ------------------- | ---------- | --------------------------------------------------------------------------- |
| `days`              | `90`       | 滚动窗口(天)。使用 `1`、`7`、`30` 或 `90` 作为精确支持的窗口。                                   |
| `sort`              | `realized` | `realized`、`volume`、`days`、`roi`、`win_percentage`、`trades`、`tokens`         |
| `minTrades`         | `20`       | 最少交易次数                                                                      |
| `minInvested`       | `1`        | 最低投资美元总额                                                                    |
| `minDays`           | `3`        | 最少活跃交易天数                                                                    |
| `minWinRate`        | —          | 最低胜率百分比                                                                     |
| `minRoi`            | —          | 最低 ROI 百分比                                                                  |
| `minClosedTokens`   | —          | 已平仓最少代币数                                                                    |
| `maxSingleTokenPct` | —          | 单一代币 PnL 占比的最大值(过滤掉一夜之财)                                                    |
| `excludeArbitrage`  | `true`     | 默认排除套利钱包。设为 `false` 以包含它们。                                                  |
| `platform`          | —          | 按平台过滤(`axiom`、`bloom`、`photon`)。逗号分隔多个。`axiom-flash` 作为 `axiom` 别名被接受。      |
| `pnlMode`           | `strict`   | `strict`、`adjusted` 或 `raw`。请参阅[要点](/cn/guides/pnl-v2/overview#essentials)。 |

<Warning>
  **覆盖范围:** 顶级交易者排行榜按每个时段排名**前 50 万个钱包**。一个钱包可以有交易但仍不出现在此排名中。要直接检查任意钱包,请调用 `/v2/pnl/wallets/:wallet`。
</Warning>

<Tip>
  尝试 `maxSingleTokenPct=30` + `minDays=10` + `minTrades=50` 找出持续盈利的交易者,而不仅是一夜之财。
</Tip>

<CardGroup cols={2}>
  <Card title="下一步:批量操作" href="/cn/guides/pnl-v2/batch-operations">
    筛选出钱包后,使用批量端点批量丰富它们。
  </Card>

  <Card title="钱包分析" href="/cn/guides/pnl-v2/wallet-analysis">
    深入了解单个钱包的完整历史和风险概况。
  </Card>
</CardGroup>
