Skip to main content
PnL V2 根据已索引的 Solana 交易计算钱包收益。比较钱包前，应使用一致的计算模式、币种和时间范围。
基础 URL: https://data.solanatracker.io
认证: 在 x-api-key 请求头中传递您的 API 密钥。
数值: 所有货币金额均为美元。除非另行说明,时间戳均为 Unix 毫秒。

​
要点

​
PnL V2 涵盖的内容

  • 代币覆盖。 支持每个 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 保留原始值；切换模式时重新请求被过滤的持仓。 KOL 排行榜、历史、图表、表现、亮点、风险、代币交易者、首批买家以及钱包摘要批量端点不接受 pnlMode;它们返回该数据集 API 固定的服务器端视图。

​
端点分组

​
钱包端点

​
代币端点

​
排行榜端点

​
批量端点

​
关键概念

​
已实现 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 指南。