In most cases simply replacing the first part of the url is all that is needed to replace Etherscan with Blockscout. For example, replace https://etherscan.com/ with https://eth.blockscout.com/ in your code and the corresponding links to blocks, transactions, etc will be mapped to Blockscout rather than Etherscan.
😢 Tx before replacementhttps://etherscan.io/tx/0x3e8c3aad50b2f8471400e3fe6b812f20c332846064dff8c25fadf783eefa68df😁 Tx after replacementhttps://eth.blockscout.com/tx/0x3e8c3aad50b2f8471400e3fe6b812f20c332846064dff8c25fadf783eefa68df
Blockscout linking architecture follows EIP-3091standardization for the following routes:
  • Blocks <BLOCK_EXPLORER_URL>/block/<BLOCK_HASH_OR_HEIGHT>
  • Transactions <BLOCK_EXPLORER_URL>/tx/<TX_HASH>
  • Accounts <BLOCK_EXPLORER_URL>/address/<ACCOUNT_ADDRESS>
  • Tokens <BLOCK_EXPLORER_URL>/token/<TOKEN_ADDRESS>

​
UTM tags

We encourage adding UTM tags with your project information to Blockscout links. This helps us track referrals and improve our overall performance via metrics. Simply append ?utm_source=<your_project_name> to the end of any links pointing to Blockscout. For example https://eth.blockscout.com/?utm_source=tenderly

​
Common chain replacements

Replace the Etherscan url in your code with the Blockscout url for a seamless transition. All chains supported by Etherscan are also supported by Blockscout (along with many additional Blockscout chains). Some examples are below. For additional Blockscout chains see the chains and projects page or the chainscout json file which includes chainids.
ChainEtherscan ❌Blockscout ✅
Ethereumhttps://etherscan.io/https://eth.blockscout.com/
Ethereum Sepoliahttps://sepolia.etherscan.io/https://eth-sepolia.blockscout.com/
Optimismhttps://optimistic.etherscan.io/https://optimism.blockscout.com/
Optimism Sepoliahttps://sepolia-optimism.etherscan.io/https://optimism-sepolia.blockscout.com/
Basehttps://basescan.org/https://base.blockscout.com/
Base Sepoliahttps://sepolia.basescan.org/https://base-sepolia.blockscout.com/
Arbitrumhttps://arbiscan.io/https://arbitrum.blockscout.com/
Arbitrum Sepoliahttps://sepolia.arbiscan.io/https://arbitrum-sepolia.blockscout.com/
Polygonhttps://polygonscan.com/https://polygon.blockscout.com/
Gnosishttps://gnosisscan.io/https://gnosis.blockscout.com/
Celohttps://celoscan.io/https://celo.blockscout.com/
Unichainhttps://uniscan.xyz/https://unichain.blockscout.com/

​
Exceptions

Some newer operations without standards are still handled differently by different explorers. For example:
Standard Blockscout RPC calls do not need an API key (Etherscan calls always require one). You can remove the &apikey=YourApiKeyToken query string at the end of the url with no problem or keep it as any string value and Blockscout will process. If you want to increase your limits, you can also sign up for a free Blockscout API key and use it to access 10 RPS limits.
Etherscan uses a subdomain link for api access. For example, the Ethereum explorer the api link is https://api.etherscan.io/ followed by your query, or for Optimism it is https://api-optimistic.etherscan.io/ followed by your query. To replace, simply use the regular blockscout url for the instance, for example https://eth.blockscout.com/ for Ethereum or https://optimism.blockscout.com/ for Optimism.
😢 API call before replacement (doesn’t work without API key)https://api.etherscan.io/api?module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&tag=latest&apikey=YourApiKeyToken😁 API call after replacement (works without API key)https://eth.blockscout.com/api?module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&tag=latest
Standard API routes on Etherscan work for your queries on Blockscout. We’ve structured our data calls to be consistent with Etherscan whenever possible. You can see supported calls in the JSON RPC & ETH Compatible RPC endpoints section.
If you require more varied or richer datasets consider replacing your JSON RPC calls with the REST API from Blockscout. This free API features additional metadata, stats data, human readable transactions and more.

​
API Exceptions

Every wallet handles the explorer link differently, but typically wallets ship with Etherscan links by default. To change, simply go to settings and replace the Etherscan link with the Blockscout one. Here’s how you do it in MetaMask.
  1. Open MetaMask, click the dots to open the menu, and select Settings
  2. Select Networks
  3. Select the network where you want to change the explorer link
  1. Find the block explorer url (ie https://optimistic.etherscan.io/).
  2. Change the url to blockscout (ie https://optimism.blockscout.com/) and Save.
Repeat this process for all networks from the Networks screen.