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

# KOL 追踪

> 追踪 Solana 上 KOL 钱包表现、按 PnL 与胜率对意见领袖进行排名，并使用 Solana Tracker Data API 构建跟单与提醒推送。

KOL(Key Opinion Leaders,关键意见领袖)是被追踪的 Solana 钱包,拥有公开身份——通常包括 Twitter 账号、姓名和头像。使用 KOL 端点对他们进行排名、比较各时段表现,并将他们的交易接入告警或面板。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/kolscan-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=41ee74323643314e245c054c9283d73d" alt="显示 KOL 钱包 PnL、成交量和活跃天数的 KOLScan 排行榜" width="3054" height="1834" data-path="images/guides/kolscan-leaderboard.png" />

## 列出所有 KOL

[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(`   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>

### 排序选项

| 字段               | 描述                 |
| ---------------- | ------------------ |
| `total`          | 总 PnL(已实现 + 未实现)   |
| `realized`       | 已锁定的利润             |
| `unrealized`     | 持仓的账面利润。持仓是仍持有的代币。 |
| `invested`       | 投入的总美元金额           |
| `roi`            | 投资回报率              |
| `win_percentage` | 胜率                 |
| `trades`         | 交易笔数               |
| `tokens`         | 交易过的代币数量           |
| `last_trade`     | 最近活动时间             |

***

## 在某个时间段内比较 KOL

使用[期间排行榜](/cn/data-api/pnl-v2/get-kol-leaderboard-for-a-period)在特定窗口内对 KOL 排名。这有助于查找*最近*表现良好者,而不仅仅是全时段。

<CodeGroup>
  ```bash 最近 7 天 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 自定义范围 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>

支持的 `period` 简写:`1d`、`7d`、`14d`、`30d`、`90d`。

***

## KOL 日历(每月热图)

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

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

每一天包括总 PnL、交易笔数和活跃 KOL 数量(基于受追踪集合)。

<Tip>
  按聚合 PnL 为各日着色,可一眼发现全市场趋势。
</Tip>

***

## 单日 KOL 详细数据

[每日细分](/cn/data-api/pnl-v2/get-kol-daily-breakdown)显示某一特定日子每个受追踪 KOL 的活动。

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

可用此回答诸如 "上线当天 KOL 交易了什么?" 或 "拉升期间谁的表现最好?" 之类的问题。

***

## 深入查看某个 KOL 的钱包

一旦发现值得调查的 KOL,将其钱包地址传给钱包分析端点:

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

***

## 构建跟单推送

将 KOL 追踪与代币交易结合,构建 KOL 买入内容的实时推送:

1. **从排行榜端点拉取 KOL 列表**
2. **检查每个钱包的持仓**,按 `last_trade` 排序以查看其最新动作
3. **使用[代币信息](/cn/data-api/get-token-information)端点交叉对比代币**元数据
4. **设置告警**,通过定期轮询持仓并与上一状态做差异比较

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

// Check each KOL's latest positions
for (const kol of kols) {
  const { data: positions } = await fetch(
    `https://data.solanatracker.io/v2/pnl/wallets/${kol.wallet}/positions?sort=last_trade&direction=desc&limit=5&filter=holding`,
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  ).then(r => r.json());

  console.log(`\n${kol.identity.name} (@${kol.identity.twitter}):`);
  positions.forEach(p => {
    console.log(`  ${p.meta.symbol}: $${p.position.valueUsd.toFixed(2)} held`);
  });
}
```

<CardGroup cols={2}>
  <Card title="钱包分析" href="/cn/guides/pnl-v2/wallet-analysis">
    检视任意钱包 PnL、持仓和风险的完整指南。
  </Card>

  <Card title="排行榜" href="/cn/guides/pnl-v2/leaderboards">
    带有所有排序和过滤选项的 KOL 和顶级交易者排名。
  </Card>
</CardGroup>