Etherscan

简介

Etherscan 的 API 提供以太坊区块链数据——余额、交易、代币、合约、Gas 价格和日志。它为无数浏览器小组件和分析面板提供支撑。

⚠️ 破坏性变更（2026-08 实测）：旧版 V1 端点已弃用——请求返回 NOTOK: "You are using a deprecated V1 endpoint, switch to Etherscan API V2"。请使用 V2 API（https://api.etherscan.io/v2/api），见迁移指南。

快速开始

V2 API（替换 YOUR_KEY——注意 /v2/api 路径）：

curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply&apikey=YOUR_KEY"

{ "status": "1", "message": "OK", "result": "123594005058750000000000000" }

某地址的 ETH 余额：

curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&apikey=YOUR_KEY"

Gas 价格：

curl "https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasoracle&apikey=YOUR_KEY"

认证方式

• 在 etherscan.io 注册 → 免费 API 密钥（在账号里）。
• 通过 apikey 查询参数携带。
• V2 需要 chainid（1 = 以太坊主网）——V2 API 支持多链。

速率限制与注意事项

• 免费层：1 次请求/秒（带密钥 5 次/秒）+ 100,000 次请求/天——以当前文档为准。
• V1 端点返回 NOTOK 弃用提示（已实测）——请迁移到 /v2/api。
• 模块：account（余额/交易）、stats（供应量）、gastracker、contract、token、logs……
• V2 通过 chainid 可查询其他 EVM 链。

常见问题

Etherscan API 免费吗？ 免费层带每日限额；密钥可提高。

为什么 V1 请求返回 NOTOK？ V1 已弃用——请用 https://api.etherscan.io/v2/api 加 chainid=1（2026-08 实测）。

可以查其他链吗？ 可以——V2 通过 chainid 参数支持多条 EVM 链。