用途:通过 Etherscan 统一 API V2 读取链上账户数据,属于只读查询技能,涵盖原生 ETH 余额、ERC-20 代币余额(单合约在所有套餐可用,完整持仓仅 PRO)、交易历史(普通、内部、ERC-20/721/1155 转移)以及地址首次资金来源查询。
主要能力:所有请求走统一端点 https://api.etherscan.io/v2/api,用 chainid 指定链。余额查询用 module=account&action=balance,多地址用 balancemulti(最多 20 个);单代币余额用 action=tokenbalance 并传 contractaddress;交易历史用 txlist、txlistinternal、tokentx、tokennfttx、token1155tx。PRO 端点 addresstokenbalance、addresstokennftbalance 可列出全部持仓,fundedby 可查首次资金来源。
必要用法:调用前需设置 ETHERSCAN_API_KEY 环境变量,缺失则报错并停止。应先运行 ./scripts/detect-plan.sh(或调用 getapilimit)检测套餐并缓存,得到 paid_chains 与 pro_endpoints 两个布尔门控。分页 offset 上限:免费账户 1000,付费层级 10000。fundedby 为 PRO 端点且限速 2 次/秒,仅支持 EOA。免费/Lite 查询旧余额需用 balancehistory(Standard+)。
适用场景:查询钱包 ETH 或代币余额、核对代币持仓、追踪转账与 NFT 历史、追溯资金来源。
限制:必须推断链,不能默认以太坊主网;不支持的 EVM 链可回退到公共 RPC,非 EVM 链不支持。getapilimit 自身消耗信用,会话中不要重复调用。价格、套餐费用及其他未在资料中列明的内容暂未提供。