跳转到主要内容

钱包摘要

从这里开始。钱包摘要提供顶层视图:总 PnL、胜率、交易过的代币数量和 ROI 分布。

代币持仓

持仓端点列出钱包交易过的每个代币。按 PnL、ROI 或价值排序。按持有状态、市场、最小投资金额等过滤。

PnL 模式

钱包摘要、持仓和单一持仓端点支持 ?pnlMode=strict|adjusted|raw。默认为 strict,会过滤掉卖出数量大于买入数量的持仓(通常无效)。切换到 adjusted 查看成本基础已修正的视图,或 raw 查看全部未过滤数据。详情见要点

常用过滤器

单一持仓

要深入某个代币,请使用钱包代币持仓端点:
返回完整持仓:已实现/未实现 PnL、成本基础、当前价值、买/卖笔数、交易时机和代币元数据。

PnL 日历

PnL 日历端点显示钱包的 PnL 每天的变化。 显示每日绿色和红色盈亏单元格的 PnL 日历
每一天包含:
  • 运行总计 — 截至当日的 PnL、投资额和收益
  • 当日活动 — 当日已实现 PnL、成交量和交易笔数
当您需要解释每天发生了什么变化时,使用 history。当您需要可视化权益曲线时,使用 chart

图表数据

图表端点返回最多 180 个每日数据点,用于绘制权益、已实现 PnL 和活动。 显示已实现利润随时间变化、成交量、胜率和回撤的 PnL 图表
使用 time_fromtime_to(Unix 秒)翻页查看较旧的数据。

表现

表现端点提供滚动统计: 显示最佳日、最差日、连胜和回撤的钱包表现面板

亮点

亮点端点返回钱包中最值得关注的持仓: 显示最大赢家、输家、持仓和最快反转的 PnL 亮点面板

最大赢家

已实现 PnL 最高的持仓

最大输家

已实现亏损最严重的持仓

最快反转

带有利润的最短持有时间

最长持有

持有时间最长的持仓

最大仓位

美元价值最高的当前持仓

最常交易

买/卖交易笔数最多的代币

风险

风险端点评估当前投资组合敞口: 显示持仓、成本基础、当前价值和 PnL 构成的钱包敞口面板
  • 投资组合集中度 — 前 1 和前 5 持仓占多少
  • 已实现与未实现拆分 — 钱包是坐拥账面收益还是已锁定利润?
  • 持仓价值 — 当前持仓的总美元价值
  • 风险持仓 — 流动性低或集中度风险高的代币列表
风险仅涵盖当前持仓。已售出的持仓不包含。

实时更新

使用 Datastream PnL V2 room 保持钱包同步,无需轮询:
  • pnl:{wallet}:summary — 包含已实现/未实现 PnL、ROI、计数、平均值和持仓总额的总钱包 PnL 摘要。
  • pnl:{wallet} — 钱包接触的每个代币,tradeUpdate / balanceUpdate
  • pnl:{wallet}:{token} — 单一持仓。
使用 GET /v2/pnl/wallets/:wallet 为 UI 播种,然后订阅摘要 room。完整事件 payload 请参阅 Datastream PnL 指南

下一步:代币情报

查看某个特定代币在各个钱包之间的交易情况。

API 参考

钱包摘要响应的完整 schema 细节。