钱包摘要
从这里开始。钱包摘要提供顶层视图:总 PnL、胜率、交易过的代币数量和 ROI 分布。
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}" \
-H "x-api-key: YOUR_API_KEY"
代币持仓
持仓端点列出钱包交易过的每个代币。按 PnL、ROI 或价值排序。按持有状态、市场、最小投资金额等过滤。
PnL 模式
钱包摘要、持仓和单一持仓端点支持 ?pnlMode=strict|adjusted|raw。默认为 strict,会过滤掉卖出数量大于买入数量的持仓(通常无效)。切换到 adjusted 查看成本基础已修正的视图,或 raw 查看全部未过滤数据。详情见要点。
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions?pnlMode=adjusted" \
-H "x-api-key: YOUR_API_KEY"
常用过滤器
GET /v2/pnl/wallets/{wallet}/positions?filter=profit&sort=total&direction=desc
GET /v2/pnl/wallets/{wallet}/positions?filter=holding&sort=value&direction=desc
GET /v2/pnl/wallets/{wallet}/positions?minInvested=100&sort=roi&direction=desc
GET /v2/pnl/wallets/{wallet}/positions?market=pumpfun&sort=total&direction=desc
单一持仓
要深入某个代币,请使用钱包代币持仓端点:
GET /v2/pnl/wallets/{wallet}/tokens/{token}
返回完整持仓:已实现/未实现 PnL、成本基础、当前价值、买/卖笔数、交易时机和代币元数据。
PnL 日历
PnL 日历端点显示钱包的 PnL 每天的变化。
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d" \
-H "x-api-key: YOUR_API_KEY"
每一天包含:
- 运行总计 — 截至当日的 PnL、投资额和收益
- 当日活动 — 当日已实现 PnL、成交量和交易笔数
当您需要解释每天发生了什么变化时,使用 history。当您需要可视化权益曲线时,使用 chart。
图表数据
图表端点返回最多 180 个每日数据点,用于绘制权益、已实现 PnL 和活动。
const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";
const res = await fetch(`https://data.solanatracker.io/v2/pnl/wallets/${wallet}/chart`, {
headers: { "x-api-key": "YOUR_API_KEY" }
});
const { points, summary } = await res.json();
// points is an array of daily chart rows
// summary contains streaks, drawdown, and win-rate style aggregates
console.log(points.length, summary.winRate);
使用 time_from 和 time_to(Unix 秒)翻页查看较旧的数据。
表现端点提供滚动统计:
| 指标 | 描述 |
|---|
| 总已实现 PnL | 窗口内的已实现 PnL 总和 |
| 连胜/连败 | 当前和最大连续盈利/亏损天数 |
| 最大回撤 | 从最高值到最低谷的最大跌幅 |
| 最佳/最差日 | 单一最佳和最差交易日 |
| 每日细分 | 按天 PnL、成交量和交易笔数 |
# 最近 90 天表现
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/performance?days=90" \
-H "x-api-key: YOUR_API_KEY"
亮点端点返回钱包中最值得关注的持仓:
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/highlights" \
-H "x-api-key: YOUR_API_KEY"
风险端点评估当前投资组合敞口:
- 投资组合集中度 — 前 1 和前 5 持仓占多少
- 已实现与未实现拆分 — 钱包是坐拥账面收益还是已锁定利润?
- 持仓价值 — 当前持仓的总美元价值
- 风险持仓 — 流动性低或集中度风险高的代币列表
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/risk" \
-H "x-api-key: YOUR_API_KEY"
实时更新
使用 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 细节。