$npx -y skills add binance/binance-skills-hub --skill binance-leaderboardOn-chain wallet leaderboard and Gem Hunter analysis on Binance Web3. Query top trader rankings by PnL, win rate, volume, trade count, or token count across BSC/Solana/Base/ETH. Analyze individual wallet addresses with a 6-dimension scoring model (winrate/stability/drawdown/ tags/
| 1 | # Binance Leaderboard Skill |
| 2 | |
| 3 | On-chain wallet leaderboard ranking and address analysis. Query top traders by PnL, win rate, and more. Evaluate wallet quality with a 6-dimension scoring model. |
| 4 | |
| 5 | ## Prerequisites |
| 6 | |
| 7 | This skill requires the `baw` CLI (`@binance/agentic-wallet` npm package). If `baw` is not found: |
| 8 | |
| 9 | ```bash |
| 10 | npm install -g @binance/agentic-wallet |
| 11 | ``` |
| 12 | |
| 13 | 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. |
| 14 | |
| 15 | ## When to Use |
| 16 | |
| 17 | | User intent | Command | |
| 18 | |-------------|---------| |
| 19 | | Query top traders by PnL/win rate/volume | `baw leaderboard query` | |
| 20 | | Analyze a single wallet address (6-dim score + AI archetype) | `baw leaderboard analyze` | |
| 21 | | Find wallets holding specific tokens (Gem Hunter) | `baw leaderboard alpha-radar` | |
| 22 | | Save/load preset filter conditions | `baw leaderboard preset save/list` | |
| 23 | | Save/load Gem Hunter configs | `baw leaderboard alpha-radar-config save/list` | |
| 24 | |
| 25 | ## Supported Chains |
| 26 | |
| 27 | | Chain | chainId | |
| 28 | |-------|---------| |
| 29 | | BSC | `56` | |
| 30 | | Solana | `CT_501` | |
| 31 | | Base | `8453` | |
| 32 | | Ethereum | `1` | |
| 33 | |
| 34 | ## Command Tree |
| 35 | |
| 36 | ``` |
| 37 | baw leaderboard |
| 38 | query # Leaderboard query (Public, no auth) |
| 39 | analyze # Single address analysis (6-dim score + AI overlay) |
| 40 | alpha-radar # Gem Hunter query (Private, agentSessionId) |
| 41 | preset |
| 42 | save # Save preset filters (Private) |
| 43 | list # List preset filters (Private) |
| 44 | alpha-radar-config |
| 45 | save # Save Gem Hunter config (Private) |
| 46 | list # List Gem Hunter config (Private) |
| 47 | ``` |
| 48 | |
| 49 | All commands support `--json` for structured output. |
| 50 | |
| 51 | ## Leaderboard Query |
| 52 | |
| 53 | ```bash |
| 54 | # Basic query — top 20 by PnL on BSC, 7d period |
| 55 | baw leaderboard query -c 56 -p 7d -t ALL --json |
| 56 | |
| 57 | # Sort by win rate, KOL tag only |
| 58 | baw leaderboard query -c 56 -p 30d -t KOL --sort-by 20 --json |
| 59 | |
| 60 | # Pagination (page from 0, size max 20) |
| 61 | baw leaderboard query -c 56 -p 7d --page 0 --size 20 --json |
| 62 | ``` |
| 63 | |
| 64 | **Public endpoint** — no auth required. Returns per-address PnL, win rate, volume, trade count, token distribution, daily PNL, and top earning tokens. |
| 65 | |
| 66 | Key query parameters: `-c/--chain-id` (required), `-p/--period` (7d/30d/90d), `-t/--tag` (ALL/KOL/MPC), `--sort-by` (0=PnL · 20=Win Rate · 30=Total Volume · 50=Trade Count · 60=Recent Activity · 70=Profit Rate · 80=Token Count), `--order-by` (0/2=Descending · 1=Ascending), `--page` (from 0), `--size` (max 20). |
| 67 | |
| 68 | Full parameter and return field reference: [`references/cli.md`](references/cli.md) |
| 69 | |
| 70 | ## Single Address Analyze |
| 71 | |
| 72 | ```bash |
| 73 | # Analyze a wallet address — 6-dim scoring + AI archetype |
| 74 | # Default scans top 1000 entries |
| 75 | baw leaderboard analyze -c 56 -a 0xabc... --json |
| 76 | |
| 77 | # Scan more entries (up to 5000) for long-tail addresses |
| 78 | baw leaderboard analyze -c 56 -a 0xabc... --top-n 5000 --json |
| 79 | ``` |
| 80 | |
| 81 | Evaluates the address across 6 dimensions (winrate 25 + stability 20 + drawdown 20 + tags 15 + pnl 10 + follow_friendly 10 = 100), then applies an AI overlay (archetype + behavior_flags + ai_adjustment ±10). |
| 82 | |
| 83 | **Flow**: Query leaderboard top 1000 (configurable via `--top-n`) → reverse-lookup the target address → compute scores → apply AI overlay → output rating. |
| 84 | |
| 85 | **Rating**: ⭐⭐⭐ ≥ 80 · ⭐⭐ ≥ 65 · ⭐ ≥ 50 · ❌ < 50 |
| 86 | |
| 87 | If the address is not in the top N (default 1000), returns "N beyond top". Use `--top-n` to increase scan range up to 5000. |
| 88 | |
| 89 | Full scoring model details: [`references/scoring.md`](references/scoring.md) |
| 90 | |
| 91 | ## Gem Hunter |
| 92 | |
| 93 | ```bash |
| 94 | # Find wallets holding specific tokens |
| 95 | baw leaderboard alpha-radar -c 56 \ |
| 96 | -t 0xtoken1,0xtoken2 \ |
| 97 | -m 1 --json |
| 98 | ``` |
| 99 | |
| 100 | **Private endpoint** — requires `agentSessionId`. Extra required params: `-t/--tokens` (comma-separated token addresses), `-m/--match-count` (≥ 1). Supports `-p/--period`, `--page`, `--size` like query. |
| 101 | |
| 102 | Returns records with the same fields as leaderboard query, but `topEarningTokens` replaced by `marchedTokens` (matched tokens). |
| 103 | |
| 104 | **Note**: The |