crypto-market-rank

加密货币市场排名技能

概述

通过一个 CLI 提供五个排行榜／排名端点。Agent 提交带有 JSON 数据块的子命令；CLI 负责 URL 路径、方法选择、查询字符串构建以及上游错误映射。

何时使用此技能

用户意图	命令
社交热度排行榜：社交热度最高的代币及情绪摘要	social-hype
统一代币排名：趋势／热门搜索／Alpha／股票代币列表（已筛选）	token-rank
聪明钱流入排名：当前获得最多聪明钱净流入的代币	smart-money-inflow
Meme 代币排名：来自 Pulse launchpad 的热门 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 launchpad 突破评分最高的 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（24h）
   • token-rank period：10=1m、20=5m、30=1h、40=4h、50=24h（默认 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=24h）；token-rank.period 是代码（10=1m，20=5m，30=1h，40=4h，50=24h）；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——超出此值时会被静默限制为 25。
• 所有时间戳均以毫秒为单位。

CLI 完整参考

请参阅 references/cli.md，了解各子命令的调用方式、参数表、返回字段表、排序选项与筛选条件表，以及真实响应示例。