binance-wallet-tracker

Binance 钱包追踪器技能

链上钱包追踪与监控。监控私人群组或公开 Smart Money / KOL 数据的代币级和交易级活动。内置 9 种分析场景，可用于回放和模式检测。

前置条件

此技能需要 baw CLI（@binance/agentic-wallet npm 包）。如果找不到 baw：

npm install -g @binance/agentic-wallet

验证：baw --version 应输出 1.6.2 或更高版本。如果安装失败或用户没有 Node.js，请告知他们需要 Node.js >= 18。

适用场景

发现

用户意图	命令
共识代币（买家众多）	tracker token query → 按 consensusCount 排序
先锋代币（≤2 名交易者）	tracker token query → 按 launchTime 和 consensusCount ≤ 2 筛选
榜单差异（未追踪的钱包）	leaderboard query（leaderboard 技能）+ tracker address list → 比较差异
按代币查找买家	tracker tx query → 在客户端按 ca 筛选
时间窗口摘要	tracker token query --period 4h + tracker tx query
发现相似钱包	leaderboard analyze（leaderboard 技能）→ 匹配类型

评估

用户意图	命令
代币风险筛查	tracker token query → 按 tokenRiskLevel ≥ 3 + consensusCount ≥ 3 筛选
群组节奏分析	tracker tx query → 按地址分析节奏
关注列表评估	tracker follow + leaderboard analyze（跨技能）
代币热度分析	tracker tx query → 按 ca 汇总

回放

用户意图	命令
4h 综合摘要	tracker token query --period 4h + tracker tx query
累积与派发（Accumulation/Distribution）	tracker token query → 按地址查看 buyCount/sellCount
板块轮动	tracker tx query → 比较不同时间窗口内的代币排名
异常大额订单	tracker tx query → 检测 anomaly
往返交易（Round-Trip）	tracker tx query → 检测 round-trip
先行者 + 领头者-跟随者	tracker tx query → 检测 first-mover + leader-follower
唤醒检测	tracker tx query → 检测 wake-up
类机器人行为	tracker tx query → 检测 bot-like

完整的 9 种场景分析规则：references/analytics.md

管理

用户意图	命令
创建 / 重命名群组	tracker group create/update
批量导入地址	tracker address batch
添加单个地址	tracker address add
	更新标签 / 关联群组
删除地址	tracker address delete
关注 / 取消关注地址	tracker address follow/unfollow
查看关注列表	tracker follow
搜索地址（模糊搜索）	tracker address search

支持的链

链	chainId
BSC	56
Solana	CT_501
Base	8453
Ethereum	1
Robinhood	4663

此表列出已验证可用于追踪的链，是 baw wallet chains（返回所有钱包支持的链，例如 Arbitrum 42161、Polygon 137）的子集。在将某条链视为不支持追踪之前，请先探测该链——钱包链列表是动态的。

命令树

baw tracker
  token query                # Token dimension monitor (private + --tag-type for public)
  tx query                   # Trade dimension monitor (private + --tag-type for public)
  follow                     # Query current user follow list (read-only, chainId only)
  ws                         # WebSocket real-time push (--smy/--kol/--wallet/--address/--following)
  group
    list                     # Group list
    create                   # Create group
    update                   # Rename group
  address
    search                   # Fuzzy search address
    list                     # Paginated address list
    add                      # Add single address (wraps import)
    batch                    # Batch import
    update                   # Update label (label only)
    link                     # Link to group (group/link)
    delete                   # Delete (supports batch)
    follow                   # Follow address
    unfollow                 # Unfollow

所有命令均支持 --json，用于输出结构化数据。

token query 和 tx query 必须提供 --group-id（私人群组）或 --tag-type（公开 KOL/SMY）之一。两者都不提供将返回错误。

--tag-type 可接受：kol（KOL）、smy（Smart Money）。

代币监控（A2）

# Private — own group data (must specify --group-id or --tag-type)
baw tracker token query -c 56 --group-id 1 --json
baw tracker token query -c 56 --group-id 1 --period 4h --json

# Public — SMY/KOL data
baw tracker token query -c 56 --tag-type kol --json   # KOL
baw tracker token query -c CT_501 --tag-type smy --json  # Smart Money

返回按代币聚合的数据：代币名称、CA、价格、市值、交易量、addressList[]（每个地址的买入/卖出/流入数据）、launchTime、tokenRiskLevel、tokenTag。

共识计算：API 不会返回顶层的 traderNum 或 inFlow。CLI 会聚合出 consensusCount = addressList.length、netInflow = Σ addressList[].inflow、countBuy/countSell = 买入/卖出次数之和。请直接使用这些字段。

