query-token-info
熱門針對特定代幣（透過關鍵字、符號或合約地址識別）的詳細資訊： (1) search — 依關鍵字/符號/合約搜尋代幣； (2) meta — 靜態資訊：名稱、符號、標誌、社群連結、創建者、官方網站； (3) dynamic — 即時市場數據：價格、24小時變化、成交量、持有者數量、流動性； (4) kline — OHLCV 蠟燭圖數據，用於技術分析。 適用於：「$X 的價格」、「搜尋 Y 代幣」、「$Z 的 K 線圖」、「誰創建了 $W」、 「$V 的社群連結」、「$U 的持有者數量」、「蠟燭圖數據」、「尋找 <代幣> 的合約地址」。
針對特定代幣（透過關鍵字、符號或合約地址識別）的詳細資訊： (1) search — 依關鍵字/符號/合約搜尋代幣； (2) meta — 靜態資訊：名稱、符號、標誌、社群連結、創建者、官方網站； (3) dynamic — 即時市場數據：價格、24小時變化、成交量、持有者數量、流動性； (4) kline — OHLCV 蠟燭圖數據，用於技術分析。 適用於：「$X 的價格」、「搜尋 Y 代幣」、「$Z 的 K 線圖」、「誰創建了 $W」、 「$V 的社群連結」、「$U 的持有者數量」、「蠟燭圖數據」、「尋找 <代幣> 的合約地址」。
查詢代幣資訊技能
概述
四個唯讀代幣端點，由一個 CLI 統一管理。AI 代理會選擇子命令並傳入 JSON 物件；透過此技能，使用者可以：
搜尋代幣：跨鏈依名稱、符號或合約地址尋找代幣。
代幣研究：取得代幣元數據、社群連結及創建者資訊。
市場分析：即時價格、成交量、持有者分佈及流動性數據。
圖表分析：K 線蠟燭圖數據，用於技術分析。
何時使用此技能
| 使用者意圖 | 命令 |
|---|---|
| 依關鍵字、符號或合約地址搜尋代幣 | search |
| 取得靜態元數據（名稱、符號、標誌、社群連結、創建者） | meta |
| 取得即時市場數據（價格、成交量、持有者、流動性） | dynamic |
| 取得蠟燭圖 / OHLCV 數據 | kline |
支援的鏈
| 鏈 | chainId |
|---|---|
| Ethereum | 1 |
| BSC | 56 |
| Base | 8453 |
| Solana | CT_501 |
所有四個命令（search、meta、dynamic、kline）使用相同的 chainId 值。
如何呼叫 API
node <skill-dir>/scripts/cli.mjs <command> '<json_params>'
範例：
node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'
命令
| 命令 | 用途 | 必要參數 | 範例 |
|---|---|---|---|
search |
依關鍵字搜尋代幣 | keyword（可選：chainIds、orderBy） |
node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"1,56,8453,CT_501"}' |
meta |
靜態代幣元數據 | chainId、contractAddress |
node <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}' |
dynamic |
即時市場數據 | chainId、contractAddress |
node <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}' |
kline |
蠟燭圖數據 | chainId、contractAddress、interval（可選：limit、from、to、pm） |
node <skill-dir>/scripts/cli.mjs kline '{"chainId":"56","contractAddress":"0x...","interval":"1min","limit":500}' |
規則
- 圖示 URL：
icon欄位為相對路徑。請在前面加上https://bin.bnbstatic.com以取得可用 URL。 - 數字以字串形式呈現：所有數值市場欄位（
price、volume24h、marketCap等）皆以字串形式回傳。進行算術運算前請先轉換。 - K 線為二維陣列，非 JSON 物件。每根蠟燭：
[open, high, low, close, volume, timestamp_ms, count]。 - K 線時間範圍：同時提供
limit與from時，limit優先。使用to搭配limit可取得截至to的最新 N 根蠟燭。pm選擇價格（p，預設）或市值（m）序列。 kline支援的時間間隔：1s、1min、3min、5min、15min、30min、1h、2h、4h、6h、8h、12h、1d、3d、1w、1m。
完整 CLI 參考
請參閱 references/cli.md 以取得各子命令的呼叫方式、參數表、回傳欄位表及實際回應範例。
