Token Info 是一个用于跨链查询代币与资产信息的技能,隶属于 trustwallet/tw-agent-skills。它面向需要查找代币、获取资产详情或检查币种状态的场景,支持所有已支持的区块链。
用途 该技能用于按名称、符号或合约地址搜索代币,获取资产的详细元数据与市场数据,并查询某个币种的功能状态与安全信息。
主要能力
- 搜索资产:GET /v1/search/assets,可按名称、符号或合约地址搜索代币,返回匹配代币的元数据、市场数据与验证状态。查询参数包括 query(必填,搜索词)、networks(可选,逗号分隔的 SLIP-44 币种 ID,用于按链过滤,例如 60 表示 Ethereum,60,714 表示 ETH+BSC)、limit(可选,最大结果数,默认 20)。示例请求:GET /v1/search/assets?query=USDC&networks=60。响应包含 total 与 docs 数组,每个代币包含 name、symbol、type、decimals、asset_id、verifiers、icon_url、market_cap、volume_24h、price、tags 等字段。另有 v2/search/assets 端点可返回扩展结果。
- 获取资产详情:GET /v1/assets,可按 assetId 查询特定资产,或按 coin(SLIP-44 币种 ID)列出某条链上的资产。示例请求:GET /v1/assets?assetId=c60。
- 获取币种状态:GET /v1/coinstatus/{assetId},返回币种状态,包括功能开关(是否启用买入、卖出、兑换、跨链兑换、质押、Dapps)、警告消息与安全信息。路径参数 assetId 必填(例如 c60 表示 ETH,c60_t0xA0b8... 表示 ERC-20)。查询参数包括 version(可选,API 版本,如 8.4)、platform(可选,android 或 ios)、include_security_info(可选,是否包含安全分析,默认 false)。示例请求:GET /v1/coinstatus/c60?include_security_info=true。响应包含 asset 信息、isBuyCryptoEnabled、isSellCryptoEnabled、isSwapEnabled、isSwapCrossChainEnabled、isStakeEnabled、isDappsEnabled、messages,以及可选的 security_info(含 is_scanned、contract_security 的 num_risks/num_warnings/is_counterfeit、honeypot_risk 的 num_risks/num_warnings/buy_tax/sell_tax)。另有 v2/coinstatus/{assetId} 变体,额外包含原生代币支付信息。
使用方式 基础 URL 为 https://tws.trustwallet.com,认证方式为 HMAC-SHA256(具体设置参见 setup)。通过上述三个端点发起 HTTP GET 请求即可。
适用场景 适用于需要查找代币、核对资产元数据与市场数据、检查某币种是否支持买入/卖出/兑换/质押,以及评估代币合约安全性与蜜罐风险的场景。
限制 资料未提供 HMAC-SHA256 的具体设置细节、速率限制、错误码说明、支持的链完整列表以及 v2 端点的完整字段说明。