binance/binance-leaderboard

Binance Leaderboard Skill

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.

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

| User intent | Command | |-------------|---------| | Query top traders by PnL/win rate/volume | baw leaderboard query | | Analyze a single wallet address (6-dim score + AI archetype) | baw leaderboard analyze | | Find wallets holding specific tokens (Gem Hunter) | baw leaderboard alpha-radar | | Save/load preset filter conditions | baw leaderboard preset save/list | | Save/load Gem Hunter configs | baw leaderboard alpha-radar-config save/list |

Supported Chains

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

Command Tree

baw leaderboard
  query                     # Leaderboard query (Public, no auth)
  analyze                   # Single address analysis (6-dim score + AI overlay)
  alpha-radar              # Gem Hunter query (Private, agentSessionId)
  preset
    save                    # Save preset filters (Private)
    list                    # List preset filters (Private)
  alpha-radar-config
    save                    # Save Gem Hunter config (Private)
    list                    # List Gem Hunter config (Private)

All commands support --json for structured output.

Leaderboard Query

# Basic query — top 20 by PnL on BSC, 7d period
baw leaderboard query -c 56 -p 7d -t ALL --json

# Sort by win rate, KOL tag only
baw leaderboard query -c 56 -p 30d -t KOL --sort-by 20 --json

# Pagination (page from 0, size max 20)
baw leaderboard query -c 56 -p 7d --page 0 --size 20 --json

Public endpoint — no auth required. Returns per-address PnL, win rate, volume, trade count, token distribution, daily PNL, and top earning tokens.

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

Full parameter and return field reference: references/cli.md

Single Address Analyze

# Analyze a wallet address — 6-dim scoring + AI archetype
# Default scans top 1000 entries
baw leaderboard analyze -c 56 -a 0xabc... --json

# Scan more entries (up to 5000) for long-tail addresses
baw leaderboard analyze -c 56 -a 0xabc... --top-n 5000 --json

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

Flow: Query leaderboard top 1000 (configurable via --top-n) → reverse-lookup the target address → compute scores → apply AI overlay → output rating.

Rating: ⭐⭐⭐ ≥ 80 · ⭐⭐ ≥ 65 · ⭐ ≥ 50 · ❌ < 50

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.

Full scoring model details: references/scoring.md

Gem Hunter

# Find wallets holding specific tokens
baw leaderboard alpha-radar -c 56 \
  -t 0xtoken1,0xtoken2 \
  -m 1 --json

Private endpoint — requires agentSessionId. Extra required params: -t/--tokens (comma-separated token addresses), -m/--match-count (≥ 1). Supports -p/--period, --page, --size like query.

Returns records with the same fields as leaderboard query, but topEarningTokens replaced by marchedTokens (matched tokens).

Note: The field is spelled marchedTokens (not "matched") in the CLI output.

Preset & Gem Hunter Config

# Save preset filter conditions (pass null/empty to clear all)
baw leaderboard preset save --config '[{"name":"MyPreset","period":"7d","winRateMin":50}]' --json

# List saved presets
baw leaderboard preset list --json

# Save Gem Hunter config (pass null/empty to clear)
baw leaderboard alpha-radar-config save -c 56 \
  --config '[{"uuid":"u1","name":"MyRadar","matchTokenCount":2,"tokenAddressList":[{"tokenAddress":"0xabc"}]}]' --json

# List saved configs
baw leaderboard alpha-radar-config list -c 56 --json

Core Rules

Scoring Model Overview

6-dimension model (total 100) + AI overlay (±10). Dimensions: winrate (25), stability (20), drawdown (20), tags (15), pnl (10), follow_friendly (10). Full tiered scoring tables and AI overlay rules: references/scoring.md.

Top-N Reverse Lookup

analyze queries the leaderboard's top 1000 entries (configurable via --top-n, max 5000) and reverse-looks-up the target address. If not found, returns "N beyond top" — inform the user they can increase --top-n or use binance-wallet-tracker's address list for long-tail wallets.

Preset & Config Clearing

Passing null or empty array to preset save or alpha-radar-config save clears all saved items.

Cross-Skill Scenarios

Some scenarios require both leaderboard and wallet-tracker skills:

• evaluate follow list: Use binance-wallet-tracker's tracker follow to get the user's followed addresses, then leaderboard analyze each one.
• leaderboard diff: Query leaderboard top N, then diff against binance-wallet-tracker's address list to find untracked wallets.
• batch import: Query leaderboard with filters → output address list → feed to binance-wallet-tracker's address batch command.

Write-Back Confirmation

After preset/config save operations, re-fetch via list to confirm the operation succeeded — don't assume success from the API response alone. If readback shows the saved data is missing, tell the user "Save may not have taken effect, please try again later" — never mention backend bugs or silent failures.

User-Facing Presentation

This skill serves end users, not developers. Internal field names, error codes, and CLI internals must never appear in user-facing output.

1. Term Mapping (internal → user-facing)

| Internal value | User-facing term | Notes | |----------------|-------------------|-------| | archetype: sniper | Sniper | | | archetype: swing | Swing Trader | | | archetype: accumulator | Accumulator | | | archetype: farmer | Farmer | | | archetype: mixed | Mixed | | | sort-by: 0 | Sort by PnL | | | sort-by: 20 | Sort by Win Rate | | | sort-by: 30 | Sort by Total Volume | | | sort-by: 50 | Sort by Trade Count | | | sort-by: 60 | Sort by Recent Activity | | | sort-by: 70 | Sort by Profit Rate | | | sort-by: 80 | Sort by Token Count | | | address (in display) | omit | Don't show raw address unless user asks; use {addressLabel} | | finalScore | Score | Don't show the formula totalScore + aiAdjustment |

Raw enum values (sniper, swing, etc.) may appear in CLI syntax examples and internal lookup tables, but never in user-facing replies.

2. Never expose internal identifiers

• groupId, displayOrder — internal IDs, never shown to users
• Error codes (70001001, etc.) — translate to natural-language messages only
• Backend behavior details (e.g. preset save returning data: true without persisting) — never mention "backend bug" or "silent failure"

3. Display template hygiene

Use user-facing terms in all output. The archetype field should be translated to its Chinese term (Sniper, Swing Trader, etc.) — never show the raw English enum value. Score should be shown as a number, not as a formula.

Error Codes

Error codes are for internal lookup only — never show numeric codes or internal names to users. Translate to natural-language messages.

| Code | Internal Name | User-Facing Message | |------|---------------|---------------------| | 70001001 | TRACKER_API_ERROR | Query failed, please try again later | | 70004001 | TRACKER_LEADERBOARD_EMPTY | Leaderboard data is empty | | 70004002 | TRACKER_ADDRESS_NOT_RANKED | Address not ranked (beyond top 250) |

Display Templates

Leaderboard entry:

{addressLabel} | PnL: {realizedPnl} ({realizedPnlPercent}%) | Win Rate: {winRate}% | Trades: {totalTxCnt} | Tokens: {totalTradedTokens}

Address analysis rating:

📊 {addressLabel} Address Analysis

Rating: ⭐⭐⭐ (85/100)
Trading Style: Sniper
Behavior Patterns: High Frequency Small Amount, Nocturnal Active

Dimension Scores:
  Win Rate: 22/25 | Stability: 18/20 | Drawdown: 16/20
  Tags: 15/15 | PnL: 8/10 | Trackability: 6/10

AI Adjustment: +5 (consistent trading style, stable pattern)

Full CLI Reference

• references/cli.md — All commands with parameter tables, return field tables, and examples
• references/scoring.md — 6-dimension scoring model, AI overlay, rating standards