跳转到主要内容

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。 
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/traders?sort=pnl&direction=desc&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
排序选项

排序字段描述
pnl总 PnL
realized仅已实现 PnL
unrealized仅未实现 PnL
invested投入的总美元金额
roi投资回报率百分比
holding当前代币余额
value剩余持仓的当前美元价值
first_trade首次交易时间
last_trade最近交易时间

​
过滤选项

参数描述
activeOnly仅显示当前持有该代币的钱包
minTrades最少交易次数
excludeArbitrage排除被标记为套利机器人的钱包。默认: true — 套利 PnL 噪声大,目标是追踪真实交易者。传入 false 以包含它们。
excludeZeroBuys排除未购买而获得代币的钱包(空投、转账)。默认: true。
platform按交易平台过滤(axiom、bloom、photon)。逗号分隔多个。axiom-flash 作为 axiom 别名被接受。
此端点不接受 pnlMode。它返回的钱包级 PnL(pnl.wallet)反映 API 的钱包摘要视图。

​
响应结构:pnl.token vs pnl.wallet

每个交易者携带两个 PnL 对象:
  • pnl.token — 仅此代币的已实现 / 未实现 / 总 PnL。
  • pnl.wallet — 钱包交易过的每个代币的终身已实现 / 未实现 / 总 PnL。
这让您可以在一次查询中发现在此代币上盈利但整体亏损的交易者(反之亦然),而无需第二次请求。
问题使用的字段
此钱包在该代币上是否盈利?pnl.token
此钱包整体上是否盈利?pnl.wallet
钱包是否仍持有该代币?position.balance
钱包何时首次买入?timing.firstTrade

​
内联身份

响应中的每个交易者都包含结构化的 identity 对象。在代币端点上,这会针对 URL 中的代币解析,因此 pool 和 developer 标签会自动反映正确的代币: 
"identity": {
  "tags": ["kol", "developer"],
  "kol": { "name": "Ansem", "twitter": "blknoiz06" },
  "developer": { "via": "creator", "creationTx": "5x7Y...", "createdAt": 1713600000000 }
}
使用这个可以在无需第二次请求的情况下过滤狙击者、发现代币开发者购买自己的上线代币,或浮现 KOL 活动。

按质量过滤

组合 minTrades、activeOnly 和 excludeArbitrage 以移除机器人和噪音。

交叉检查钱包

找到有趣的交易者?通过钱包分析指南检查他们的钱包。

​
首批买家

首批买家端点返回与代币交易者相同的数据,但仅按时间顺序排序:最早交易优先,sort=first_trade、direction=asc。用于狙击检测和早期买家分析。
first-buyers 拒绝排行榜风格的排序。对于 ROI、PnL、持仓规模、最近交易或降序排序,请使用 /v2/pnl/tokens/:token/traders。
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/first-buyers?limit=50" \
  -H "x-api-key: YOUR_API_KEY"
将首批买家与钱包摘要交叉对比,以检查他们是真实钱包、KOL 还是一次性地址。

​
示例:已经卖出的狙击者

const token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump";

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/tokens/${token}/first-buyers?limit=50`,
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const { traders } = await res.json();

// Early buyers who are fully out of the position
const snipersSold = traders.filter(t => 
  t.position.balance === 0 && t.pnl.token.realized > 0
);

console.log(`${snipersSold.length} early buyers already sold at a profit`);
snipersSold.forEach(t => {
  const holdMins = (t.timing.lastTrade - t.timing.firstTrade) / 60000;
  console.log(`  ${t.wallet}: +$${t.pnl.token.realized.toFixed(2)}, held ${holdMins.toFixed(0)} minutes`);
});
典型工作流: 代币交易者 → 筛选有趣的钱包 → 首批买家以了解上线行为 → 钱包分析查看完整图景。

钱包分析

深入了解单个钱包的完整 PnL、持仓和风险概况。

狙击检测

更多用于查找早期买家、bundler 和可疑活动的工具。