钱包标签通过
identity 对象返回。一个钱包可以同时具有多个标签,因此请始终将 identity.tags 读取为数组,而不是假设只有一个标签。快速开始
PnL V2 钱包、代币、排行榜和批量响应中,如果已知标签,即会出现钱包身份。
identity 可以是 null。
identity.type 是用于单徽章 UI 的主要标签。identity.tags 是完整的标签列表,当您需要每个标签时应使用它。
在上面的示例中,钱包被标记为已知的机器人。UI 可以显示来自 identity.type 的一个徽章,而过滤系统应读取 identity.tags 中的每个值。
原始钱包信号
一些钱包端点还会返回带有较低层级套利和平台信号的原始tags 对象:
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 |
axiom-flash 作为 platform 查询值被接受,但身份响应会将其规范化为 axiom 标签。标签类别
人和机器人
使用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 或逗号分隔的组合。

GET /v2/pnl/leaderboard/topGET /v2/pnl/tokens/:token/tradersGET /v2/pnl/tokens/:token/first-buyers
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 |
常见问题
一个钱包能有多个标签吗?
一个钱包能有多个标签吗?
bot、potential_bot 和 arbitrage 之间有什么区别?
bot、potential_bot 和 arbitrage 之间有什么区别?
bot 是策划的具名机器人标签。potential_bot 是来自钱包行为的较弱启发式信号。arbitrage 是已确认的 MEV 或套利钱包标签。为什么 axiom-flash 变成了 axiom?
为什么 axiom-flash 变成了 axiom?
axiom-flash 接受作为平台过滤,但身份响应规范化平台别名,因此客户端只需处理规范的 axiom 标签。我应该使用 identity.tags 还是原始 tags 对象?
我应该使用 identity.tags 还是原始 tags 对象?