> ## 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.

# Solana 钱包标签

> PnL V2 支持的 Solana 钱包身份标签，包括 KOL、机器人、套利、黑客、交易所、开发者、流动性池以及各类平台与协议标签。

钱包标签是解释钱包可能是什么或如何行为的标签。PnL V2 钱包标签 API 用有用的身份和行为信号标记 Solana 钱包:KOL、机器人、套利钱包、漏洞利用钱包、交易所、代币开发者、池账户和交易平台使用。

使用这些标签清理交易者排行榜、识别钱包类型、过滤噪音活动,并在钱包分析产品中显示更好的标签。

<Info>
  钱包标签通过 `identity` 对象返回。一个钱包可以同时具有多个标签,因此请始终将 `identity.tags` 读取为数组,而不是假设只有一个标签。
</Info>

## 快速开始

PnL V2 钱包、代币、排行榜和批量响应中,如果已知标签,即会出现钱包身份。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/wallet-tags.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=01ede7436f795c1f3e4887d29d4226e1" alt="显示钱包名称旁边身份标签的钱包资料" width="2542" height="832" data-path="images/guides/wallet-tags.png" />

```json theme={null}
{
  "identity": {
    "name": "Mayhem Bot",
    "avatar": "https://kol-avatar.solanatracker.io/...",
    "bot": {
      "name": "Mayhem Bot",
      "avatar": "https://kol-avatar.solanatracker.io/..."
    },
    "type": "bot",
    "tags": ["bot"]
  }
}
```

如果钱包没有已知标签,`identity` 可以是 `null`。

`identity.type` 是用于单徽章 UI 的主要标签。`identity.tags` 是完整的标签列表,当您需要每个标签时应使用它。

在上面的示例中,钱包被标记为已知的机器人。UI 可以显示来自 `identity.type` 的一个徽章,而过滤系统应读取 `identity.tags` 中的每个值。

## 原始钱包信号

一些钱包端点还会返回带有较低层级套利和平台信号的原始 `tags` 对象:

```json theme={null}
{
  "tags": {
    "isArbitrage": false,
    "platforms": ["axiom", "bloom"]
  }
}
```

将 `identity.tags` 用于 UI 标签和过滤逻辑。当您特别需要底层套利/平台信号时,使用原始 `tags` 对象。

## 支持的钱包标签

| 标签              | 含义                                             | 额外字段                                                                                                                  |
| --------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `kol`           | 受追踪的 KOL 钱包。                                   | `name`、`twitter`、`avatar`                                                                                             |
| `bot`           | 策划的具名机器人钱包,例如 Mayhem Bot 或其他已知的自动化交易者。         | `bot.name`、`bot.avatar`                                                                                               |
| `potential_bot` | 来自钱包活动的启发式机器人 / 类套利信号。比 `bot` 或 `arbitrage` 弱。 | 无                                                                                                                     |
| `arbitrage`     | 来自策划套利列表的已确认 MEV / 套利钱包。                       | 无                                                                                                                     |
| `hacker`        | 策划的漏洞利用、诈骗或攻击者钱包标签。                            | `hacker.label`,通常被提升为 `name`                                                                                          |
| `spam_dusting`  | 策划的垃圾粉尘钱包标签。                                   | `spamDusting.label`,通常被提升为 `name`                                                                                     |
| `exchange`      | 已知的中心化交易所热钱包。                                  | `exchange.name`,通常被提升为 `name`                                                                                         |
| `developer`     | 代币创建者、池部署者、mint authority 或与代币创建相关的钱包。         | `developer.token`、`developer.via`、`developer.pools`、`developer.creationTx`、`developer.createdAt`,或 `developer.tokens` |
| `pool`          | AMM 池、vault、authority、LP mint、联合曲线或相关池账户。      | `pool.program`、`pool.poolAddress`、`pool.tokenA`、`pool.tokenB`                                                         |
| `axiom`         | 与 Axiom 关联的钱包活动。                               | `platforms` 包含 `axiom`                                                                                                |
| `bloom`         | 与 Bloom 关联的钱包活动。                               | `platforms` 包含 `bloom`                                                                                                |
| `photon`        | 与 Photon 关联的钱包活动。                              | `platforms` 包含 `photon`                                                                                               |