每个地址的字段：address、label、buyCount、sellCount、inflow、tokenQty、latestTxTime、lastTrade、addressLogoUrl。

完整的参数和返回字段参考： references/cli.md

交易监控（A3）

# Private — own group trade flow
baw tracker tx query -c 56 --group-id 1 --json

# Public — SMY/KOL trade flow
baw tracker tx query -c 56 --tag-type smy --json

# Filter by trade side (19=buy, 11=first-buy, 29=sell, 21=clear)
baw tracker tx query -c 56 --group-id 1 --trade-side 19 --json

返回每笔交易的记录：txHash、logId、address、ts、tradeSideCategory、txUsdValue、tokenPrice、currentPrice、ca、tokenName、marketCap、tokenRiskLevel、tokenTag，以及可选字段 toAddress、toLabel、nativePrice、txNativeTokenQty、tokenDecimals、tokenSupply、launchTime、rwaType。

⚠️ 重要：ts 的单位是秒（不是毫秒） — 10 位 Unix 时间戳。所有时间窗口计算（往返交易 <1h、沉睡后唤醒 >72h、共同买入 10 分钟窗口）都必须使用秒。A2 的 latestTxTime/launchTime 单位是毫秒（13 位）。

不支持分页 — 一次响应会返回所有匹配记录。

ca/address 筛选（Skill 的职责）：A3 API 不接受 ca 或 address 作为筛选参数。Skill 会处理筛选：从 tx query 获取所有记录，然后按结果中的 ca（合约地址）或 address（钱包）进行匹配筛选。这支持核心场景“群组中谁在买某个代币”——获取群组的完整交易流，然后按 ca 筛选。

关注列表查询（A4）

# Query current user's follow list (chainId only)
baw tracker follow -c 56 --json

返回一个映射，其中键 = 被关注的地址，值 = {label}。

限制：只能查询当前用户的关注列表，不能查询其他用户的关注列表。对于“评估关注列表”场景，可结合 binance-leaderboard 技能中的 leaderboard analyze，对每个被关注的地址进行评分。

群组管理（B1）

# List groups (displayOrder: All=-1, Default=0, others sequential)
baw tracker group list -c 56 --json

# Create group
baw tracker group create -c 56 -n "Base-Sniper" --json

# Rename group
baw tracker group update -c 56 -g 1 -n "NewName" --json

# Note: group delete is not available in the CLI. Groups can only be created and renamed.

群组字段：groupId、groupName、addressCount、displayOrder。按 displayOrder 对群组排序：All=-1、Default=0，其余依次排列。

地址管理（B2）

# Fuzzy search
baw tracker address search -c 56 -g 1 -a 0xabc --json

# Paginated list
baw tracker address list -c 56 -g 1 --page 1 --size 20 --json

# Single add (wraps import with enforce=false)
baw tracker address add -c 56 -g 1 -a 0xabc --label "Whale1" --json

# Batch import (comma-separated addresses or JSON array of {address,label})
baw tracker address batch -c 56 -g 1 -a 0xabc,0xdef --json
# Or with labels: -a '[{"address":"0xabc","label":"Whale1"},{"address":"0xdef"}]'

# Update label only (groupId is deprecated for update)
baw tracker address update -c 56 -a 0xabc --label "NewLabel" --json

# Link to another group
baw tracker address link -c 56 -a 0xabc -g 2 --json

# Delete (comma-separated addresses)
baw tracker address delete -c 56 -g 1 -a 0xabc,0xdef -y --json

# Follow / unfollow
baw tracker address follow -c 56 -g 1 -a 0xabc --label "Follow1" --json
baw tracker address unfollow -c 56 -a 0xabc --json

导入默认值：allowOverwrite 默认为 true（覆盖现有标签）。enforce 默认为 false。使用 --no-overwrite 可禁用覆盖。

关注响应：返回 {address, followed: true} — 不含 groupId 字段。followed 是布尔状态标志。

地址搜索/列表字段：返回 address、label、emoji、color、groupId、groupName、isFollowed、addressLogoUrl、genericAddressTagList、lastActiveTime、nativeTokenQty。

完整的参数和返回字段参考： references/cli.md

核心规则

共识与流入计算（A2）

API 不会返回顶层的 traderNum、inFlow、countBuy 或 countSell 字段。CLI 会从 addressList[] 聚合这些数据，并以以下字段提供：

• consensusCount（共识数）= addressList.length
• netInflow（净流入）= Σ addressList[].inflow
• countBuy（累积次数）= Σ addressList[].buyCount
• countSell（分散次数）= Σ addressList[].sellCount

