代币情报

代币交易者

代币交易者端点返回交易过指定代币的每个钱包,带有其当前持仓和 PnL。

curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/traders?sort=pnl&direction=desc&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

const token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump";

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

traders.forEach(t => {
  // pnl.token = this token's PnL, pnl.wallet = the wallet's lifetime PnL across all tokens
  console.log(`${t.wallet}: $${t.pnl.token.total.toFixed(2)} on this token, lifetime $${t.pnl.wallet?.total?.toFixed(2) ?? "n/a"}`);
});

import requests

token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
res = requests.get(
    f"https://data.solanatracker.io/v2/pnl/tokens/{token}/traders",
    params={"sort": "pnl", "direction": "desc", "limit": 20},
    headers={"x-api-key": "YOUR_API_KEY"}
)

for t in res.json()["traders"]:
    print(f"{t['wallet']}: ${t['pnl']['token']['total']:.2f} on this token, {t['counts']['total']} trades")

排序选项

排序字段	描述
`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 和可疑活动的工具。

概览

代币数据

安全与分析

钱包与投资组合

PnL V2

实时数据流

交易

代币交易者

排序选项

过滤选项

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

内联身份

按质量过滤

交叉检查钱包

首批买家

示例:已经卖出的狙击者

钱包分析

狙击检测

​代币交易者

​排序选项

​过滤选项

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

​内联身份

按质量过滤

交叉检查钱包

​首批买家

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

钱包分析

狙击检测

代币交易者

排序选项

过滤选项

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

内联身份

首批买家

示例:已经卖出的狙击者