etherscan-api

用途：通过 Etherscan 统一 API V2 查询区块链账户数据，聚焦免费套餐的只读账户查询。主要能力：查询原生 ETH（或原生代币）余额，支持单地址及最多 20 个逗号分隔地址的批量查询；查询单个 ERC-20 合约的代币余额；查询交易历史，包括普通交易、内部交易以及 ERC-20/ERC-721/ERC-1155 转账事件；通过 chainid 参数支持多链。使用方式：调用前先校验 ETHERSCAN_API_KEY 环境变量是否设置，缺失则提示用户并停止；不要默认以太坊主网，需根据用户提示推断链，无法推断时先询问；所有请求使用统一端点 https://api.etherscan.io/v2/api，以 module=account 配合 action=balance、tokenbalance、txlist、txlistinternal、tokentx、tokennfttx、token1155tx 等参数查询。余额以最小单位返回，ETH 除以 10^18，ERC-20 按代币 decimals 换算；timeStamp 为 Unix 秒，应生成带时区的 UTC 时间。默认以 Markdown 表格展示结果，用户指定格式时改用该格式。限制：免费套餐不支持 Base、OP Mainnet、Avalanche C-Chain、BNB Smart Chain 等链；tokenbalance 一次仅返回一个合约余额，完整持仓需 PRO 端点（Standard 及以上，限速 2 次/秒）；免费套餐限速 3 次/秒、10 万次/天；2026 年 7 月 1 日起免费套餐列表端点 offset 上限由 10000 降至 1000，建议按不超过 1000 分页；tag 仅支持最近 128 个区块，更早历史需 PRO 的 balancehistory。其他未覆盖功能可参考 https://docs.etherscan.io/llms.txt。