Index of every page on this site: llms.txt
All skills
binance avatar

/binance-leaderboard

@7d1b1f7
by binancebinance/binance-skills-hub1.2k stars
281
Run it yourself

On-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/pnl/follow_friendly) plus AI archetype overlay. Query Gem Hunter to find wallets holding specific tokens. Save and load preset filter conditions and Gem Hunter configs. Trigger whenever the user mentions leaderboard, top traders, wallet analysis, Address Analysis, AddressScore, Gem Hunter, or wants to evaluate a wallet's trading quality — even if they don't say "leaderboard" explicitly.

Use this Skill: https://skilld.dev/gh/binance/binance-skills-hub/binance-leaderboard

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescli.md

≈2.1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

binance-leaderboard — CLI Reference

Complete reference for all baw leaderboard subcommands.

Invocation pattern: baw leaderboard <subcommand> [options] --json Auth: query requires no auth. All other subcommands (alpha-radar, preset, alpha-radar-config) require agentSessionId (set by baw CLI automatically).


leaderboard query — Leaderboard Query

Public endpoint, no auth required.

baw leaderboard query -c 56 --period 7d --tag ALL --json
baw leaderboard query -c CT_501 --period 30d --tag KOL \
  --sort-by 20 --page 0 --size 20 --json

Parameters

Param Type Required Default Description
-c, --chain-id string yes — 56 (BSC) · CT_501 (Solana) · 8453 (Base) · 1 (ETH)
-p, --period enum no 30d 7d / 30d / 90d
-t, --tag enum no ALL ALL / KOL / MPC
--sort-by int no 0 0=PnL · 20=Win Rate · 30=Total Volume · 50=Trade Count · 60=Recent Activity · 70=Profit Rate · 80=Token Count
--order-by int no 0 0/2=Descending · 1=Ascending
--page int no 0 Page number (from 0)
--size int no 20 Page size (max 20)

Return Fields

Field Type Description
address string Wallet address
addressLogo string Address avatar URL
addressLabel string Address label (KOL / Smart Money etc.)
addressTwitterUrl string Twitter profile URL
balance string Current balance
tags string[] Address tags (smart money, kol, etc.)
realizedPnl string Realized PnL (USD)
realizedPnlPercent string Realized PnL percentage
dailyPNL array Daily PnL list: [{dt: "yyyy-MM-dd", realizedPnl: ...}]
winRate number Win rate (0-100)
totalVolume string Total trading volume (USD)
buyVolume string Buy volume (USD)
sellVolume string Sell volume (USD)
avgBuyVolume string Average buy volume (USD)
totalTxCnt number Total transaction count
buyTxCnt number Buy transaction count
sellTxCnt number Sell transaction count
totalTradedTokens number Number of distinct tokens traded
tokenDistribution object Token PnL distribution: {gt500Cnt, between0And500Cnt, between0AndNegative50Cnt, ltNegative50Cnt}
lastActivity number Last activity timestamp (ms)
genericAddressTagList array Generic address tags
topEarningTokens array Top earning tokens: [{tokenAddress, tokenSymbol, tokenUrl, realizedPnl, profitRate}]

Pagination

Response: { data: [...], current: pageNo, size: pageSize, pages: totalPages }. pageNo starts from 0. pageSize max is 20.


leaderboard analyze — Single Address Analysis

Evaluates a single wallet address using the 6-dimension scoring model + AI overlay.

baw leaderboard analyze -c 56 -a 0xabc... --json

Parameters

Param Type Required Default Description
-c, --chain-id string yes — Chain ID
-a, --address string yes — Wallet address to analyze
-p, --period enum no 30d 7d / 30d / 90d

Flow

  1. Query leaderboard top 250 entries (internally calls query with appropriate pagination)
  2. Reverse-lookup the target address in the results
  3. If found: compute 6-dimension scores + AI overlay → output rating
  4. If not found: return "250 beyond top" (beyond top 250)

Return Fields

Field Type Description
address string Analyzed address
found boolean Whether address was in top 250
scores object Per-dimension scores: {winrate, stability, drawdown, tags, pnl, follow_friendly}
totalScore number Sum of 6 dimensions (0-100)
archetype string AI archetype: sniper / swing / accumulator / farmer / mixed
behaviorFlags string[] AI behavior flags
aiAdjustment number AI adjustment (±10)
aiReason string AI adjustment reason (required for audit)
finalScore number totalScore + aiAdjustment
rating string ⭐⭐⭐ / ⭐⭐ / ⭐ / ❌