请直接使用这些由 CLI 聚合的字段 — 无需从 addressList 重新计算。

累积与分散

buyCount 和 sellCount 会直接按地址返回。无需聚合 tradeSideCategory — 进行累积/分散分析时，直接使用这些字段。

客户端筛选（Skill 职责）

A2/A3 API 不接受 ca 或 address 作为筛选参数。A2 token/query 中的 caList 参数虽然可用，但后端会静默忽略。筛选由 Skill 负责处理：

1. 通过 token query 或 tx query 获取所有记录（不添加 ca/address 筛选条件）
2. 在结果中筛选匹配 ca（合约地址）或 address（钱包）的记录

这使“查找群组中购买特定代币的人”等核心场景成为可能——先获取该群组的完整交易流，再按 ca 筛选。

这会影响：按代币查找买家（共同买入）、按代币查找买家，以及任何需要聚焦于单个代币或单个地址的场景。

关注列表限制（A4）

tracker follow 仅查询当前用户的关注列表（只有 chainId，没有 address 参数）。无法评估其他用户的关注列表。对于“评估关注列表”场景，请结合 binance-leaderboard Skill 的 analyze 命令使用。

群组字段名称

group list 会返回 displayOrder。按 displayOrder 对群组排序：All=-1，Default=0，其余依次递增。

关注响应字段

address follow 响应会返回 {address, followed: true}。followed 是一个布尔状态标志。

写入后确认

任何写入操作（create/update/delete/import/follow/unfollow/link）之后，都要重新获取受影响的资源，以确认操作成功——这可以防止 agentSessionId 静默过期和后端静默失败。

读取确认失败的处理：如果读取确认显示操作未生效（例如，删除后地址仍存在，创建后找不到群组），请告知用户“操作可能未生效，请稍后重试”——切勿提及后端错误、静默失败或错误代码。

破坏性操作安全

删除、链接和取消关注操作必须在执行前使用 -y 标志（或进行交互式确认）。执行破坏性操作前，始终先向用户确认。

EVM 地址大小写规范化（仅删除）

后端会将 EVM 地址存储为小写（导入 API 会转换为小写），但 address/delete 会区分大小写。如果用户提供 EIP-55 混合大小写地址（例如 0x52908400098527886E0F7030069857D03E3248B4），删除会静默失败——返回 success:true，但实际上并未删除。CLI 不会进行规范化；它会原样传递地址。

Skill 职责：调用 baw tracker address delete 前，将 EVM 地址转换为小写：

• EVM（0x + 40 位十六进制）：address.toLowerCase()
• Solana（Base58，区分大小写）：原样传递——不要转换为小写

经 QA 验证：以混合大小写导入时会存储为小写；使用小写删除会成功；使用混合大小写删除会返回 success:true，但地址仍然存在。

批量导入行为

address batch / address add：

• allowOverwrite 默认为 true——现有标签会被覆盖
• enforce 默认为 false——跳过强制校验
• 通过 -c 指定链——CLI 不会自动检测地址格式
• 跨链自动分发（Skill 职责）：当用户提供包含 EVM 和 Solana 地址的混合列表时，Skill 必须：
  1. 根据格式识别每个地址：
     • EVM：匹配 ^0x[a-fA-F0-9]{40}$ → chainId 56（BSC）或 8453（Base）——根据用户上下文判断，或询问用户
     • Solana：Base58，32-44 个字符，无 0x 前缀 → chainId CT_501
  2. 按链对地址分组
  3. 对每个分组调用一次 baw tracker address batch -c <chainId>
  4. 汇总所有链的结果（新增/已存在/覆盖的数量）

实时监控（WebSocket）

用户意图	命令
实时 Smart Money 买入/卖出信号	tracker ws --smy --duration 15
实时查看某条链上的 KOL 活动	tracker ws --kol -c <chainId> --duration 15
链级别钱包活动（多链）	tracker ws --wallet BSC,SOL --duration 15
监控特定地址的交易	tracker ws --address <addr> -c <chainId> --duration 15
批量监控地址（文件）	tracker ws --address-list <file> -c <chainId> --duration 15
监控我关注的地址的活动	tracker ws --following -c <chainId> --duration 15

tracker ws 订阅 WSP WebSocket 推送事件。它会实时流式传输所选范围内的交易数据（买入、卖出、价格变动）。在 --json 模式下，只有推送消息会写入 stdout（不包含元信息），便于通过 | jq 进行管道处理。

除非用户明确要求无限期流式传输，否则必须指定 --duration。 如果用户的指令中包含时长，请据此提取（例如，“监控 60 秒” → --duration 60）。如果未指定时长，默认使用 --duration 15。

