跳转到主要内容

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.

在购买代币之前,了解谁持有该代币至关重要。如果少数钱包持有大部分供应量,这些钱包可以操纵市场或造成严重风险。Data API 根据您需要的持有者数据量,提供了三种端点。

前 100 名持有者

top 100 holders 端点按余额返回最大的钱包——快速且无需分页。
curl "https://data.solanatracker.io/tokens/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/holders" \
  -H "x-api-key: YOUR_API_KEY"

前 20 名持有者

top 20 holders 端点是一个更轻量的调用——适用于快速检查巨鲸集中度,无需拉取完整的 100 名。
curl "https://data.solanatracker.io/tokens/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/holders/top" \
  -H "x-api-key: YOUR_API_KEY"
快速集中度检查:
const res = await fetch(`https://data.solanatracker.io/tokens/${token}/holders/top`, {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const holders = await res.json();

const top10Pct = holders.slice(0, 10).reduce((sum, h) => sum + h.percentage, 0);
console.log(`Top 10 wallets hold ${top10Pct.toFixed(1)}% of supply`);

if (top10Pct > 50) {
  console.log("🚨 High concentration — rug risk");
} else if (top10Pct > 30) {
  console.log("⚠️ Moderate concentration — proceed with caution");
} else {
  console.log("✅ Reasonably distributed supply");
}

所有持有者(分页)

如需完整导出每个持有者——用于构建持有者面板、追踪供应分布变化或进行深度风险分析——请使用分页持有者端点。每页最多支持 5,000 个持有者。 游标分页是指响应会返回一个 nextCursor。在下次请求中传入该游标以获取下一页。
# 第一页
curl "https://data.solanatracker.io/tokens/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/holders/paginated?limit=1000" \
  -H "x-api-key: YOUR_API_KEY"

# 后续页 — 传入上一次响应中的游标
curl "https://data.solanatracker.io/tokens/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/holders/paginated?limit=1000&cursor=CURSOR_FROM_PREV_RESPONSE" \
  -H "x-api-key: YOUR_API_KEY"

持有者集中度分析

获取持有者列表后,您可以计算供应集中度。它显示了代币供应量中有多少由最大的钱包控制。 显示头部代币持有者旁边钱包标签的持有者表格
async function analyzeConcentration(token) {
  const res = await fetch(
    `https://data.solanatracker.io/tokens/${token}/holders/top`,
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );
  const holders = await res.json();

  const top5   = holders.slice(0, 5).reduce((s, h) => s + h.percentage, 0);
  const top10  = holders.slice(0, 10).reduce((s, h) => s + h.percentage, 0);
  const top20  = holders.reduce((s, h) => s + h.percentage, 0);

  console.log(`Top 5 wallets:  ${top5.toFixed(1)}%`);
  console.log(`Top 10 wallets: ${top10.toFixed(1)}%`);
  console.log(`Top 20 wallets: ${top20.toFixed(1)}%`);
  console.log(`Largest single holder: ${holders[0].percentage.toFixed(2)}%`);

  // Flag high-risk patterns
  if (holders[0].percentage > 20) console.log("🚨 Single whale holds >20% — high risk");
  if (top10 > 50)                  console.log("🚨 Top 10 hold >50% of supply — danger");
}
请将持有者数据与代币信息端点返回的风险评分交叉对比——它已考虑了前 10 集中度和单钱包持有阈值。详情请参阅代币安全与 Rugcheck 指南。

用例

您要构建的内容使用的端点
购买前快速集中度检查前 20 名持有者
代币页面上的持有者数量徽章前 100(检查 total 字段)
完整的持有者导出 / CSV分页(游标循环)
巨鲸提醒 — 检测大额持仓前 100 或前 20,按 percentage 过滤
历史持有者分布随时间的分页快照

实时持有者更新

要实时追踪持有者变化——新持有者、巨鲸退出和创建者钱包抛售——请使用 Datastream WebSocket。请参阅实时代币持有者更新指南。