/binance-wallet-tracker

name: binance-wallet-tracker
description: |
  Wallet tracking and monitoring on Binance Web3. Monitor token/trade activity for private groups
  or public Smart Money/KOL data. Four domains: (A) Discovery — consensus, pioneer,
  leaderboard diff, token buyer lookup, time-window summaries, similar wallets; (B) Evaluation —
  token risk (tokenRiskLevel ≥ 3), group rhythm, follow list assessment, token heat; (C) Replay —
  4h summary, Accumulation/Distribution, sector rotation, anomaly orders, round-trip, first-mover/leader-follower,
  wake-up, bot-like; (D) Management — group create/rename, batch import, label update, link, follow list;
  (E) Real-time — WebSocket push for Smart Money, KOL, wallet-level, and address-level trade events.
  Trigger on: wallet tracker, monitoring, consensus, pioneer, accumulation, Distribution, Sector Rotation, Anomaly Large Order,
  round-trip, first-mover, wake-up, bot-like, token risk, token heat, group profile, similar wallets,
  group management, address import, follow list, real-time push, WebSocket — even without "tracker" explicitly.
metadata:
  author: binance-web3-team
  version: "1.3"
  requiredCliVersion: '1.9.1'
  openclaw:
    requires:
      bins:
        - baw
    install:
      - kind: node
        package: '@binance/agentic-wallet'
        bins: [baw]
        label: Install Binance Agentic Wallet CLI (npm)

Binance Wallet Tracker Skill

On-chain wallet tracking and monitoring. Monitor token-level and trade-level activity for private groups or public Smart Money / KOL data. Includes 9 built-in analysis scenarios for replay and pattern detection.

Prerequisites

This skill requires the `baw` CLI (`@binance/agentic-wallet` npm package). If `baw` is not found:

npm install -g @binance/agentic-wallet

Verify: `baw --version` should print `1.6.2` or higher. If installation fails or the user doesn't have Node.js, inform them that Node.js >= 18 is required.

When to Use

Discovery

| User intent | Command | |-------------|---------| | Consensus tokens (many buyers) | `tracker token query` → sort by `consensusCount` | | Pioneer tokens (≤2 traders) | `tracker token query` → filter `launchTime` + `consensusCount ≤ 2` | | Leaderboard diff (untracked wallets) | `leaderboard query` (leaderboard skill) + `tracker address list` → diff | | Token-based buyer lookup | `tracker tx query` → client-side filter by `ca` | | Time-window summary | `tracker token query --period 4h` + `tracker tx query` | | Similar wallet discovery | `leaderboard analyze` (leaderboard skill) → archetype matching |

Evaluation

| User intent | Command | |-------------|---------| | Token risk screening | `tracker token query` → filter `tokenRiskLevel ≥ 3` + `consensusCount ≥ 3` | | Group rhythm profiling | `tracker tx query` → per-address rhythm analysis | | Follow list assessment | `tracker follow` + `leaderboard analyze` (cross-skill) | | Token heat analysis | `tracker tx query` → aggregate by `ca` |

Replay

| User intent | Command | |-------------|---------| | 4h comprehensive summary | `tracker token query --period 4h` + `tracker tx query` | | Accumulation vs distribution (Accumulation/Distribution) | `tracker token query` → `buyCount`/`sellCount` per address | | Sector rotation | `tracker tx query` → compare token top across time windows | | Anomaly large orders | `tracker tx query` → `anomaly` detection | | Round-trip (Round-Trip) | `tracker tx query` → `round-trip` detection | | First-mover + leader-follower | `tracker tx query` → `first-mover` + `leader-follower` | | Wake-up detection | `tracker tx query` → `wake-up` detection | | Bot-like behavior | `tracker tx query` → `bot-like` detection |

Full 9-scenario analysis rules: [`references/analytics.md`](references/analytics.md)

Management

| User intent | Command | |-------------|---------| | Create / rename group | `tracker group create/update` | | Batch import addresses | `tracker address batch` | | Add single address | `tracker address add` | || Update label / link to group | `tracker address update -l` + `tracker address link` | | Delete addresses | `tracker address delete` | | Follow / unfollow address | `tracker address follow/unfollow` | | View follow list | `tracker follow` | | Search address (fuzzy) | `tracker address search` |

Supported Chains

| Chain | chainId | |-------|---------| | BSC | `56` | | Solana | `CT_501` | | Base | `8453` | | Ethereum | `1` | | Robinhood | `4663` |

This table lists chains verified for tracker use; it is a subset of `baw wallet chains` (which returns all wallet-supported chains, e.g. Arbitrum 42161, Polygon 137). Before treating a chain as unsupported for tracking, probe it first — the wallet chain list is dynamic.

Command Tree

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

All commands support `--json` for structured output.

**`token query` and `tx query` require either `--group-id` (private group) or `--tag-type` (public KOL/SMY). Calling without either returns an error.**

**`--tag-type` acce