crypto-market-rank

Crypto Market Rank 技能

概述

五个排行榜/排名端点，统一通过一个CLI调用。代理发出子命令并附带JSON数据；CLI负责URL路径、方法选择、查询字符串构建以及上游错误映射。

何时使用此技能

用户意图	命令
社交热度排行榜，社交讨论度最高且带情绪摘要的代币	social-hype
统一代币排名，趋势/热搜/Alpha/股票代币列表（可筛选）	token-rank
聪明钱流入排名，当前聪明钱净流入最多的代币	smart-money-inflow
Meme代币排名，Pulse发射台上按突破分数排名的热门Meme代币	meme-rank
地址盈亏排名，顶级交易员盈亏排行榜（ALL/KOL）	address-pnl-rank

支持的链

链	chainId	支持的命令
BSC	56	social-hype, token-rank, smart-money-inflow, meme-rank, address-pnl-rank
Solana	CT_501	social-hype, token-rank, smart-money-inflow, address-pnl-rank
Base	8453	social-hype, token-rank, smart-money-inflow, address-pnl-rank
Ethereum	1	token-rank, address-pnl-rank

meme-rank 仅支持 BSC（56）。CLI 会在调用API前拒绝不支持的 chainId 并报错。

如何调用API

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

命令

命令	用途	必需参数	示例
social-hype	社交热度排行榜，带情绪和摘要	chainId, targetLanguage, timeRange	node <skill-dir>/scripts/cli.mjs social-hype '{"chainId":"56","targetLanguage":"en","timeRange":1}'
token-rank	统一排名（趋势/热搜/Alpha/股票）带筛选	rankType, chainId	node <skill-dir>/scripts/cli.mjs token-rank '{"rankType":10,"chainId":"56","page":1,"size":20}'
smart-money-inflow	按聪明钱净流入排名代币	chainId（CLI默认tagType为2）	node <skill-dir>/scripts/cli.mjs smart-money-inflow '{"chainId":"56","period":"24h"}'
meme-rank	Pulse发射台前100名Meme代币按突破分数排名	chainId	node <skill-dir>/scripts/cli.mjs meme-rank '{"chainId":"56"}'
address-pnl-rank	顶级交易员盈亏排行榜	chainId, period, tag	node <skill-dir>/scripts/cli.mjs address-pnl-rank '{"chainId":"CT_501","period":"30d","tag":"ALL","pageNo":1,"pageSize":25}'

使用流程

在调用任何API之前，你必须阅读其参考文件以获取完整命令、参数、示例和响应字段。

1. 选择命令 — 将用户意图与上方的“何时使用”列匹配
   • 对于 token-rank，还需决定 rankType：10=趋势, 11=热搜, 20=Alpha, 40=股票，参见下方规则
2. 设置链 — 从支持的链中选择 chainId；省略则代表所有链（仅 token-rank 支持）
3. 设置时间窗口（如适用）
   • social-hype：timeRange=1（24小时）
   • token-rank period：10=1分钟, 20=5分钟, 30=1小时, 40=4小时, 50=24小时（默认50）
   • smart-money-inflow period：5m / 1h / 4h / 24h（默认24h）
   • address-pnl-rank period：7d / 30d / 90d（默认30d）
4. 设置筛选条件 — 如果用户提到特定条件（市值、成交量、持有者数量、盈亏、胜率等），请阅读参考文件了解筛选参数
5. 阅读参考 — 打开对应的参考文件，查看命令、完整参数、示例和响应字段
6. 调用CLI — 运行 scripts 文件夹中的 cli.mjs

规则

• token-rank 的 rankType 枚举：10=趋势, 11=热搜, 20=Alpha, 40=股票。
  • 趋势（10）是默认值。 对于任何通用的“热门/趋势/流行/火”请求都使用它——这是用户99%情况下所指的榜单。
  • 热搜（11）需要明确的信号。 只有当用户说“热搜”、“top search”、“most searched”、“搜索榜”，或以其他方式明确表示他们想要基于搜索次数的列表（而非价格/成交量驱动）时，才选择它。按搜索次数排序（sortBy: 2）仅对热搜有意义。
  • 当有歧义时，使用趋势。不要默默切换到热搜。
• smart-money-inflow 的 tagType 默认值：CLI 自动填充 tagType: 2（上游要求该参数，且 2 是目前唯一支持的值）。调用者无需传递；如果传递，调用者的值会覆盖默认值。
• period 值因命令而异：social-hype.timeRange 是数字（1=24小时）；token-rank.period 是代码（10=1分钟, 20=5分钟, 30=1小时, 40=4小时, 50=24小时）；smart-money-inflow.period 是字符串（5m/1h/4h/24h）；address-pnl-rank.period 是字符串（7d/30d/90d）。详见 references/cli.md。
• token-rank 支持丰富的筛选条件（最小/最大值对：marketCap, volume, liquidity, holders, percentChange 等）。将它们作为 JSON 体的顶层字段传递——CLI 会原样转发。
• 图标/Logo URL 前缀：大多数 icon / logo / metaInfo.logo / tokenIconUrl 字段是相对路径。需要加上 https://bin.bnbstatic.com 才能正确显示。chainLogoUrl 已经是完整 URL。
• 数字字段以字符串形式返回（price, marketCap, percentChange* 等）——进行算术运算前需转换。
• address-pnl-rank.pageSize 上限为 25——更大的值会被静默截断。
• 所有时间戳单位为毫秒。

完整CLI参考

参见 references/cli.md 获取每个子命令的调用方式、参数表、返回字段表、排序选项和筛选条件表，以及真实的响应示例。