query-token-info

查询代币信息技能

概述

四个只读代币端点，通过一个CLI统一访问。代理选择一个子命令并传递一个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了解每个子命令的调用方式、参数表、返回字段表以及实际响应示例。