crypto-market-rank

Crypto Market Rank Skill

概述

五個排行榜/排名端點，由一個 CLI 統一管理。代理發出子命令並附帶 JSON 資料；CLI 負責 URL 路徑、方法選擇、查詢字串建構以及上游錯誤對應。

何時使用此技能

用戶意圖	命令
社交熱度排行榜，具有最高社交討論度及情緒摘要的代幣	social-hype
統一代幣排名，趨勢/熱搜/Alpha/股票代幣列表（可篩選）	token-rank
聰明錢流入排名，目前獲得最多聰明錢淨流入的代幣	smart-money-inflow
迷因代幣排名，來自 Pulse 發射台的頂級迷因代幣（突破分數）	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 名迷因代幣，按突破分數排序	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 會原樣轉發主體。
• 圖示/標誌 URL 前綴：大多數 icon / logo / metaInfo.logo / tokenIconUrl 欄位為相對路徑。請在前面加上 https://bin.bnbstatic.com 以正確顯示。chainLogoUrl 已是完整 URL。
• 數值欄位以字串形式提供（price, marketCap, percentChange* 等）— 在進行算術運算前請先轉換。
• address-pnl-rank.pageSize 上限為 25 — 較大的值會被靜默限制。
• 所有時間戳記均為毫秒。

完整 CLI 參考

請參閱 references/cli.md 以了解每個子命令的呼叫方式、參數表格、回傳欄位表格、排序選項與篩選表格，以及實際回應範例。