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

1. Set chain — pick chainId from Supported Chains; omit for all chains (token-rank only)
2. 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)

1. Set filters — if user mentions specific conditions (market cap, volume, holders, PnL, win rate, etc.), read the reference for filter params
2. Read reference — open the corresponding reference file for command, full params, example, and response fields
3. 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.