--following 提示：当关注地址列表较大时，CLI 可能会回退到更广泛的链级流。如果用户只想查看其关注地址的事件，请将推送消息中的 address 与关注列表进行比对来筛选（tracker follow -c <chainId> --json）。

限制

• 代币价格变动：token/query 可能无法可靠地返回所有代币的 priceChangeRate。如需可靠的价格数据，请使用 marketCap + 风险 + 先驱者时机作为参考指标。
• 时间窗口筛选：token/query 有一个 period 参数（1m/5m/1h/4h/24h），但更精细的时间窗口查询（例如“过去 4h”）依赖客户端对 tx/query 的 ts 字段进行聚合。
• A4 关注列表只读：tracker follow 只查询当前用户自己的关注列表。关注/取消关注的写入操作使用 address follow/unfollow 命令（B2）。

9 种分析场景（A3）

适用于 tracker tx query 数据的内置分析模式。完整规则和算法：references/analytics.md

场景	检测规则
节奏	按地址统计次数/买入/卖出/mean_usd/活跃时段
异常	txUsdValue > 3×mean 且 > 500
共同买入	同一 ca 在 10 分钟窗口内有 ≥3 位买家
往返交易	同一地址对同一 ca 的买入→卖出间隔 < 1h
轮动	不同时间窗口中的代币 top 差异
先行者	最早买入 ca 的买家
领跑者-跟随者	首位先行者之后的延迟中位数
重新活跃	间隔 >72h 后出现新的活动
类似机器人	间隔方差低 + 夜间比例高 + 金额离散度低

错误代码

错误代码仅供内部查询使用，绝不可向用户显示数字代码或内部名称。请将其转换为自然语言消息。

代码	内部名称	面向用户的消息
70001001	TRACKER_API_ERROR	查询失败，请稍后重试
70002001	TRACKER_GROUP_NOT_FOUND	未找到群组
70002002	TRACKER_GROUP_EXISTS	群组已存在
70002003	TRACKER_GROUP_LIMIT	已达到群组数量上限
70003001	TRACKER_ADDRESS_NOT_FOUND	未找到地址
70003002	TRACKER_ADDRESS_EXISTS	地址已存在
70003003	TRACKER_ADDRESS_INVALID	地址格式无效

显示模板

共识代币：

📊 Consensus Tokens Top 5
{tokenName} | Consensus: {consensusCount} | Net Inflow: ${netInflow} | Accumulation: {countBuy} | Distribution: {countSell} | Liquidity: {volume} | Risk: {riskLevel}

交易流条目：

{ts} | {label} | {tradeSideLabel} {tokenName} | ${txUsdValue} | Price: {tokenPrice} → {currentPrice}

群组信息：

{groupName} ({addressCount}addresses)

面向用户的呈现

此技能面向终端用户，而非开发者。面向用户的输出中绝不能出现内部字段名、错误代码和 CLI 内部细节。

1. 术语映射（内部值 → 面向用户的术语）

内部值	面向用户的术语	备注
tradeSideCategory: 11	首次买入
tradeSideCategory: 19	买入
tradeSideCategory: 21	清仓
tradeSideCategory: 29	卖出
tradeSideCategory: other	未知交易类型	可能包含未记录的值
tokenRiskLevel: 0-2	低风险
tokenRiskLevel: 3-5	高风险	≥3 即为高风险
groupId	（省略）	面向用户的输出中绝不显示
displayOrder	（省略）	面向用户的输出中绝不显示
ca（显示时）	（除非用户要求，否则省略）	使用 {tokenName} 作为主要标识
address（显示时）	{label}	使用标签，不使用原始地址

原始枚举值（19、11 等）可以出现在 CLI 语法示例和内部查询表中，但绝不能出现在面向用户的回复中。

2. 绝不暴露内部标识符

• groupId、displayOrder — 内部 ID，绝不向用户显示
• 错误代码（70001001 等）— 仅翻译为自然语言提示
• 后端行为细节（例如，大小写不匹配时删除操作会静默失败、预设保存后未持久化）— 绝不提及“后端 bug”或“静默失败”；通过回读妥善处理

3. 显示模板规范

所有输出中都使用面向用户的术语。tradeSideCategory 字段应转换为对应的显示术语（买入、卖出等），绝不显示原始数值。tokenRiskLevel 应显示为低风险/高风险，而非数字。显示模板中不应出现 groupId 和 displayOrder。

完整 CLI 参考

• references/cli.md — 所有命令及其参数表、返回字段表和示例
• references/analytics.md — 9 种分析场景及其检测规则和算法