API 返回 status 0 和限流提示
检查 这把密钥每秒发了多少次请求?
处理 降到套餐允许的频率。限额跟着 API 套餐走,换 IP 不会解除。
查交易、查合约不再卡在页面打不开:Etherscan 网页和 API V2 都从一条海外出口访问。
etherscan.io 在中国大陆被封锁:GreatFire 对它最近 6 次有效测试全部失败,api.etherscan.io 和 sepolia.etherscan.io 也在同一个被封锁的域名下。国内开发者、研究员和客服团队,连查一笔交易、一个合约都需要海外出口。
老脚本失效另有原因:Etherscan 已于 2025 年 8 月 15 日停用 API V1,请求改为 api.etherscan.io/v2/api 并加 chainid 参数,一把密钥覆盖 60 多条 EVM 链。免费版每秒 3 次、每天最多 10 万次,Base、BNB 智能链、OP 主网等链需要付费套餐。
自动化要走 API,不要爬网页。Etherscan 在 2026 年 8 月 13 日更新的条款禁止使用非官方提供的机器人、蜘蛛和爬虫,除搜索引擎索引外也不允许自动采集。代理解决的是“打不开”,不会改变这些规则,也不会提高套餐限额。
可使用方向键横向滚动,阅读完整内容。
| 比较项目 | 选择 | 原因 |
|---|---|---|
| 产品 | 动态住宅代理 | 你选定国家的家庭宽带 IP |
| 计费方式 | 按流量,优质或低价线路 | 查页面、调 API 流量很小,按实际用量付费 |
| 买几个出口 | 一人或一个脚本一个 | 各自保持自己的粘性会话 |
| 国家 | 任何能正常打开 Etherscan 的国家 | Web3 场景不会自动预选,生成前自己选 |
| 协议 | HTTP(默认)或 SOCKS5 | 浏览器、Proxy302 插件、Python、curl 都支持 HTTP |
| IP 会变吗 | 在所选国家保持粘性会话,不是永久固定 | 需要全天固定一个 IP,选静态 ISP |
下面的「配置 Etherscan 代理」按钮会打开 Web3 场景的动态住宅代理,按流量计费。先为所选线路购买流量,生成前选好地区。
可使用方向键横向滚动,阅读完整内容。
| 比较项目 | 静态 ISP | 动态住宅 | 静态机房 |
|---|---|---|---|
| 你得到什么 | 一条租期内固定归你的家庭宽带 IP | 真实家庭宽带 IP:在所选国家保持粘性会话,低价线路也可全球轮换 | 机房固定 IP,控制台里速度最快、价格最低的一档 |
| 价格 | 按 IP 和租期计费,付款前以 PTC 显示(1 PTC = US$1) | 按流量:低价线路 US$1.50/GB、优质线路 US$5.00/GB,1 GB 起 | 按 IP 和租期计费,付款前以 PTC 显示 |
| 最适合 Etherscan | 全天登录 Etherscan 账号工作 | 在国内查询和调用 API,按 GB 付费 | 全天候调用 API 的服务器和 CI |
价格以美元计,用 PTC 余额支付(1 PTC = US$1)。先充值钱包,再购买需要的线路。自动续费暂未开放,静态 IP 请在到期前到「我的资产」手动续费。
代理要在海外网络下才能连上。在中国大陆,登录 Proxy302 控制台 → 连接工具 → 辅助工具,下载并运行,使用代理期间保持开着;工具和脚本里用辅助工具显示的本地地址和端口代替代理的主机和端口,用户名密码不变。已有能连海外的 VPN 也可以。
点「配置 Etherscan 代理」打开「动态住宅代理」,使用场景已选 Web3。选择线路——默认「优质线路」,「低价线路」每 GB 更便宜——在「流量额度」里点「补充流量」,选套餐或填「自定义 GB」并购买。在「连接配置」里出口模式保持「指定地区 / 保持 IP」,选地区和协议,点「确认费用并生成」。
预期结果 「当前配置」显示按流量、Web3、指定地区 / 保持 IP 和你选的地区。
付款后控制台会打开「我的资产」。在新代理上点「查看凭据」,复制出口地址(主机:端口)、用户名和密码。
浏览器:连上 Proxy302 插件(HTTP,国内勾选「使用辅助工具」),或把代理填进指纹浏览器环境,再打开 etherscan.io。脚本:按下方示例传入代理地址和你的 Etherscan API 密钥。
按套餐的每秒、每日次数给脚本限速。如果某条链提示需要付费套餐,升级的是 Etherscan 套餐,换 IP 不会改变结果。
预期结果 脚本输出余额和最近几笔交易,没有限流报错。
可使用方向键横向滚动,阅读完整内容。
# pip install requests
import time
import requests
PROXY = "http://USERNAME:PASSWORD@HOST:PORT" # residential endpoint from My assets
PROXIES = {"http": PROXY, "https": PROXY}
API_KEY = "YOUR_ETHERSCAN_API_KEY"
ADDRESS = "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe"
def etherscan(**params):
params.update(chainid=1, apikey=API_KEY)
r = requests.get("https://api.etherscan.io/v2/api", params=params, proxies=PROXIES, timeout=30)
r.raise_for_status()
data = r.json()
if data.get("status") != "1" and data.get("message") != "No transactions found":
raise RuntimeError(f"Etherscan: {data.get('message')} - {data.get('result')}")
time.sleep(0.4) # free plan: 3 calls per second
return data["result"]
print("balance (wei):", etherscan(module="account", action="balance", address=ADDRESS, tag="latest"))
for tx in etherscan(module="account", action="txlist", address=ADDRESS, page=1, offset=5, sort="desc"):
print(tx["hash"], tx["blockNumber"])
API V2 需要 chainid 和你的密钥,一把密钥覆盖所有支持的链。sleep 让脚本保持在免费版每秒 3 次以内;每次请求都传 proxies,避免被环境变量里的代理覆盖。国内本机运行时,HOST:PORT 换成辅助工具的本地地址和端口。
检查 这把密钥每秒发了多少次请求?
处理 降到套餐允许的频率。限额跟着 API 套餐走,换 IP 不会解除。
检查 是否还在请求不带 /v2、不带 chainid 的 api.etherscan.io/api?
处理 改成 https://api.etherscan.io/v2/api 并加 chainid=1(或所需链),其他参数不变。
检查 同一个浏览器里 ipinfo.io 显示的是代理所在国家吗?辅助工具开着吗?
处理 修正浏览器代理或启动辅助工具后刷新;如果 Etherscan 弹出安全验证,在浏览器里完成即可。
etherscan.io 在中国大陆被封锁。打开辅助工具,在浏览器上接入一条海外住宅或静态 ISP 代理,再访问 etherscan.io;脚本则通过同一条代理调用 API V2。
不是。这里的代理是网络出口,也就是流量发出的 IP。Etherscan 也把“proxy”用于代理合约和 module=proxy 的 API 端点(如 eth_blockNumber),那是另外的功能。
不能。Etherscan 条款禁止爬虫和除搜索索引外的自动采集。请用 API 和你自己的密钥,并遵守套餐限额。
以太坊主网和 Sepolia 不需要,免费版每秒 3 次、每天最多 10 万次。Base、BNB 智能链、OP 主网等需要付费套餐。
GreatFire 最近的测试里 basescan.org、bscscan.com 可以访问,etherscan.io 被封锁。用 API 的话,Etherscan API V2 一把密钥覆盖这些链,但 Base 和 BNB 智能链需要付费套餐。
第三方来源 · 核对于:
2026-10-18 读取:etherscan.io 最近 6 次有效测试全部失败(最近一次 2026-10-03),api.etherscan.io、sepolia.etherscan.io 同属被封锁域名;basescan.org 最近一次有效测试可以访问,bscscan.com 最近一次测试(2026-05-28)可以访问。
第三方连通性测试,个别网络可能不同。
官方文档 · 核对于:
2025 年 7 月 30 日发布:API V1 在 2025 年 8 月 15 日完全停用,之后所有 V1 请求失效;迁移方式是改用新的基础地址、加上 chainid 参数,其余查询参数不变。
官方文档 · 核对于:
列出 V2 基础地址 https://api.etherscan.io/v2/api 以及 chainid、module=account、action=balance、address、tag、apikey 参数。
官方文档 · 核对于:
说明一个用 module=proxy、action=eth_blockNumber 调用的 API 端点。
官方文档 · 核对于:
免费版每秒 3 次、每天最多 10 万次;Lite 每秒 5 次、每天 10 万次;Standard 每秒 10 次、每天 20 万次;Advanced 每秒 20 次、每天 50 万次;Professional 每秒 30 次、每天 100 万次。
官方文档 · 核对于:
以太坊主网(chainid 1)和 Sepolia(11155111)标为免费可用,Base 主网(8453)、BNB 智能链主网(56)、OP 主网(10)标为仅付费;60 多条 EVM 链共用一把密钥,用 chainid 选择。
官方文档 · 核对于:
第 8 条禁止使用非 Etherscan 提供的机器人、蜘蛛、爬虫等自动化手段,除仅用于搜索引擎索引外不得自动采集数据;API 使用另受 API 条款约束。
产品观察 · 核对于:
2026-10-18 核对控制台源码:Web3 场景下的动态住宅页面按流量计费,可选「优质线路」或「低价线路」(用预购流量包,或在账号支持时用「PTC 钱包扣费」),默认出口模式为「指定地区 / 保持 IP」——在所选国家生成粘性会话,不承诺永久固定 IP;「全球轮换」只在低价线路 + 预购流量时可用。协议 HTTP 或 SOCKS5,每次生成一个出口。页面上的 Web3 提示为「公开资料研究:按实际流量 · HTTP CONNECT / SOCKS5 · 自选地区 · 遵守目标服务限额」。
产品观察 · 核对于:
价格页公布:动态住宅低价线路 US$1.50/GB、优质线路 US$5.00/GB,均 1 GB 起;账户以 PTC 结算,1 PTC = US$1.00;静态 ISP 与机房 IP 的租金取决于地区、数量和租期,付款前显示(2026-10-09 已与生产环境商品目录核对)。
产品观察 · 核对于:
教程说明:插件在「连接工具 → 浏览器插件」下载,在「我的资产」这条代理的「更多操作」里选「使用插件」后连接;插件只支持 HTTP 代理,只代理安装它的那个浏览器。
产品观察 · 核对于:
教程说明:在中国大陆,代理要在海外网络下才能连上;在控制台「连接工具 → 辅助工具」下载并运行免费的辅助工具,再把它显示的本地地址和端口填进指纹浏览器、浏览器插件或手机,账号密码不变;已有能连海外的 VPN 也可以。
注册账号、一次充值,即可选择动态住宅、静态 ISP 或数据中心出口。动态住宅覆盖 195+ 国家与地区。