crypto-market-rank

Crypto Market Rank スキル

概要

1 つの CLI から 5 つのランキング／順位エンドポイントを呼び出します。エージェントは JSON のデータを渡してサブコマンドを実行します。URL パス、メソッドの選択、クエリ文字列の構築、上流エラーのマッピングは CLI が処理します。

このスキルを使用する場面

ユーザーの意図	コマンド
ソーシャル話題性ランキング。話題性とセンチメントの概要を含む、ソーシャル上の注目度が最も高いトークン	social-hype
統合トークンランキング。トレンド／検索上位／Alpha／株式トークンのリスト（フィルター適用）	token-rank
スマートマネー流入ランキング。現在、スマートマネーの純流入が最も多いトークン	smart-money-inflow
ミームトークンランキング。Pulse ローンチパッドのブレイクアウトスコア上位のミームトークン	meme-rank
アドレス PnL ランキング。トレーダーの損益ランキング上位（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. フィルターを設定する — ユーザーが特定の条件（時価総額、取引量、保有者数、PnL、勝率など）を指定した場合は、フィルターパラメーターをリファレンスで確認します
5. リファレンスを読む — 対応するリファレンスファイルを開き、コマンド、すべてのパラメーター、例、レスポンスフィールドを確認します
6. CLI を呼び出す — scripts フォルダー内の cli.mjs を実行します

ルール

• token-rank の rankType 列挙値：10=トレンド、11=検索上位、20=Alpha、40=Stock。
  • トレンド（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 を参照してください。