<Note>
  `axiom-flash` 作为 `platform` 查询值被接受,但身份响应会将其规范化为 `axiom` 标签。
</Note>

## 标签类别

### 人和机器人

使用 `kol`、`bot`、`potential_bot` 和 `arbitrage` 来区分人类交易者与自动化或 MEV 风格的行为。

`potential_bot` 是较弱的启发式信号。`bot` 和 `arbitrage` 是更强的策划标签。

### 安全和基础设施

使用 `hacker`、`spam_dusting` 和 `exchange` 进行安全警告和基础设施标签。

这些标签是策划的,也可能将可读的标签提升到 `identity.name` 中,例如交易所名称或垃圾粉尘攻击标签。

### 代币上下文

在代币范围的端点上使用 `developer` 和 `pool` 来查找代币创建者、池部署者、mint authority、LP 账户、池金库和联合曲线账户。

代币范围的端点会为 URL 中的代币解析这些角色,这有助于在代币持有者或首批买家列表中检测内部人和非交易者钱包。

## 平台过滤器

以下端点接受 `platform=axiom`、`platform=bloom`、`platform=photon` 或逗号分隔的组合。

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/axiom-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=f6ef49ec2b3ad1894f68873a420f1a91" alt="过滤为通过 Axiom 交易的钱包的 Axiom 排行榜" width="2596" height="2138" data-path="images/guides/axiom-leaderboard.png" />

* `GET /v2/pnl/leaderboard/top`
* `GET /v2/pnl/tokens/:token/traders`
* `GET /v2/pnl/tokens/:token/first-buyers`

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/traders?platform=axiom,bloom" \
  -H "x-api-key: YOUR_API_KEY"
```

`platform=axiom-flash` 也被接受,并被视为 `axiom`。

## 标签出现位置

当 API 可以解析标签时,PnL V2 钱包、代币、排行榜和批量响应中会返回钱包身份。

* 钱包摘要和钱包持仓返回顶层 `identity`。
* 代币交易者端点为每个交易者返回 `identity`。
* 代币范围的端点为 URL 中的代币解析 `developer` 和 `pool`。
* 持仓批量端点为每个钱包或持仓返回 `identity`。
* `POST /v2/pnl/wallets/batch` 为每个钱包同时返回 `identity` 和原始 `tags`。

## 常见用例

| 目标       | 要检查的标签                                           |
| -------- | ------------------------------------------------ |
| 隐藏噪音钱包   | `bot`、`potential_bot`、`arbitrage`、`spam_dusting` |
| 显示已知人员   | `kol`                                            |
| 标记代币内部人  | `developer`、`pool`                               |
| 浮现安全警告   | `hacker`、`spam_dusting`                          |
| 识别交易所资金流 | `exchange`                                       |
| 按交易前端过滤  | `axiom`、`bloom`、`photon`                         |

## 常见问题

<AccordionGroup>
  <Accordion title="一个钱包能有多个标签吗?">
    是的。例如,根据代币上下文,一个钱包可以同时是 `kol` 和 `axiom`,或者是 `developer` 和 `pool`。请始终将 `identity.tags` 作为数组读取。
  </Accordion>

  <Accordion title="bot、potential_bot 和 arbitrage 之间有什么区别?">
    `bot` 是策划的具名机器人标签。`potential_bot` 是来自钱包行为的较弱启发式信号。`arbitrage` 是已确认的 MEV 或套利钱包标签。
  </Accordion>

  <Accordion title="为什么 axiom-flash 变成了 axiom?">
    `axiom-flash` 接受作为平台过滤,但身份响应规范化平台别名,因此客户端只需处理规范的 `axiom` 标签。
  </Accordion>

  <Accordion title="我应该使用 identity.tags 还是原始 tags 对象?">
    在大多数应用中,使用 `identity.tags` 进行标签、徽章和过滤。当您特别需要 `isArbitrage` 或原始平台数组时,使用原始 `tags` 对象。
  </Accordion>
</AccordionGroup>