Rating Thresholds

Rating Score
⭐⭐⭐ ≥ 80
⭐⭐ ≥ 65
⭐ ≥ 50
❌ < 50

Full scoring details: scoring.md


leaderboard alpha-radar — Gem Hunter Query

Private endpoint, requires agentSessionId. Finds wallets that hold specific tokens.

baw leaderboard alpha-radar -c 56 \
  -t 0xtoken1,0xtoken2 \
  -m 1 --json

Parameters

Param Type Required Description
-c, --chain-id string yes Chain ID
-t, --tokens string yes Comma-separated token addresses
-m, --match-count int yes Minimum match count (≥ 1)
-p, --period string no 7d / 30d / 90d (default: 30d)
--page int no Page number, from 0 (default: 0)
--size int no Page size, max 20 (default: 20)

Return Fields

Same fields as leaderboard query, but topEarningTokens replaced by:

Field Type Description
marchedTokens array Matched tokens from the query list. Fields: [{tokenAddress, tokenSymbol, tokenUrl, realizedPnl, profitRate}]

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


leaderboard preset save — Save Preset Filters

Private endpoint. Saves or clears preset filter conditions.

# Save presets (note: PNL fields use uppercase PNLMin/PNLMax, others are camelCase)
baw leaderboard preset save \
  --config '[{"name":"MyPreset","period":"7d","PNLMin":10000,"winRateMin":50,"volumeMin":10000}]' --json

# Clear all presets (pass empty/null)
baw leaderboard preset save --config '[]' --json

Parameters

Param Type Required Description
--config array yes Preset items (JSON array). null or empty = clear all

Preset Fields

Field Type Description
name string Preset name
period string 7d / 30d / 90d
PNLMin / PNLMax number PnL range (USD)
winRateMin / winRateMax number Win rate range (0-100)
txMin / txMax number Trade count range
volumeMin / volumeMax number Volume range (USD)

leaderboard preset list — List Preset Filters

Private endpoint. Returns all saved presets.

baw leaderboard preset list --json

Parameters

None.

Return Fields

Returns an array of preset objects (same fields as save).


leaderboard alpha-radar-config save — Save Gem Hunter Config

Private endpoint. Saves or clears Gem Hunter configs.

baw leaderboard alpha-radar-config save -c 56 \
  --config '[{"uuid":"u1","name":"MyRadar","matchTokenCount":2,
    "tokenAddressList":[{"tokenAddress":"0xabc","tokenSymbol":"USDT"}]}]' --json

# Clear all configs
baw leaderboard alpha-radar-config save -c 56 --config '[]' --json

Parameters

Param Type Required Description
-c, --chain-id string yes Chain ID
--config array yes Config items (JSON array). null or empty = clear all

Config Fields

Field Type Description
uuid string Config UUID
name string Config name
matchTokenCount int Minimum match count
tokenAddressList array Token list (objects, NOT strings)

Token Fields

Field Type Description
tokenAddress string Token contract address (required)
tokenSymbol string Token symbol (optional)
tokenUrl string Token icon URL (optional)

leaderboard alpha-radar-config list — List Gem Hunter Config

Private endpoint. Returns all saved configs for a chain.

baw leaderboard alpha-radar-config list -c 56 --json

Parameters

Param Type Required Description
-c, --chain-id string yes Chain ID

Return Fields

Returns an array of config objects (same fields as save).

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts4mo3 checks · Risk SAFE
  • Gen Agent Trust Hub4mo

    The binance-leaderboard skill allows users to analyze on-chain wallet performance and query leaderboard rankings using the official Binance Agentic Wallet (baw) CLI. The skill operates within the Binance Web3 ecosystem, utilizing the vendor's official npm package for all blockchain interactions and data retrieval. No security issues or malicious patterns were identified in the analysis.

  • Socket4mo

    No alerts

  • Snyk4mo

    Risk: LOW · No issues

Signed by skilld at 7d1b1f7. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago
Other metadata
metadata
{
  "author": "binance-web3-team",
  "version": "1.1",
  "openclaw": {
    "requires": {
      "bins": [
        "baw"
      ]
    },
    "install": [
      {
        "kind": "node",
        "package": "@binance/agentic-wallet",
        "bins": [
          "baw"
        ],
        "label": "Install Binance Agentic Wallet CLI (npm)"
      }
    ]
  }
}

README badge

README badge for binance/binance-skills-hub/binance-leaderboard