标题：工程警报：处理 Etherscan API 的重大变更（2026 年 7 月）

多年来，Etherscan 一直是以太坊数据索引的支柱。然而，一项重大变化正在到来。自 2026 年 7 月 1 日起，Etherscan 将对其免费层 API 的约束实施重大变更。
如果您的 dApp、索引器或分析工具依赖于 Etherscan，您需要现在就重构数据抓取逻辑，以避免服务中断。
1. 分页“挤压” ：从 1 万到 1 千的记录上限
最关键的更新是每次请求返回的最大记录数下调。对免费层用户而言，该上限将从 10,000 降至 1,000 条记录。
技术影响：
对于高频地址（例如 CEX 热钱包或热门的 DeFi 协议），如果您的偏移量之前曾设置为任意高于 1,000 的值，那么当前标准获取请求将返回不完整的数据集。
受影响的端点：
账户模块：txlist、txlistinternal、tokentx、tokennfttx、token1155tx。
日志与其他：getLogs、getWithdrawals 以及代币持有者列表。
需采取的行动：实施激进的分页策略
您必须重构获取循环。
2. 端点迁移：区块范围内部交易转入 Pro 版
按区块范围获取内部交易的端点将移至 Pro 计划的付费墙之后。
技术影响：
从 2026 年 7 月开始，使用免费层 API 密钥访问该端点的请求将返回 403 Forbidden，或返回特定的层级限制错误。
缓解策略：
升级层级：这是企业级应用最直接的修复方案。
更精细的查询：与其按区块范围查询，您可能需要通过特定的交易哈希（txhash）来获取内部交易；尽管这会显著增加 API 调用次数，但有可能触发速率限制。
3. 管理速率限制（限流 / 节流）
免费层仍然维持每秒 5 次请求（RPS）的限制。由于现在您需要 10 次请求才能获得此前一次请求就能拿到的数据，因此您遇到 429 Too Many Requests 错误的概率将增加 10 倍。
建议：
实现指数退避（Exponential Backoff），或使用请求队列管理器（例如 p-throttle 或 bottleneck），以确保您新的多页抓取逻辑不会导致 API 密钥崩溃。
迁移开发者检查清单：
审计：在代码库中查找所有偏移量 > 1000 的 Etherscan API 调用。
重构：使用 page 参数实现递归或基于循环的分页。
.
标签：#Ethereum #Blockchain #API