Crypto Market Rank

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.

crypto-market-rank — CLI Reference

Complete reference for every command in scripts/cli.mjs.

Invocation pattern: node <skill-dir>/scripts/cli.mjs <command> '<json_params>' Exit codes: 0 success · 1 usage/upstream error · 3 network failure

Supported chains: BSC (56), Base (8453), Solana (CT_501). Per-command restrictions noted below.

---

social-hype — Social buzz leaderboard

node <skill-dir>/scripts/cli.mjs social-hype '{"chainId":"56","targetLanguage":"en","timeRange":1}'

Parameters

Return fields (under .data.leaderBoardList[])

Nested shape: each entry is {metaInfo, marketInfo, socialHypeInfo} — fields grouped by the three objects above.

---

token-rank — Unified token rank (POST)

⚠️ rankType determines the list: 10=Trending · 11=TopSearch · 20=Alpha · 40=Stock.

node <skill-dir>/scripts/cli.mjs token-rank '{"rankType":10,"chainId":"56","page":1,"size":20}'

Parameters (all optional; body is a JSON object)

Core:

Min/Max filters (decimal unless noted): percentChange · marketCap · volume · liquidity · holders (long) · holdersTop10Percent · kycHolders (long, Alpha only) · count (long) · uniqueTrader (long) · launchTime (long, ms).

Advanced filters: keywords / excludes (string[]) · socials (int[]: 0=at_least_one, 1=X, 2=Telegram, 3=Website) · alphaTagFilter (string[]) · auditFilter (int[]: 0=not_renounced, 1=freezable, 2=mintable) · tagFilter (int[]: 0=hide_alpha, 23=dex_paid, 29=alpha_points, …).

Sort Options (`sortBy`): 0=Default · 1=Web default · 2=Search count · 10=Launch time · 20=Liquidity · 30=Holders · 40=Market cap · 50=Price change · 60=Tx count · 70=Volume · 80=KYC holders · 90=Price · 100=Unique traders.

Return fields (under .data.tokens[])

.data.total / .data.page / .data.size provide pagination context.

---

smart-money-inflow — Smart money net inflow rank (POST)

⚠️ BSC (`56`) and Solana (`CT_501`) only.

⚠️ tagType defaults to 2 (the CLI injects it automatically if omitted — always the correct value).

node <skill-dir>/scripts/cli.mjs smart-money-inflow '{"chainId":"56","period":"24h"}'

Parameters

Return fields (under .data[])

---

meme-rank — Top meme tokens from Pulse launchpad

⚠️ BSC (`56`) only. Returns top 100 meme tokens launched via Pulse, scored and ranked by a breakout-potential algorithm.

node <skill-dir>/scripts/cli.mjs meme-rank '{"chainId":"56"}'

Parameters

Return fields (under .data.tokens[])

---

address-pnl-rank — Top trader PnL leaderboard

⚠️ Chain support: "56" (BSC), "CT_501" (Solana).

⚠️ `period` accepted values: "7d" / "30d" / "90d".

⚠️ pageSize max = 25.

node <skill-dir>/scripts/cli.mjs address-pnl-rank '{"chainId":"CT_501","period":"30d","tag":"ALL","pageNo":1,"pageSize":25}'

Parameters

Min/Max filters: PNL (decimal) · winRate (decimal, e.g. 1 = 1%) · tx (long) · volume (decimal).

Return fields (under .data.data[])

Pagination: .data.current / .data.size / .data.pages. dailyPNL[] entries are {realizedPnl, dt}. topEarningTokens[] entries are {tokenAddress, tokenSymbol, tokenUrl, realizedPnl, profitRate}.

---

Errors

Exit codes: 0 ok · 1 upstream/usage (stderr: reason; stdout: body with business code) · 3 network. Business code: 000000 ok · 100004 rate-limited · 100002 bad param · 000400 token not found / unsupported chain.

---

Notes

• Icon URL prefix: https://bin.bnbstatic.com + icon/logo/tokenIconUrl.
• Most price / volume / market-cap fields are string-encoded decimals — parse before arithmetic.