Etherscan API key 申请与用法｜免费 100k req/day 完整教程
Etherscan API key 是写监控脚本、批量查地址、做链上数据分析的必需品。本文按 7 步教你免费注册、申请 API key、调用核心 endpoints（balance / tokenbalance / txlist / gasoracle）、配额管理、避免被限流。
Etherscan API key 怎么申请？直接答：免费注册 etherscan.io 账号 → 进入 Account → API Keys → 点 Add 输入名称 → 立即拿到 32 位 API key → 在 GET 请求里加 &apikey=YOUR_KEY 调用任意 endpoint。免费额度是 5 calls/秒、100,000 requests/天，对绝大多数个人项目够用。关键点是 API key 一旦暴露要立刻 revoke——它不能被偷资产但能耗光你的免费额度。
如果你做完链上数据分析后想把链上 USDT 出金到法币，可顺路准备 币安官网 的实名账号，并用 币安官方App 看充币地址。下载入口在 下载页。
Etherscan API 是什么
A：Etherscan API 是一组 RESTful endpoints，把网页上能看的所有数据（交易、地址、合约、Gas、Token 等）开放给程序调用——返回 JSON 格式。
| 用途 | 适合人群 |
|---|---|
| 监控钱包活动 | 个人投资者 |
| 批量查地址 | 链上分析师 |
| 写交易 bot | 开发者 |
| 数据可视化 | 数据分析师 |
| dApp 后端 | DApp 团队 |
第 1 步：注册 Etherscan 账号
打开 etherscan.io → 右上角 Sign In → New Account → 填邮箱 + 密码 + 验证码 → 验证邮件确认。注册免费。
A：用主邮箱注册，因为 Watch List 通知会发到这个邮箱。
第 2 步：进入 API Keys 页面
登录后右上角点头像 → API Keys → 进入管理页。首次进来空白。
第 3 步：创建 API Key
点 Add → 输入名称（任意，建议有标识性如「My Bot」「Personal Monitor」）→ Submit → 立即得到一串 32 位字符。
A：这串字符就是你的 API key，立刻复制保存。不要分享、不要提交到 GitHub 公开仓库——会被 bot 扫到然后耗光你的免费额度。
第 4 步：调用第一个 endpoint
最简单的查余额：
GET https://api.etherscan.io/api
?module=account
&action=balance
&address=0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B
&tag=latest
&apikey=YOUR_API_KEY
返回 JSON：
{
"status": "1",
"message": "OK",
"result": "1234567890123456789"
}
result 是该地址的 ETH 余额，单位 Wei（除以 10^18 得 ETH）。
第 5 步：核心 5 个 endpoints
5.1 查 ETH 余额：?module=account&action=balance&address=...
5.2 查 ERC20 余额：?module=account&action=tokenbalance&contractaddress=...&address=...
5.3 查地址全部交易：?module=account&action=txlist&address=...&startblock=0&endblock=99999999&sort=desc
5.4 查 ERC20 转账：?module=account&action=tokentx&address=...
5.5 查 Gas Oracle：?module=gastracker&action=gasoracle
| Endpoint | 用途 | 典型耗时 |
|---|---|---|
| balance | 查 ETH 余额 | < 100 ms |
| tokenbalance | 查 ERC20 持仓 | < 200 ms |
| txlist | 查全部交易（分页） | 200-500 ms |
| tokentx | 查 ERC20 转账 | 200-500 ms |
| gasoracle | 查 Gas 价 | < 100 ms |
第 6 步：免费配额管理
| 限制 | 数值 |
|---|---|
| 速率 | 5 calls/秒 |
| 日额度 | 100,000 requests |
| 单次返回 | 最多 10,000 条记录 |
| 历史范围 | 全部历史均可查 |
| API key 数量 | 免费用户最多 3 个 |
A：5 calls/秒 = 432,000 calls/天理论上限，但日额度 10 万压实——做大规模分析超过这个量要付费升级（Standard/Advanced/Pro 三档）。
第 7 步：超额时怎么办
| 现象 | 原因 | 处理 |
|---|---|---|
返回 Max rate limit reached |
5/秒触发 | 加 sleep(0.2) 控速 |
返回 Daily limit reached |
10 万/天触发 | 等次日 UTC 00:00 重置 |
返回 Invalid API Key |
拼错 | 检查 key |
返回 Contract source code not verified |
该合约 unverified | 该 endpoint 不适用 |
实战：用 Python 监控钱包余额
import requests, time
API_KEY = "YOUR_KEY"
ADDR = "0x..."
URL = f"https://api.etherscan.io/api?module=account&action=balance&address={ADDR}&tag=latest&apikey={API_KEY}"
while True:
r = requests.get(URL).json()
bal_wei = int(r['result'])
bal_eth = bal_wei / 1e18
print(f"Balance: {bal_eth:.6f} ETH")
time.sleep(60) # 每分钟查一次
A：这个简单脚本能让你实时监控钱包变化——余额低于阈值时改 print 为 webhook 推送即可做到主动告警。
进阶：multi-chain 用 V2 API
Etherscan 自 2024 年推出 V2 API，一个 key 用于所有 EVM 链——不用为 ETH/BSC/Polygon 各申请一个 key。
GET https://api.etherscan.io/v2/api
?chainid=56
&module=account
&action=balance
&address=0x...
&apikey=YOUR_KEY
只要在请求里加 chainid 参数即可切换。chainid 1=ETH、56=BSC、137=Polygon、42161=Arbitrum。
API key 安全建议
| 建议 | 原因 |
|---|---|
| 不要提交到公开 GitHub | bot 扫一秒就被偷 |
| 在前端代码里不直接用 | 浏览器 F12 即可看到 |
| 用环境变量加载 | .env 文件 + .gitignore |
| 月审一次额度使用 | 异常激增说明被偷 |
| 一台机器一个 key | 出事单独 revoke 不影响其他 |
风险提示
API key 不能控制资产，但能用你的免费额度——被偷的后果是你被「耗到限流」，不是被偷币。真正泄漏私钥才会被偷币——API key 与私钥完全是两个东西。
如果链上操作完想把资产去交易所，可借助 币安官网 完成 KYC 后用 C2C。
实操核对清单
- [ ] 已注册 etherscan.io 账号并验证邮箱
- [ ] 已生成首个 API key 并保存到 .env
- [ ] 已用 balance endpoint 测试一次
- [ ] 已了解 5 calls/秒、10 万/天的限制
- [ ] API key 没提交到 git
- [ ] 已知道 V2 API 跨链用法
一站式回顾
A：Etherscan API key 是免费拿到的链上数据通行证——5 calls/秒、10 万/天对个人项目绰绰有余。核心 5 个 endpoints：balance、tokenbalance、txlist、tokentx、gasoracle。核心 1 个安全点：不要把 key 暴露到任何公开位置。
如果想了解多链统一查询，下一步建议看 OKLink 多链浏览器篇。
常见问题
API key 申请要不要花钱？
A：完全免费。新注册账号即可拿 1 个免费 key，最多 3 个。付费档（Standard/Advanced/Pro）是给企业用，普通开发者完全用不到。
一个 IP 能用几个 API key？
A：没硬性限制。一台机器同时用多个 key 能突破单 key 5/秒——但合规做法是「一个项目一个 key」便于管理。滥用会被官方 ban。
API key 能查别的链吗？
A：V1 API 只能查 ETH 主网，V2 API 通过 chainid 参数支持所有 EVM 链。推荐直接用 V2，未来 V1 可能逐步淘汰。
txlist 一次能返回多少条？
A：单次最多 10,000 条。超过要分页（offset/page 参数）。例如查一个老地址的全部历史可能要几页一起拉。
我能不能用 API 提交交易？
A：不能。Etherscan API 是只读——查询数据可以，发交易不行。发交易要直接对接节点 RPC（如 Infura、Alchemy 或自建节点）。
API key 会过期吗？
A：不会自动过期。只要账户在线、不主动 revoke，永久有效。但如果长期不用（数月），Etherscan 可能清理睡眠 key——重新登录即恢复。
用 V2 API 多链查询额度怎么算？
A：按 key 总额度算，不分链。一天 10 万 calls 是「ETH+BSC+Polygon+...」总和，不是每条链独立 10 万。
文档发布于 2026-05-08，下次复测计划 2026-08-08（约每 90 天回访一次，确认 Etherscan API 免费额度与 V2 chainid 参数支持范围未变）。