# Etherscan API

> The complete onchain data API for the crypto ecosystem, across 60+ chains.

## Instructions

To work with the Etherscan API, start with these pages:

- Get a key and make your first call: [Set Up Your API Key](https://docs.etherscan.io/set-up-your-api-key.md), [Make Your First Call](https://docs.etherscan.io/make-your-first-call.md)
- Supported chains and chain IDs: [Supported Chains](https://docs.etherscan.io/supported-chains.md)
- Every endpoint, by module: [Endpoint Overview](https://docs.etherscan.io/endpoint-overview.md)
- Common use cases and recipes: [Common Use Cases](https://docs.etherscan.io/common-use-cases.md)
- Rate limits and plans: [Rate Limits](https://docs.etherscan.io/rate-limits.md)
- Name tags, labels, and address reputation: [Etherscan Metadata](https://docs.etherscan.io/metadata/introduction.md)
- Build with an AI agent (MCP, CLI, and skills): [Build with AI](https://docs.etherscan.io/build-with-ai/introduction.md)

Append `.md` to any documentation URL for raw Markdown, or connect the [Docs MCP](https://docs.etherscan.io/build-with-ai/docs-mcp.md) at `https://docs.etherscan.io/mcp` to search these docs over MCP.

## Get Started (Overview)

- [Welcome to the Etherscan API](https://docs.etherscan.io/introduction.md): The complete onchain data API for the crypto ecosystem
- [Supported Chains](https://docs.etherscan.io/supported-chains.md): Every chain the Etherscan API supports, with its chain ID and plan availability.

## API Basics

- [Set Up Your API Key](https://docs.etherscan.io/set-up-your-api-key.md): Register an Etherscan account and create a free API key that works across all supported chains.
- [Make Your First Call](https://docs.etherscan.io/make-your-first-call.md): Make your first Etherscan API request with a worked curl example and a parameter breakdown.
- [Rate Limits](https://docs.etherscan.io/rate-limits.md): Rate limits and PRO-endpoint availability for each Etherscan API plan tier.
- [Common Error Messages](https://docs.etherscan.io/common-error-messages.md): Understand the errors the Etherscan API returns and how to resolve each one.
- [API Status](https://docs.etherscan.io/api-status.md): Check Etherscan API status and rule out issues in your own request when calls fail.

## Contract Verification (Guides)

- [Verify with the API](https://docs.etherscan.io/contract-verification/verify-with-api.md): Verify a deployed smart contract programmatically using the Etherscan API, on any supported chain with one key.
- [Get Verified Source Code](https://docs.etherscan.io/contract-verification/get-source-code.md): Retrieve a contract's published source code, ABI, and compiler settings with the Etherscan API.
- [Verify with Foundry](https://docs.etherscan.io/contract-verification/verify-with-foundry.md): Verify a smart contract on Etherscan using Foundry, at deployment or for an existing contract.
- [Verify with Hardhat](https://docs.etherscan.io/contract-verification/verify-with-hardhat.md): Verify a smart contract on Etherscan from a Hardhat project.
- [Verify with Remix](https://docs.etherscan.io/contract-verification/verify-with-remix.md): Verify a smart contract on Etherscan using the Remix contract verification plugin.
- [Common Verification Errors](https://docs.etherscan.io/contract-verification/common-verification-errors.md): Diagnose and fix common contract verification errors like bytecode and compiler mismatches.

## Endpoint Showcase

- [Address Page](https://docs.etherscan.io/endpoint-showcase/address.md): The endpoints behind an address page on etherscan.io.
- [Token Page](https://docs.etherscan.io/endpoint-showcase/token.md): The endpoints behind a token page on etherscan.io.
- [Block Page](https://docs.etherscan.io/endpoint-showcase/block.md): The endpoints behind a block page on etherscan.io.
- [Transaction Page](https://docs.etherscan.io/endpoint-showcase/transaction.md): The endpoints behind a transaction page on etherscan.io.
- [Gas Tracker](https://docs.etherscan.io/endpoint-showcase/gas-tracker.md): The endpoints behind the gas tracker on etherscan.io.
- [Contract Page](https://docs.etherscan.io/endpoint-showcase/contract.md): The endpoints behind a contract page on etherscan.io.
- [Charts and Stats](https://docs.etherscan.io/endpoint-showcase/charts-and-stats.md): The endpoints behind the charts and stats pages on etherscan.io.

## Common Use Cases

- [Wallet and Portfolio](https://docs.etherscan.io/resources/wallet-and-portfolio.md): Show users their full onchain picture: balances, activity, NFTs, and real names, across every chain.
- [Tax and Accounting](https://docs.etherscan.io/resources/tax-and-accounting.md): Build tax, accounting, and reporting workflows with transaction history, transfers, historical balances, and address metadata.
- [Security and Compliance](https://docs.etherscan.io/resources/security-and-compliance.md): Build security and compliance workflows with address labels, reputation data, funding traces, and contract information.
- [Onchain Analytics and Research](https://docs.etherscan.io/resources/analytics-and-research.md): Build dashboards, research reports, and protocol monitors from entity labels, holder distributions, event logs, and network stats.

## Guides

- [Best Practices](https://docs.etherscan.io/resources/best-practices.md): Practical tips for faster, more efficient Etherscan API requests, from pagination to block ranges.

## Resources (Overview)

- [Contact Us](https://docs.etherscan.io/resources/contact-us.md): How to reach Etherscan support, and the official channels the team communicates from.
- [Useful Links](https://docs.etherscan.io/resources/useful-links.md): Quick links to the accounts, keys, and reference pages you use most on the Etherscan API.

## Build with AI

- [Build with AI](https://docs.etherscan.io/build-with-ai/introduction.md): Connect AI agents and coding tools to the Etherscan API across 60+ chains, with MCP, a CLI, and skills.

## Core Tools

- [Etherscan MCP](https://docs.etherscan.io/build-with-ai/mcp.md): Connect AI agents to live Etherscan API data through the Model Context Protocol.
- [Etherscan CLI](https://docs.etherscan.io/build-with-ai/cli.md): Query the Etherscan API from the terminal, scripts, and CI, with structured output for agents.

## Etherscan Skills

- [Etherscan Orchestrator](https://docs.etherscan.io/build-with-ai/skills/etherscan.md): The general skill that routes any onchain task to the right Etherscan interface: explorer website, API, CLI, or MCP.
- [Etherscan Flow](https://docs.etherscan.io/build-with-ai/skills/etherscan-flow.md): An installable agent skill that traces, verifies, and visualizes onchain money flows into an import-ready case file on [etherscan.io/flow](https://etherscan.io/flow).
- [Etherscan Contract Review](https://docs.etherscan.io/build-with-ai/skills/etherscan-contract-review.md): An installable agent skill that explains what a verified deployed contract does, with a source reference behind every claim.
- [Etherscan Transaction Debugger](https://docs.etherscan.io/build-with-ai/skills/etherscan-transaction-debugger.md): An installable agent skill that explains what a transaction did, and why, from live Etherscan data with verifiable evidence links.

## API Endpoints

- [Endpoint Overview](https://docs.etherscan.io/endpoint-overview.md): A complete list of Etherscan API endpoints, grouped by module.

## Account

- [Get Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balance.md): Retrieves the native token balance held by a specific address.
- [Get Native Balance for Multiple Addresses](https://docs.etherscan.io/api-reference/endpoint/balancemulti.md): Retrieves the native token balance held by multiple addresses in a single call.
- [Get Historical Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balancehistory.md): Retrieves the balance of a specified address at a given block height.
- [Get Normal Transactions By Address](https://docs.etherscan.io/api-reference/endpoint/txlist.md): Retrieves the transaction history of a specified address, with optional pagination.
- [Normal Transactions Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-txlist.md): Retrieves Normal Transactions with advanced from and to address filtering.
- [Get ERC20 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokentx.md): Retrieves ERC-20 token transfers, filtered by address and/or token contract.
- [ERC20 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-tokentx.md): Retrieves ERC20 token transfers with advanced from and to address filtering.
- [Get ERC721 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokennfttx.md): Retrieves ERC-721 token transfers, filtered by address and/or token contract.
- [ERC721 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-tokennfttx.md): Retrieves ERC721 token transfers with advanced from and to address filtering.
- [Get ERC1155 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/token1155tx.md): Retrieves ERC-1155 token transfers, filtered by address and/or token contract.
- [ERC1155 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-token1155tx.md): Retrieves ERC1155 token transfers with advanced from and to address filtering.
- [Get Internal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/txlistinternal.md): Retrieves the internal transaction history of a specified address, with optional pagination.
- [Internal Transactions Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-txlistinternal.md): Retrieves Internal Transactions with advanced from and to address filtering.
- [Get Internal Transactions by Block Range](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange.md): Returns internal transactions within a specified block range, with optional pagination.
- [Get Internal Transactions by Transaction Hash](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash.md): Retrieves the list of internal transactions executed within a specific transaction.
- [Get Blocks Validated by Address](https://docs.etherscan.io/api-reference/endpoint/getminedblocks.md): Retrieves the list of blocks validated by a specified address.
- [Get Beacon Chain Withdrawals by Address](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal.md): Retrieves beacon chain withdrawals, optionally filtered by address.
- [Get Address Funded By](https://docs.etherscan.io/api-reference/endpoint/fundedby.md): Retrieves the address and transaction that first funded a specific EOA address, useful for tracing fund origins. Not available to contract addresses.

## Blocks

- [Get Block and Uncle Rewards by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockreward.md): Retrieves block rewards along with associated Uncle block rewards.
- [Get Block Transaction Counts by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblocktxnscount.md): Retrieves transaction counts for a specified Ethereum block.
- [Get Estimated Block Countdown by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown.md): Retrieves the estimated time, in seconds, until a specified block is mined.
- [Get Block Number by Timestamp](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime.md): Retrieves the block number mined at a specific timestamp.
- [Get Daily Average Block Size](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize.md): Retrieves the average daily block size over a specified date range.
- [Get Daily Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount.md): Retrieves the daily count of mined blocks along with the corresponding block rewards.
- [Get Daily Block Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards.md): Retrieves the daily distribution of block rewards to miners.
- [Get Daily Average Block Time](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime.md): Retrieves the daily average time taken to successfully mine a block.
- [Get Daily Uncle Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount.md): Returns the daily count of Uncle blocks mined and their associated rewards.

## Contracts

- [Get Contract ABI](https://docs.etherscan.io/api-reference/endpoint/getabi.md): Retrieve the ABI for a verified smart contract.
- [Get Contract Source Code](https://docs.etherscan.io/api-reference/endpoint/getsourcecode.md): Retrieve the source code for a verified smart contract.
- [Get Contract Creator and Creation Tx Hash](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation.md): Retrieve a contract's deployer address and creation transaction.

## Contract Verification

- [Verify Solidity Source Code](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode.md): Submit a Solidity source code for verification.
- [Verify zkSync Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode.md): Submit zkSync source code for verification.
- [Verify Vyper Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyvyper.md): Submit a Vyper contract for verification.
- [Verify Stylus Source Code](https://docs.etherscan.io/api-reference/endpoint/verifystylus.md): Submit Stylus source code for verification.
- [Verify Proxy Contract](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract.md): Submit a proxy contract for verification.
- [Check Source Code Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus.md): Check the status of a source code verification request.
- [Check Proxy Contract Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification.md): Check the status of a proxy contract verification.

## Gas Tracker

- [Get Estimation of Confirmation Time](https://docs.etherscan.io/api-reference/endpoint/gasestimate.md): Estimate confirmation time based on a provided gas price.
- [Get Gas Oracle](https://docs.etherscan.io/api-reference/endpoint/gasoracle.md): Get current gas price recommendations.
- [Get Daily Average Gas Limit](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit.md): Retrieve daily average gas limit statistics.
- [Get Ethereum Daily Total Gas Used](https://docs.etherscan.io/api-reference/endpoint/dailygasused.md): Retrieves the total daily gas usage for transactions within the network
- [Get Daily Average Gas Price](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice.md): Retrieve daily average gas price statistics.

## Geth/Parity Proxy

- [eth_blockNumber](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber.md): Fetch the latest block number.
- [eth_getBlockByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber.md): Get block information by number.
- [eth_getUncleByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex.md): Get uncle block details by block number and index.
- [eth_getBlockTransactionCountByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber.md): Get the number of transactions in a block.
- [eth_getTransactionByHash](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash.md): Get transaction details by hash.
- [eth_getTransactionByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex.md): Get transaction details by block number and index.
- [eth_getTransactionCount](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount.md): Get the number of transactions sent from an address.
- [eth_sendRawTransaction](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction.md): Broadcast a signed transaction to the network.
- [eth_getTransactionReceipt](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt.md): Get the receipt of a transaction by hash.
- [eth_call](https://docs.etherscan.io/api-reference/endpoint/ethcall.md): Execute a call without creating a transaction.
- [eth_getCode](https://docs.etherscan.io/api-reference/endpoint/ethgetcode.md): Get the code stored at an address.
- [eth_getStorageAt](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat.md): Get the value at a storage position.
- [eth_gasPrice](https://docs.etherscan.io/api-reference/endpoint/ethgasprice.md): Get the current gas price.
- [eth_estimateGas](https://docs.etherscan.io/api-reference/endpoint/ethestimategas.md): Estimate the gas required for a transaction.

## Logs

- [Get Event Logs by Address](https://docs.etherscan.io/api-reference/endpoint/getlogs.md): Retrieves event logs from a specific address, with optional block range filtering.
- [Get Event Logs by Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics.md): Retrieves event logs within a specified block range, filtered by topics.
- [Get Event Logs by Address and Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics.md): Retrieves event logs from a specified address, filtered by topics and block range.

## Stats

- [Get Total Supply of Ether](https://docs.etherscan.io/api-reference/endpoint/ethsupply.md): Retrieves the current circulating supply of Ether, excluding ETH2 staking rewards and EIP-1559 burned fees.
- [Get Total Supply of Ether 2](https://docs.etherscan.io/api-reference/endpoint/ethsupply2.md): Retrieves the current Ether supply, including circulation, ETH2 staking rewards, EIP-1559 burned fees, and total ETH withdrawn from the beacon chain.
- [Get Ether Last Price](https://docs.etherscan.io/api-reference/endpoint/ethprice.md): Retrieves the latest price of the native/gas token.
- [Get Ethereum Nodes Size](https://docs.etherscan.io/api-reference/endpoint/chainsize.md): Retrieves the total size of the Ethereum blockchain, in bytes, within a specified date range.
- [Get Total Nodes Count](https://docs.etherscan.io/api-reference/endpoint/nodecount.md): Retrieves the total count of discoverable Ethereum nodes.
- [Get Historical Total Nodes Count](https://docs.etherscan.io/api-reference/endpoint/nodecounthistory.md): Retrieves the historical daily count of discoverable Ethereum nodes.
- [Get Daily Network Transaction Fee](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee.md): Retrieves the total transaction fees paid to miners each day.
- [Get Daily New Address Count](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress.md): Retrieves the daily count of newly created addresses.
- [Get Daily ENS Registration Count](https://docs.etherscan.io/api-reference/endpoint/dailyensregister.md): Retrieves the daily count of ENS registrations on Ethereum.
- [Get Daily Network Utilization](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization.md): Retrieves the daily average percentage of gas used relative to the gas limit.
- [Get Daily Average Network Hash Rate](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate.md): Retrieves the historical hash rate, reflecting the processing power of the network over time.
- [Get Daily Transaction Count](https://docs.etherscan.io/api-reference/endpoint/dailytx.md): Retrieves the daily number of transactions executed in the blockchain.
- [Get Daily Average Network Difficulty](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty.md): Returns the historical mining difficulty data of the network.
- [Get Ether Historical Price](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice.md): Returns the historical price data for 1 ETH.

## Transactions

- [Check Contract Execution Status](https://docs.etherscan.io/api-reference/endpoint/getstatus.md): Retrieves the current status and execution result of a specific transaction.
- [Check Transaction Receipt Status](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus.md): Retrieves the execution status of a specific transaction using its transaction hash.

## Tokens

- [Get ERC20-Token TotalSupply by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokensupply.md): Returns the amount of an ERC-20 token in circulation.
- [Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory.md): Returns the amount of an ERC-20 token in circulation at a certain block height.
- [Get ERC20-Token Account Balance for TokenContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokenbalance.md): Retrieves the current ERC-20 token balance for a specified address.
- [Get Historical ERC20-Token Account Balance by BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory.md): Retrieves the ERC-20 token balance for a specified address at a given block height.
- [Get Top Token Holders](https://docs.etherscan.io/api-reference/endpoint/topholders.md): Returns the list of top holders for a specified ERC-20 token.
- [Get Token Holder List by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist.md): Retrieves the current list of ERC-20 token holders and their token balances.
- [Get Token Holder Count by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount.md): Retrieves a simple count of ERC-20 token holders.
- [Get Token Info by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokeninfo.md): Retrieves project details and social media links for an ERC-20/ERC-721/ERC-1155 token.
- [Get Address ERC20 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance.md): Retrieves the list of ERC-20 tokens and balances held by a specified address.
- [Get Address ERC721 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance.md): Retrieves the ERC-721 tokens and their quantities owned by a specific address.
- [Get Address ERC721 Token Inventory by Contract](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory.md): Retrieves the ERC-721 token IDs owned by an address for a given NFT contract.

## L2 Deposits/Withdrawals

- [Get Plasma Deposits by Address](https://docs.etherscan.io/api-reference/endpoint/txnbridge.md): Retrieves a list of Plasma deposit transactions received by a specified address.
- [Get Deposit Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs.md): Retrieves all deposit transactions made by a specified address.
- [Get Withdrawal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs.md): Retrieves all withdrawal transactions made by a specified address.

## Nametags

- [Get Metadata for an Address](https://docs.etherscan.io/api-reference/endpoint/getaddresstag.md): Get nametags and metadata for the specified address.

## Usage

- [Get API Usage](https://docs.etherscan.io/api-reference/endpoint/getapilimit.md): Returns your current API credit usage and limit for the interval.
- [Chainlist](https://docs.etherscan.io/api-reference/endpoint/chainlist.md): Returns the list of all supported Etherscan mainnet and testnet chains.

## Beta Endpoints

- [Prediction Market APIs](https://docs.etherscan.io/beta/prediction-market.md): Opt in for beta access to prediction market data APIs such as Polymarket.

## Get Started

- [Introduction](https://docs.etherscan.io/metadata/introduction.md): Etherscan Metadata: nametags, labels, categories, and reputation for addresses across chains.

## Metadata Exports (Multichain)

- [Export Label Master List](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2.md): Generates a temporary download URL for the latest label master list (JSON file).
- [Export Address Tags](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2.md): Generates a temporary download URL for the addresses tagged with a given label (CSV or ZIP file).

## Resources

- [Reputation Reference](https://docs.etherscan.io/metadata/reputation-reference.md): Reference for Etherscan Metadata reputation scores, from UNKNOWN to UNSAFE.
- [Other Attributes Reference](https://docs.etherscan.io/metadata/other-attributes-reference.md): Reference for the Etherscan Metadata attribute codes returned for tokens and contracts.

## Optional

## Metadata Exports (Legacy)

- [Export Label Master List (Legacy)](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist.md): Retrieve the master list of address labels and categories in Etherscan metadata (Legacy).
- [Export Address Tags (Legacy)](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags.md): Export the list of addresses tagged with a given Etherscan label (Legacy).

## Changelog

- [Changelog](https://docs.etherscan.io/changelog.md): Recent updates and changes to the Etherscan API.