Skip to content

Etherscan Proxy: Reach Etherscan and API V2 from a Stable IP

Look up transactions and call API V2 through an exit abroad — while your scripts stay inside the limits of your Etherscan plan.

Why Etherscan users need a proxy

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.

Recommended Etherscan setup

Scroll horizontally with the arrow keys to read all content.

Recommended Etherscan setup
CriterionChooseWhy
ProductRotating residential proxyA household IP in the country you choose
BillingBy traffic, Premium or Budget lineLookups and API replies are light, and you pay per GB used
How many endpointsOne per person or scriptEach keeps its own sticky session
CountryAny country where Etherscan loadsNothing is preselected for Web3 — choose before you generate
ProtocolHTTP (preselected) or SOCKS5HTTP works in browsers, the Proxy302 extension, Python and curl
IP changesSticky in the chosen country, not permanently fixedFor 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.

Which Proxy302 proxy to buy

Scroll horizontally with the arrow keys to read all content.

Which Proxy302 proxy to buy
CriterionStatic ISPRotating residentialDatacenter
What you getA home-broadband IP fixed to you for the whole termHousehold IPs: a sticky session in the country you pick, or rotation on the Budget lineFixed IPs in data centres — the console's fastest and cheapest option
PricePer 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 GBPer IP and term, shown in PTC before you pay
Best for EtherscanWorking in Etherscan all day, signed in to your accountLookups and API calls from a blocked network, paid per GBServers 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.

Set up an Etherscan proxy in 4 steps

  1. Open the research setup

    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.

  2. Copy the connection details

    After payment the console opens My assets. Choose View credentials on the new proxy and copy the endpoint (host:port), username and password.

  3. Use it in the browser or in scripts

    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.

  4. Stay inside your plan

    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.

Call Etherscan API V2 through the proxy (Python)

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.

Quick fixes

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.

An old script returns a deprecation error

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.

etherscan.io still won't open

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.

Etherscan proxy FAQ

Is this about Etherscan's proxy contracts?

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.

Can I scrape Etherscan through rotating proxies?

No. Etherscan's terms prohibit scrapers and automated collection other than search indexing. Use the API with your key and stay within your plan.

Do I need a paid Etherscan 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.

Why residential and not datacenter?

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.

Does the same setup work for other EVM chains?

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.

Sources and verification

10
  1. GreatFire Analyzer: etherscan.io from mainland China

    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.

  2. Etherscan knowledge base: API V1 fully deprecated by 15 August 2025

    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.

  3. Etherscan API reference: account balance

    Official documentation · Checked:

    Documents the V2 base URL https://api.etherscan.io/v2/api with chainid, module=account, action=balance, address, tag and apikey.

  4. Etherscan API reference: eth_blockNumber

    Official documentation · Checked:

    Documents an API endpoint called with module=proxy and action=eth_blockNumber.

  5. Etherscan documentation: rate limits

    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.

  6. Etherscan documentation: supported chains

    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.

  7. Etherscan Terms of Service (last updated 13 August 2026)

    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.

  8. Proxy302 rotating residential configuration for Web3

    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”.

  9. Proxy302 pricing

    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).

  10. Proxy302 Chrome extension guide

    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.

Ready to connect?

Create an account, top up once and pick rotating residential, static ISP or datacenter. Rotating residential exits cover 195+ countries and regions.