跳转到主要内容
基础 URL: https://data.solanatracker.io
认证: 在 x-api-key 请求头中传递您的 API 密钥。
数值: 所有货币金额均为美元。除非另行说明,时间戳均为 Unix 毫秒。

​
要点

​
PnL V2 涵盖的内容

  • 规模。 PnL 为约 3–4 亿个钱包追踪,包含数十亿代币持仓,接近实时更新。
  • 代币覆盖。 支持每个 SPL 代币,稳定币和 SOL 除外。
  • 钱包端点。 钱包端点可用于任何钱包,即使该钱包不在排行榜上。
  • 身份标签。 钱包可以包含 identity 对象,带有 KOL、机器人、交易所、池、开发者或交易平台等标签。

​
PnL V2 排除的内容

稳定币和 SOL 故意从 PnL 持仓中排除,因为它们是报价资产。报价资产是用于为交易定价的代币,而不是被测量的持仓。 默认情况下,使用 excludeArbitrage=true 排除套利钱包。套利 PnL 可能噪声很大,因为这些钱包通常为了池之间的微小差异交易。传入 excludeArbitrage=false 以包含它们。 顶级交易者排行榜覆盖每个时段的前 50 万个钱包。如果某个钱包在排名集之外,请直接使用钱包端点查询。

​
身份标签

每个钱包都可以携带结构化的 identity。当前支持:
  • 机器人和 MEV — potential_bot(启发式)、bot(策划的具名机器人,如 Mayhem Bot)、arbitrage(已确认的 MEV)。
  • 平台 — axiom、bloom 和 photon。API 也接受 axiom-flash 作为 axiom 的别名。
  • 安全 / 基础设施标签 — 已知时使用策划的 hacker、spam_dusting 和 exchange 标签。
  • 池和开发者 角色在代币范围的端点上自动解析。

​
PnL 模式

钱包摘要、持仓、单一持仓、顶级交易者排行榜和持仓批量端点接受 ?pnlMode=。 支持 pnlMode 的端点会在响应中回显该参数。持仓行同时包含 pnl.realized(感知模式)和 pnl.realizedRaw(未过滤),以便您的 UI 无需重新查询即可切换。 KOL 排行榜、历史、图表、表现、亮点、风险、代币交易者、首批买家以及钱包摘要批量端点不接受 pnlMode;它们返回该数据集 API 固定的服务器端视图。

​
什么是 PnL V2?

PnL V2 追踪每个 Solana 钱包的盈亏。给它一个钱包地址,它会返回:
  • 带有总 PnL、胜率和代币数量的摘要
  • 带有成本基础、当前价值以及已实现/未实现 PnL 的每个代币持仓
  • 用于权益曲线的每日历史和图表数据
  • KOL 和顶级交易者的排行榜
  • 带有集中度和敞口指标的风险分析
  • 一次性查询数百个钱包-代币对的批量查询

钱包分析

任意钱包的 PnL 摘要、持仓、每日历史、表现和风险。

代币情报

某个代币上的每位交易者——谁赚了钱、谁被套住、谁先买入。

排行榜

带有滚动窗口和日历视图的 KOL 和顶级交易者排名。

批量操作

在一次请求中获取数百个 wallet+token 对的持仓。

​
端点分组

已知道端点?

直接前往 API 参考查看 schema 和参数。

正在构建工作流?

继续阅读下方的分步指南。

​
钱包端点

​
代币端点

​
排行榜端点

​
批量端点

​
关键概念

​
已实现 PnL 与未实现 PnL

您已卖出代币的盈亏。这是锁定的——不会变化。
您仍持有代币的账面盈亏。每次价格跳动都会变化。
已实现 + 未实现。完整画面。

​
钱包覆盖

PnL V2 覆盖2023 年 12 月以后的所有 Solana 钱包。钱包不会按请求索引。

​
分页

列表端点使用基于游标的分页。从响应中获取 pagination.nextCursor,并将其作为 cursor 查询参数传入以获取下一页。

​
钱包身份

每个钱包范围的响应都包含一个结构化的 identity 对象。它合并多个来源,因此钱包可以同时携带多个标签(例如 ["kol", "developer", "axiom"])。仅返回已填充的字段: 在代币范围的端点(/tokens/:token/traders、/first-buyers、/tokens/:token/positions/batch)上,pool 和 developer 角色针对路径中的确切代币解析,因此您可以行内发现开发者、LP 和狙击者,而无需额外请求。完整支持的标签列表请参阅 Solana 钱包标签指南。

​
/tokens/:tokenAddress/holders 上的丰富化

经典 holders 端点接受可选的 ?enrich= 参数:
  • ?enrich=identity — 为每个持有者添加 pool / developer / platform 身份。
  • ?enrich=walletPnl — 为每个持有者添加终身钱包 PnL 加每代币 PnL。
  • ?enrich=all — 两者都加。
省略时,该端点行为与之前完全相同,不增加额外工作。

​
通过 Datastream 实时

将这些 REST 端点与 Datastream PnL V2 WebSocket room 配对以获得实时更新。适用于 Premium、Business 和 Enterprise 方案: 典型模式:调用 GET /v2/pnl/wallets/:wallet 一次以播种状态,然后订阅 pnl:{wallet}:summary 保持同步。 为获得最快的未实现 PnL 跳动,将 PnL room 与价格流组合 — price:aggregated:{token}(跨池,推荐)或 price-by-token:{token}(主池)。PnL room 在每次成交时推送 tradeUpdate 和 balanceUpdate,以及偶尔受限速的 priceUpdate;价格 room 在每次市场变动时跳动。完整流程参见 PnL V2 Datastream 指南。