> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 钱包分析

> 使用 PnL V2 钱包端点获取任意 Solana 钱包的 PnL 汇总、未平仓持仓、每日历史、风险敞口、投资组合图表与亮眼交易。

## 钱包摘要

从这里开始。[钱包摘要](/cn/data-api/pnl-v2/get-wallet-summary)提供顶层视图:总 PnL、胜率、交易过的代币数量和 ROI 分布。

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";

  const res = await fetch(`https://data.solanatracker.io/v2/pnl/wallets/${wallet}`, {
    headers: { "x-api-key": "YOUR_API_KEY" }
  });
  const data = await res.json();

  console.log(`Total PnL: $${data.summary.pnl.total.toFixed(2)}`);
  console.log(`Win Rate: ${data.analysis.winRate}%`);
  console.log(`Tokens Traded: ${data.summary.counts.tokensTraded}`);
  ```

  ```python Python theme={null}
  import requests

  wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"
  res = requests.get(
      f"https://data.solanatracker.io/v2/pnl/wallets/{wallet}",
      headers={"x-api-key": "YOUR_API_KEY"}
  )
  data = res.json()

  print(f"Total PnL: ${data['summary']['pnl']['total']:.2f}")
  print(f"Win Rate: {data['analysis']['winRate']}%")
  ```
</CodeGroup>

***

## 代币持仓

[持仓端点](/cn/data-api/pnl-v2/get-wallet-positions)列出钱包交易过的每个代币。按 PnL、ROI 或价值排序。按持有状态、市场、最小投资金额等过滤。

### PnL 模式

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

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions?pnlMode=adjusted" \
  -H "x-api-key: YOUR_API_KEY"
```

### 常用过滤器

<AccordionGroup>
  <Accordion title="仅显示盈利持仓">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?filter=profit&sort=total&direction=desc
    ```
  </Accordion>

  <Accordion title="显示当前持有的代币">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?filter=holding&sort=value&direction=desc
    ```
  </Accordion>

  <Accordion title="按最小投资过滤">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?minInvested=100&sort=roi&direction=desc
    ```
  </Accordion>

  <Accordion title="按特定市场过滤(例如 pump.fun)">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?market=pumpfun&sort=total&direction=desc
    ```
  </Accordion>
</AccordionGroup>

### 单一持仓

要深入某个代币,请使用[钱包代币持仓](/cn/data-api/pnl-v2/get-wallet-token-position)端点:

```bash theme={null}
GET /v2/pnl/wallets/{wallet}/tokens/{token}
```

返回完整持仓:已实现/未实现 PnL、成本基础、当前价值、买/卖笔数、交易时机和代币元数据。

***

## PnL 日历

[PnL 日历端点](/cn/data-api/pnl-v2/get-wallet-daily-history)显示钱包的 PnL 每天的变化。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-calendar.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=32e956ede9e011871af7d0e29df564b2" alt="显示每日绿色和红色盈亏单元格的 PnL 日历" width="1038" height="1292" data-path="images/guides/pnl-calendar.png" />

<CodeGroup>
  ```bash 最近 30 天 theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```bash 自定义日期范围 theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?start=2025-01-01&end=2025-01-31" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

每一天包含:

* **运行总计** — 截至当日的 PnL、投资额和收益
* **当日活动** — 当日已实现 PnL、成交量和交易笔数

<Tip>
  当您需要解释每天发生了什么变化时,使用 **history**。当您需要可视化权益曲线时,使用 **chart**。
</Tip>

***

## 图表数据

[图表端点](/cn/data-api/pnl-v2/get-wallet-chart)返回最多 180 个每日数据点,用于绘制权益、已实现 PnL 和活动。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-chart.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=9a2eb20d19fc7bfada16fb86785be20d" alt="显示已实现利润随时间变化、成交量、胜率和回撤的 PnL 图表" width="2690" height="1010" data-path="images/guides/pnl-chart.png" />

```javascript theme={null}
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 秒)翻页查看较旧的数据。

***

## 表现

[表现端点](/cn/data-api/pnl-v2/get-wallet-performance)提供滚动统计:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-performance.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=7c9b39de2ea2c7c6e4cd5436251cbcfc" alt="显示最佳日、最差日、连胜和回撤的钱包表现面板" width="2534" height="728" data-path="images/guides/pnl-performance.png" />

| 指标       | 描述              |
| -------- | --------------- |
| 总已实现 PnL | 窗口内的已实现 PnL 总和  |
| 连胜/连败    | 当前和最大连续盈利/亏损天数  |
| 最大回撤     | 从最高值到最低谷的最大跌幅   |
| 最佳/最差日   | 单一最佳和最差交易日      |
| 每日细分     | 按天 PnL、成交量和交易笔数 |

```bash theme={null}
# 最近 90 天表现
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/performance?days=90" \
  -H "x-api-key: YOUR_API_KEY"
```

***

## 亮点

[亮点端点](/cn/data-api/pnl-v2/get-wallet-highlights)返回钱包中最值得关注的持仓:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-highlights.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=b2ffc5854ac6d0ebb5e8aadfef3d7772" alt="显示最大赢家、输家、持仓和最快反转的 PnL 亮点面板" width="2536" height="538" data-path="images/guides/pnl-highlights.png" />

<CardGroup cols={2}>
  <Card title="最大赢家">
    已实现 PnL 最高的持仓
  </Card>

  <Card title="最大输家">
    已实现亏损最严重的持仓
  </Card>

  <Card title="最快反转">
    带有利润的最短持有时间
  </Card>

  <Card title="最长持有">
    持有时间最长的持仓
  </Card>

  <Card title="最大仓位">
    美元价值最高的当前持仓
  </Card>

  <Card title="最常交易">
    买/卖交易笔数最多的代币
  </Card>
</CardGroup>

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/highlights" \
  -H "x-api-key: YOUR_API_KEY"
```

***

## 风险

[风险端点](/cn/data-api/pnl-v2/get-wallet-risk)评估当前投资组合敞口:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-exposure.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=921b7de365bb379afcdecd660f80c235" alt="显示持仓、成本基础、当前价值和 PnL 构成的钱包敞口面板" width="2526" height="756" data-path="images/guides/pnl-exposure.png" />

* **投资组合集中度** — 前 1 和前 5 持仓占多少
* **已实现与未实现拆分** — 钱包是坐拥账面收益还是已锁定利润?
* **持仓价值** — 当前持仓的总美元价值
* **风险持仓** — 流动性低或集中度风险高的代币列表

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/risk" \
  -H "x-api-key: YOUR_API_KEY"
```

<Warning>
  风险仅涵盖**当前持仓**。已售出的持仓不包含。
</Warning>

***

## 实时更新

使用 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 指南](/cn/guides/datastream-pnl)。

<CardGroup cols={2}>
  <Card title="下一步:代币情报" href="/cn/guides/pnl-v2/token-intelligence">
    查看某个特定代币在各个钱包之间的交易情况。
  </Card>

  <Card title="API 参考" href="/cn/data-api/pnl-v2/get-wallet-summary">
    钱包摘要响应的完整 schema 细节。
  </Card>
</CardGroup>