SuperAPI AI 工具集

query-address-info

数据与分析

查看项目

更新于 10-15 17:26

技能介绍

用途:查询任意链上钱包地址当前持有的代币清单,并附带每个代币的名称、符号、当前价格、24 小时价格变动百分比与持仓数量,属于钱包持仓快照类技能。

支持链与 chainId:BSC 为 56,Solana 为 CT_501,Base 为 8453,Ethereum 为 1。

调用方式:使用 scripts/cli.mjs 的 positions 子命令: node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}' 必填参数为 address、chainId、offset。

使用规则:每次调用都必须带 offset,包括第一页;取第一页传 0,翻页时递增;缺少 offset 会触发上游校验错误。分页时重复调用并递增 offset,直到 data.list 为空或长度小于单页大小为止。

字段处理:icon 是相对路径(如 /images/web3-data/public/token/logos/xxxx.png),渲染时需在前面拼接 https://bin.bnbstatic.com;price、percentChange24h、remainQty 均为字符串,做算术运算前需先转换为数字。

限制:仅为单链、单钱包的持仓查询,资料未说明历史数据、多地址批量查询、鉴权、频率限制或费用信息;更完整的子命令、参数表、返回字段表与响应样例见 references/cli.md。