The API answers status 0 with a rate-limit message
Check How many calls per second does your script send with this key?
Fix Slow down to your plan's rate. The limits come with your API plan, so a new IP doesn't lift them.
Look up transactions and call API V2 through an exit abroad — while your scripts stay inside the limits of your Etherscan plan.
Etherscan is blocked in mainland China: GreatFire's last six conclusive tests of etherscan.io all failed, and api.etherscan.io and sepolia.etherscan.io sit under the same blocked domain. Developers, analysts and support teams there need an exit abroad just to look up a transaction or a contract.
Many scripts broke for another reason. Etherscan deprecated API V1 on 15 August 2025: requests now go to api.etherscan.io/v2/api with a chainid parameter, and one key covers 60+ EVM chains. The free plan allows 3 calls per second and up to 100,000 calls a day, and chains such as Base, BNB Smart Chain and OP Mainnet need a paid plan.
Automate through the API, not the website. Etherscan's terms, updated on 13 August 2026, prohibit robots, spiders, crawlers and scrapers it doesn't provide, and automated data collection beyond search indexing. A proxy gives you a working route to Etherscan; it doesn't change those rules or raise your plan's limits.
Scroll horizontally with the arrow keys to read all content.
| Criterion | Choose | Why |
|---|---|---|
| Product | Rotating residential proxy | A household IP in the country you choose |
| Billing | By traffic, Premium or Budget line | Lookups and API replies are light, and you pay per GB used |
| How many endpoints | One per person or script | Each keeps its own sticky session |
| Country | Any country where Etherscan loads | Nothing is preselected for Web3 — choose before you generate |
| Protocol | HTTP (preselected) or SOCKS5 | HTTP works in browsers, the Proxy302 extension, Python and curl |
| IP changes | Sticky in the chosen country, not permanently fixed | For one fixed IP all day, choose static ISP |
The “Configure Etherscan proxies” button opens rotating residential proxies for the Web3 use case, billed by traffic. Buy traffic for the line you choose, then pick the region before you generate.
Scroll horizontally with the arrow keys to read all content.
| Criterion | Static ISP | Rotating residential | Datacenter |
|---|---|---|---|
| What you get | A home-broadband IP fixed to you for the whole term | Household IPs: a sticky session in the country you pick, or rotation on the Budget line | Fixed IPs in data centres — the console's fastest and cheapest option |
| Price | Per IP and term, shown in PTC before you pay (1 PTC = US$1) | Per GB: Budget US$1.50, Premium US$5.00, from 1 GB | Per IP and term, shown in PTC before you pay |
| Best for Etherscan | Working in Etherscan all day, signed in to your account | Lookups and API calls from a blocked network, paid per GB | Servers and CI that call the API around the clock |
Prices in US dollars; you pay with PTC credit (1 PTC = US$1). Top up your wallet, then buy the line you need. Auto-renew isn't available yet, so renew static IPs in My assets before their term ends.
The “Configure Etherscan proxies” button opens Rotating Residential Proxies with the Web3 use case selected. Choose the Line — Premium is preselected, Budget costs less per GB — then under Traffic allowance click Add traffic and buy a package or enter Custom GB. Under Connection settings keep Exit mode at Choose region / sticky IP, pick the Region and Protocol, and click Review cost and generate.
Expected result Your configuration lists By traffic, Web3, Choose region / sticky IP and your region.
After payment the console opens My assets. Choose View credentials on the new proxy and copy the endpoint (host:port), username and password.
In a browser, connect the Proxy302 extension (HTTP) or paste the proxy into an antidetect-browser profile, then open etherscan.io. In scripts, pass the proxy URL and your Etherscan API key as in the example below.
Throttle scripts to your plan's calls per second and per day. If a chain answers that it needs a paid plan, upgrade the Etherscan plan — a different IP won't change that.
Expected result The script prints the balance and the latest transactions without rate-limit errors.
Scroll horizontally with the arrow keys to read all content.
# 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 takes chainid plus your key, and one key covers every supported chain. The sleep keeps the script under the free plan's 3 calls per second, and passing proxies on each call keeps environment proxy settings from overriding it.
Check How many calls per second does your script send with this key?
Fix Slow down to your plan's rate. The limits come with your API plan, so a new IP doesn't lift them.
Check Does it call api.etherscan.io/api without /v2 and without chainid?
Fix Switch to https://api.etherscan.io/v2/api and add chainid=1, or the chain you need; the other parameters stay the same.
Check Does ipinfo.io in the same browser show the proxy's country? On a mainland China network, is the Proxy302 Helper running?
Fix Fix the browser's proxy or start the Helper and reload. If Etherscan shows a security check, complete it in the browser.
No. Here a proxy is a network exit — the IP your traffic leaves from. Etherscan also uses the word for proxy contracts and for API endpoints called with module=proxy, such as eth_blockNumber; those are separate features.
No. Etherscan's terms prohibit scrapers and automated collection other than search indexing. Use the API with your key and stay within your plan.
Not for Ethereum mainnet or Sepolia — the free plan covers them with 3 calls per second and up to 100,000 calls a day. Chains such as Base, BNB Smart Chain and OP Mainnet need a paid plan.
For people who look things up from a blocked network, per-GB residential is a small start — 1 GB minimum, US$1.50 on the Budget line — because explorer pages and API replies are small. Move scripts that run day and night to a static datacenter IP.
Yes. API V2 serves 60+ EVM chains under one key with a chainid, so the same proxy and script work for them, within your plan's chain coverage.
Third-party source · Checked:
Read on 2026-10-18: etherscan.io failed all of its last 6 conclusive tests (latest 2026-10-03); api.etherscan.io and sepolia.etherscan.io are listed under the same blocked domain.
Independent connection tests; individual networks can differ.
Official documentation · Checked:
Published 30 July 2025: API V1 is fully deprecated by 15 August 2025 and all V1 requests stop working after that; migrate by using the new base URL, adding the chainid parameter and keeping the same query parameters.
Official documentation · Checked:
Documents the V2 base URL https://api.etherscan.io/v2/api with chainid, module=account, action=balance, address, tag and apikey.
Official documentation · Checked:
Documents an API endpoint called with module=proxy and action=eth_blockNumber.
Official documentation · Checked:
Free: 3 calls/second, up to 100,000 calls/day; Lite: 5/second, 100,000/day; Standard: 10/second, 200,000/day; Advanced: 20/second, 500,000/day; Professional: 30/second, 1,000,000/day.
Official documentation · Checked:
Marks Ethereum Mainnet (chainid 1) and Sepolia (11155111) as Free Tier Available and Base Mainnet (8453), BNB Smart Chain Mainnet (56) and OP Mainnet (10) as Paid Tier Only; all 60+ EVM chains work under one key with chainid.
Official documentation · Checked:
Section 8 prohibits using a robot, spider, crawler, scraper or other automated means or interface not provided by Etherscan, and automated data collection unless confined to search indexing; API use is governed by separate API terms.
Product observation · Checked:
Read in the console source on 2026-10-18: for the Web3 use case the rotating residential page bills by traffic on a Premium or Budget line (a prepaid package, or PTC wallet debit where your account offers it), starts in Choose region / sticky IP mode — a sticky session in the chosen country, not a permanently fixed IP — and allows Global rotation only on the Budget line with prepaid traffic. HTTP or SOCKS5; each generation creates one endpoint. Its Web3 note reads “Public information research: Actual traffic billing · HTTP CONNECT / SOCKS5 · choose region · respect service limits”.
Product observation · Checked:
Budget rotating residential US$1.50 per GB and Premium US$5.00 per GB, both from 1 GB; account credit in PTC at 1 PTC = US$1.00; static ISP and datacenter leases depend on region, quantity and term and are shown before you pay — as published on the pricing page (checked against the production catalogue on 2026-10-09).
Product observation · Checked:
The guide says the extension is installed from Connect → Browser extension, is pointed at a proxy from My assets → More actions → Use extension, supports HTTP proxies only and proxies only the browser it is installed in.
Create an account, top up once and pick rotating residential, static ISP or datacenter. Rotating residential exits cover 195+ countries and regions.