crypto-market-rank

name: crypto-market-rank description: | Crypto market leaderboards — ranked aggregate feeds across the whole market: social-hype/sentiment rank, trending / top-search / Binance Alpha / tokenized-stocks rank, smart-money net-inflow rank (which tokens received the most inflow), top meme tokens by breakout score on Pulse launchpad, top trader PnL leaderboard (ALL / KOL). Use whenever the user wants a ranked list of tokens or addresses by some metric — phrases like "trending tokens", "top N by hype", "leaderboard", "rank by X", "biggest inflows", "top traders this week". metadata: author: binance-web3-team version: "3.0"

Crypto Market Rank Skill

Overview

Five leaderboard / rank endpoints fronted by one CLI. The agent issues a subcommand with a JSON blob; the CLI owns URL paths, method selection , query-string building, and upstream error mapping.

When to Use This Skill

Supported Chains

meme-rank only supports BSC (56). The CLI rejects unsupported chainIds with an error before calling the API.

How to Call APIs

node <skill-dir>/scripts/cli.mjs token-rank \
  '{"rankType":10,"chainId":"56","period":50,"sortBy":70,"orderAsc":false,"page":1,"size":20}'

Commands

Use Flow

Before calling any API, you MUST read its reference file for the full command, parameters, example, and response fields.

1. Select command — match user intent to the "When to use" column above
   • For token-rank, also decide rankType: 10=Trending, 11=TopSearch, 20=Alpha, 40=Stock, see rules below
2. Set chain — pick chainId from Supported Chains; omit for all chains (token-rank only)
3. Set time window (if applicable)
   • social-hype: timeRange=1 (24h)
   • token-rank period: 10=1m, 20=5m, 30=1h, 40=4h, 50=24h (default 50)
   • smart-money-inflow period: 5m / 1h / 4h / 24h (default 24h)
   • address-pnl-rank period: 7d / 30d / 90d (default 30d)
4. Set filters — if user mentions specific conditions (market cap, volume, holders, PnL, win rate, etc.), read the reference for filter params
5. Read reference — open the corresponding reference file for command, full params, example, and response fields
6. Call cli — run the cli.mjs in scripts folder

Rules

• rankType enum for token-rank: 10=Trending, 11=TopSearch, 20=Alpha, 40=Stock.
  • Trending (10) is the default. Use it for any generic "hot / trending / popular / 热门 / 趋势 / 火" request — this is the board users mean 99% of the time.
  • TopSearch (11) requires an explicit signal. Only pick it when the user says "热搜", "top search", "most searched", "搜索榜", or otherwise makes clear they want the search-count-driven list (not price/volume-driven). Search-count sort (sortBy: 2) only makes sense with TopSearch.
  • When ambiguous, go Trending. Do not silently switch to TopSearch.
• tagType default for smart-money-inflow: the CLI auto-fills tagType: 2 (upstream requires it and 2 is the only supported value today). Callers do not need to pass it; if passed, the caller's value wins.
• period values differ by command: social-hype.timeRange is numeric (1=24h); token-rank.period is a code (10=1m, 20=5m, 30=1h, 40=4h, 50=24h); smart-money-inflow.period is a string (5m/1h/4h/24h); address-pnl-rank.period is a string (7d/30d/90d). See references/cli.md for details.
• token-rank supports rich filters (min/max pairs: marketCap, volume, liquidity, holders, percentChange, etc.). Pass them as flat top-level fields on the JSON body — the CLI forwards the body verbatim.
• Icon / logo URL prefix: most icon / logo / metaInfo.logo / tokenIconUrl fields are relative paths. Prepend https://bin.bnbstatic.com to render. chainLogoUrl is already a full URL.
• Numeric fields arrive as strings (price, marketCap, percentChange*, etc.) — convert before arithmetic.
• address-pnl-rank.pageSize cap is 25 — larger values are silently clamped.
• All timestamps are milliseconds.

Full CLI Reference

See references/cli.md for per-subcommand invocations, parameter tables, return-field tables, sort-option and filter tables, and real response samples.