用途:该技能用于通过 Etherscan 统一 API V2 查询区块链余额,覆盖原生 ETH(或各链原生代币)余额与 ERC-20 代币余额,并支持通过 chainid 参数进行多链查询。范围限定为免费套餐账户的余额查询;交易历史、合约验证、Gas 估算等其他功能需查阅备用文档 https://docs.etherscan.io/llms.txt。
主要能力:原生余额查询使用 module=account、action=balance,支持单地址及最多 20 个逗号分隔地址的 balancemulti 批量查询;ERC-20 余额查询使用 action=tokenbalance,需提供 contractaddress。所有请求统一走 https://api.etherscan.io/v2/api,由 chainid 决定查询哪条链。
使用方式:调用前先校验环境变量 ETHERSCAN_API_KEY 是否设置,缺失则提示用户并停止执行,免费密钥获取地址为 https://etherscan.io/myapikey。不要默认使用以太坊主网,应依据用户提示推断链:显式链名、链专属代币(如 POL→137、ARB→42161、OP→10、AVAX→43114、BNB→56、SONIC→146、SEI→1329、MON→143)、测试网关键词(Sepolia、Holesky、Amoy)等;无法推断时先询问用户。若用户提到 Solana、Bitcoin 等非 EVM 链,应说明 Etherscan API V2 仅支持 EVM 兼容链。
结果处理:API 返回最小单位数值,ETH 需除以 10^18,ERC-20 需除以 10^decimals(多数代币 18,USDC/USDT 为 6,WBTC 为 8),可用 bc 保持精度。默认以 Markdown 表格展示,用户指定 JSON、CSV 等格式时改用其格式。
限制:免费套餐不支持 Base(8453)、OP Mainnet(10)、Avalanche C-Chain(43114)、BNB Smart Chain(56),需付费计划;免费额度为每秒 5 次、每天 100,000 次调用,被限流时稍后重试。常见错误包括无效密钥或限流、地址格式错误、无交易记录。完整支持链列表见 ./references/chains.md。