# Table of Contents - [Introduction - Etherscan](#introduction-etherscan) - [Chainlist - Etherscan](#chainlist-etherscan) - [Get Address ERC20 Token Holding - Etherscan](#get-address-erc20-token-holding-etherscan) - [Get Address ERC721 Token Holding - Etherscan](#get-address-erc721-token-holding-etherscan) - [Introduction - Etherscan](#introduction-etherscan) - [Export Address Tags V2 - Etherscan](#export-address-tags-v2-etherscan) - [Export Address Tags - Etherscan](#export-address-tags-etherscan) - [Get Address ERC721 Token Inventory by Contract - Etherscan](#get-address-erc721-token-inventory-by-contract-etherscan) - [Get Native Balance for an Address - Etherscan](#get-native-balance-for-an-address-etherscan) - [Get Label Master List V2 - Etherscan](#get-label-master-list-v2-etherscan) - [Reputation Reference - Etherscan](#reputation-reference-etherscan) - [Get Ethereum Daily Total Gas Used - Etherscan](#get-ethereum-daily-total-gas-used-etherscan) - [Introduction - Etherscan](#introduction-etherscan) - [Get Daily Average Gas Limit - Etherscan](#get-daily-average-gas-limit-etherscan) - [Other Attributes Reference - Etherscan](#other-attributes-reference-etherscan) - [Get Historical Native Balance for an Address - Etherscan](#get-historical-native-balance-for-an-address-etherscan) - [Get Label Master List - Etherscan](#get-label-master-list-etherscan) - [Get Daily Average Gas Price - Etherscan](#get-daily-average-gas-price-etherscan) - [Get Daily Block Rewards - Etherscan](#get-daily-block-rewards-etherscan) - [Get Ethereum Nodes Size - Etherscan](#get-ethereum-nodes-size-etherscan) - [Get Daily Average Block Size - Etherscan](#get-daily-average-block-size-etherscan) - [Get Daily Block Count and Rewards - Etherscan](#get-daily-block-count-and-rewards-etherscan) - [Check Proxy Contract Verification Status - Etherscan](#check-proxy-contract-verification-status-etherscan) - [Get Daily Average Block Time - Etherscan](#get-daily-average-block-time-etherscan) - [Check Source Code Verification Status - Etherscan](#check-source-code-verification-status-etherscan) - [Get Daily Uncle Block Count and Rewards - Etherscan](#get-daily-uncle-block-count-and-rewards-etherscan) - [Verify with Remix - Etherscan](#verify-with-remix-etherscan) - [Common Verification Errors - Etherscan](#common-verification-errors-etherscan) - [Common Error Messages - Etherscan](#common-error-messages-etherscan) - [Contact Us - Etherscan](#contact-us-etherscan) - [Get Daily Average Network Difficulty - Etherscan](#get-daily-average-network-difficulty-etherscan) - [Get Daily Network Utilization - Etherscan](#get-daily-network-utilization-etherscan) - [Rate Limits - Etherscan](#rate-limits-etherscan) - [Get Daily Average Network Hash Rate - Etherscan](#get-daily-average-network-hash-rate-etherscan) - [Get Nametag (Metadata) for an Address - Etherscan](#get-nametag-metadata-for-an-address-etherscan) - [Check Transaction Receipt Status - Etherscan](#check-transaction-receipt-status-etherscan) - [V2 Migration - Etherscan](#v2-migration-etherscan) - [Verify with Hardhat - Etherscan](#verify-with-hardhat-etherscan) - [Get Daily New Address Count - Etherscan](#get-daily-new-address-count-etherscan) - [Get Daily Transaction Count - Etherscan](#get-daily-transaction-count-etherscan) - [Get Daily Network Transaction Fee - Etherscan](#get-daily-network-transaction-fee-etherscan) - [Get Withdrawal Transactions by Address - Etherscan](#get-withdrawal-transactions-by-address-etherscan) - [Get Gas Oracle - Etherscan](#get-gas-oracle-etherscan) - [Check Contract Execution Status - Etherscan](#check-contract-execution-status-etherscan) - [Verify with Foundry - Etherscan](#verify-with-foundry-etherscan) - [eth_call - Etherscan](#eth-call-etherscan) - [Get Ether Historical Price - Etherscan](#get-ether-historical-price-etherscan) - [Get Event Logs by Address - Etherscan](#get-event-logs-by-address-etherscan) - [Supported Chains - Etherscan](#supported-chains-etherscan) - [eth_gasPrice - Etherscan](#eth-gasprice-etherscan) - [Get Estimation of Confirmation Time - Etherscan](#get-estimation-of-confirmation-time-etherscan) - [Get Plasma Deposits by Address - Etherscan](#get-plasma-deposits-by-address-etherscan) - [Get Event Logs by Topics - Etherscan](#get-event-logs-by-topics-etherscan) - [Get Deposit Transactions by Address - Etherscan](#get-deposit-transactions-by-address-etherscan) - [Getting an API Key - Etherscan](#getting-an-api-key-etherscan) - [eth_getCode - Etherscan](#eth-getcode-etherscan) - [eth_estimateGas - Etherscan](#eth-estimategas-etherscan) - [eth_getBlockTransactionCountByNumber - Etherscan](#eth-getblocktransactioncountbynumber-etherscan) - [eth_blockNumber - Etherscan](#eth-blocknumber-etherscan) - [Get Block Number by Timestamp - Etherscan](#get-block-number-by-timestamp-etherscan) - [Get Event Logs by Address and Topics - Etherscan](#get-event-logs-by-address-and-topics-etherscan) - [eth_getTransactionByHash - Etherscan](#eth-gettransactionbyhash-etherscan) - [Get Total Supply of Ether - Etherscan](#get-total-supply-of-ether-etherscan) - [Get Estimated Block Countdown by Block Number - Etherscan](#get-estimated-block-countdown-by-block-number-etherscan) - [eth_getTransactionCount - Etherscan](#eth-gettransactioncount-etherscan) - [eth_getBlockByNumber - Etherscan](#eth-getblockbynumber-etherscan) - [eth_getStorageAt - Etherscan](#eth-getstorageat-etherscan) - [eth_getTransactionReceipt - Etherscan](#eth-gettransactionreceipt-etherscan) - [Get Ether Last Price - Etherscan](#get-ether-last-price-etherscan) - [eth_getUncleByBlockNumberAndIndex - Etherscan](#eth-getunclebyblocknumberandindex-etherscan) - [Get Block and Uncle Rewards by Block Number - Etherscan](#get-block-and-uncle-rewards-by-block-number-etherscan) - [eth_sendRawTransaction - Etherscan](#eth-sendrawtransaction-etherscan) - [eth_getTransactionByBlockNumberAndIndex - Etherscan](#eth-gettransactionbyblocknumberandindex-etherscan) - [Get Total Supply of Ether 2 - Etherscan](#get-total-supply-of-ether-2-etherscan) - [Get Contract Creator and Creation Tx Hash - Etherscan](#get-contract-creator-and-creation-tx-hash-etherscan) - [Get Contract ABI - Etherscan](#get-contract-abi-etherscan) - [Get ERC20-Token Account Balance for TokenContractAddress - Etherscan](#get-erc20-token-account-balance-for-tokencontractaddress-etherscan) - [Verify Stylus Source Code - Etherscan](#verify-stylus-source-code-etherscan) - [Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo - Etherscan](#get-historical-erc20-token-totalsupply-by-contractaddress-blockno-etherscan) - [Verify Source Code on zkSync - Etherscan](#verify-source-code-on-zksync-etherscan) - [Verify Vyper Source Code - Etherscan](#verify-vyper-source-code-etherscan) - [Get Address Funded By - Etherscan](#get-address-funded-by-etherscan) - [Get Token Holder List by Contract Address - Etherscan](#get-token-holder-list-by-contract-address-etherscan) - [Verify Proxy Contract - Etherscan](#verify-proxy-contract-etherscan) - [Verify Solidity Source Code - Etherscan](#verify-solidity-source-code-etherscan) - [Get Blocks Validated by Address - Etherscan](#get-blocks-validated-by-address-etherscan) - [Get Top Token Holders - Etherscan](#get-top-token-holders-etherscan) - [Get Internal Transactions by Transaction Hash - Etherscan](#get-internal-transactions-by-transaction-hash-etherscan) - [Get Historical ERC20-Token Account Balance by BlockNo - Etherscan](#get-historical-erc20-token-account-balance-by-blockno-etherscan) - [Get Token Holder Count by Contract Address - Etherscan](#get-token-holder-count-by-contract-address-etherscan) - [Get Total Nodes Count - Etherscan](#get-total-nodes-count-etherscan) - [Get Contract Source Code - Etherscan](#get-contract-source-code-etherscan) - [Get ERC721 Token Transfers by Address - Etherscan](#get-erc721-token-transfers-by-address-etherscan) - [Get Token Info by ContractAddress - Etherscan](#get-token-info-by-contractaddress-etherscan) - [Get Internal Transactions by Address - Etherscan](#get-internal-transactions-by-address-etherscan) - [Get ERC1155 Token Transfers by Address - Etherscan](#get-erc1155-token-transfers-by-address-etherscan) - [Get ERC20-Token TotalSupply by ContractAddress - Etherscan](#get-erc20-token-totalsupply-by-contractaddress-etherscan) - [Get ERC20 Token Transfers by Address - Etherscan](#get-erc20-token-transfers-by-address-etherscan) - [Get Internal Transactions by Block Range - Etherscan](#get-internal-transactions-by-block-range-etherscan) - [Get Beacon Chain Withdrawals by Address - Etherscan](#get-beacon-chain-withdrawals-by-address-etherscan) - [Get Normal Transactions By Address - Etherscan](#get-normal-transactions-by-address-etherscan) - [PRO Endpoints - Etherscan](#pro-endpoints-etherscan) --- # Introduction - Etherscan [Skip to main content](https://docs.etherscan.io/introduction#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Introduction [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Start Building](https://docs.etherscan.io/introduction#start-building) Etherscan is the leading blockchain explorer, search, API, and analytics platform for Ethereum and other EVM-compatible chains. With Etherscan API V2, we’ve unified all 60+ [supported chains](https://docs.etherscan.io/supported-chains) under a single account and API key system. Your app becomes multichain 🌈 simply by updating the `chainid` parameter to support BNB Smart Chain (BSC), Base, Arbitrum, HyperEVM, and more. [​](https://docs.etherscan.io/introduction#start-building) Start Building ---------------------------------------------------------------------------- [Get Stablecoin Transfers to an Address\ --------------------------------------\ \ Check for USDC/USDT/PYUSD token transfers to an address.\ \ Token Transfers Endpoint](https://docs.etherscan.io/api-reference/endpoint/tokentx) [Get Top Token Holders\ ---------------------\ \ Analyze the largest holders of YieldBasis(Ethereum), Aster(BNB) and other newly launched tokens.\ \ Top Holders Endpoint](https://docs.etherscan.io/api-reference/endpoint/toptokenholders) [Get Address Portfolio\ ---------------------\ \ List all token balances for an address, across chains.\ \ Address Portfolio Endpoint](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance) [Get Address Name Tag\ --------------------\ \ Get name tags and labels associated with an address, such as exchange deposits β€œCoinbase 10”.\ \ Name Tag Endpoint](https://docs.etherscan.io/api-reference/endpoint/getaddresstag) [Getting an API Key](https://docs.etherscan.io/getting-an-api-key) ⌘I --- # Chainlist - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/chainlist#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Usage Chainlist [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / chainlist Try it Get Chain List cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/chainlist Response Copy Ask AI { "comments": "List of API endpoints maintained by Etherscan EAAS. Available Status codes are (0)=Offline, (1)=Ok, (2)=Degraded", "totalcount": 67, "result": [\ {\ "chainname": "Ethereum Mainnet",\ "chainid": "1",\ "blockexplorer": "https://etherscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=1",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Sepolia Testnet",\ "chainid": "11155111",\ "blockexplorer": "https://sepolia.etherscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=11155111",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Base Mainnet",\ "chainid": "8453",\ "blockexplorer": "https://basescan.org/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=8453",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Polygon Mainnet",\ "chainid": "137",\ "blockexplorer": "https://polygonscan.com/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=137",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Arbitrum One Mainnet",\ "chainid": "42161",\ "blockexplorer": "https://arbiscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=42161",\ "status": 1,\ "comment": ""\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/chainlist#query-parameters) Query Parameters No parameters required. Response Copy Ask AI { "comments": "List of API endpoints maintained by Etherscan EAAS. Available Status codes are (0)=Offline, (1)=Ok, (2)=Degraded", "totalcount": 67, "result": [\ {\ "chainname": "Ethereum Mainnet",\ "chainid": "1",\ "blockexplorer": "https://etherscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=1",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Sepolia Testnet",\ "chainid": "11155111",\ "blockexplorer": "https://sepolia.etherscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=11155111",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Base Mainnet",\ "chainid": "8453",\ "blockexplorer": "https://basescan.org/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=8453",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Polygon Mainnet",\ "chainid": "137",\ "blockexplorer": "https://polygonscan.com/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=137",\ "status": 1,\ "comment": ""\ },\ {\ "chainname": "Arbitrum One Mainnet",\ "chainid": "42161",\ "blockexplorer": "https://arbiscan.io/",\ "apiurl": "https://api.etherscan.io/v2/api?chainid=42161",\ "status": 1,\ "comment": ""\ }\ ] } [Get Nametag (Metadata) for an Address](https://docs.etherscan.io/api-reference/endpoint/getaddresstag) [Verify with Foundry](https://docs.etherscan.io/contract-verification/verify-with-foundry) ⌘I --- # Get Address ERC20 Token Holding - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Address ERC20 Token Holding [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenAddress": "0xffffffff2ba8f66d4e51811c5190992176930278",\ "TokenName": "Furucombo",\ "TokenSymbol": "COMBO",\ "TokenQuantity": "1861606940000000000",\ "TokenDivisor": "18",\ "TokenPriceUSD": "0.000891470000000000"\ },\ {\ "TokenAddress": "0x53a1e9912323b8016424d6287286e3b6de263f76",\ "TokenName": "PUTIN Token",\ "TokenSymbol": "PTT",\ "TokenQuantity": "3500000000000000000000",\ "TokenDivisor": "18",\ "TokenPriceUSD": "0.000000000000000000"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-action) action string default:"addresstokenbalance" Set to `addresstokenbalance` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-address) address string default:"0x983e3660c0bE01991785F80f266A84B911ab59b0" Address to check for token holdings. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance#param-offset) offset integer default:"100" Number of records per page. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokenbalance&address=0x983e3660c0bE01991785F80f266A84B911ab59b0&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenAddress": "0xffffffff2ba8f66d4e51811c5190992176930278",\ "TokenName": "Furucombo",\ "TokenSymbol": "COMBO",\ "TokenQuantity": "1861606940000000000",\ "TokenDivisor": "18",\ "TokenPriceUSD": "0.000891470000000000"\ },\ {\ "TokenAddress": "0x53a1e9912323b8016424d6287286e3b6de263f76",\ "TokenName": "PUTIN Token",\ "TokenSymbol": "PTT",\ "TokenQuantity": "3500000000000000000000",\ "TokenDivisor": "18",\ "TokenPriceUSD": "0.000000000000000000"\ }\ ] } [Get Token Info by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokeninfo) [Get Address ERC721 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance) ⌘I --- # Get Address ERC721 Token Holding - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Address ERC721 Token Holding [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftbalance&address=0x6b52e83941eb10f9c613c395a834457559a80114&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "NOTOK", "result": "Maximum rate limit reached" } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-action) action string default:"addresstokennftbalance" Set to `addresstokennftbalance` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-address) address string default:"0x6b52e83941eb10f9c613c395a834457559a80114" Address to check for NFT holdings. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance#param-offset) offset integer default:"100" Number of records per page. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftbalance&address=0x6b52e83941eb10f9c613c395a834457559a80114&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "NOTOK", "result": "Maximum rate limit reached" } [Get Address ERC20 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance) [Get Address ERC721 Token Inventory by Contract](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory) ⌘I --- # Introduction - Etherscan [Skip to main content](https://docs.etherscan.io/mcp-docs/introduction#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Introduction [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Etherscan MCP Server](https://docs.etherscan.io/mcp-docs/introduction#etherscan-mcp-server) Etherscan’s MCP [(Model Context Protocol)](https://modelcontextprotocol.io/) allows you to connect Etherscan and [60+ supported chain](https://docs.etherscan.io/supported-chains) data to your AI models such as ChatGPT, Claude. An ELI5, the MCP standard provides a list of tools that your model can call to lookup information via the Etherscan API. Yes, it is an API wrapper. This avoids common problem of LLMs making things up (hallucination) or getting blocked by captcha on a web search. Some use cases of our beta users * Comparing Solidity code with actual contracts deployed on chain * Customer support for bridge transactions, if the transactions has arrived * Portfolio management agents [​](https://docs.etherscan.io/mcp-docs/introduction#etherscan-mcp-server) Etherscan MCP Server ------------------------------------------------------------------------------------------------- We host a Streamable HTTP MCP server at Copy Ask AI https://mcp.etherscan.io/mcp You will need to authenticate using your Etherscan API key, as a bearer token in the header like Copy Ask AI Authorization: Bearer YourEtherscanApiKey ⌘I --- # Export Address Tags V2 - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation API Endpoints Export Address Tags V2 [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api-metadata.etherscan.io / v2 / api Try it Export Address Tags V2 cURL Copy Ask AI curl --request GET \ --url https://api-metadata.etherscan.io/v2/api Response Copy Ask AI "address";"nametag";"internal_nametag";"url";"shortdescription";"notes_1";"notes_2";"labels";"labels_slug";"reputation";"other_attributes";"lastupdatedtimestamp" "0x0000000000000000000000000000000000001111";"Fake_Phishing589039";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by HashDit.";"";"Phish / Hack";"phish-hack";"2";"";"1728292621" "0x00000000001adc2c0b202d0f72ad9d50f0675296";"Fake_Phishing1334182";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by BlockSec.";"";"Phish / Hack";"phish-hack";"2";"";"1757057505" "0x00000000006a2b6820feb8d5ac00cb6800795d8f";"Fake_Phishing326507";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418316" "0x0000000000d67e5d5f991a40f04ed40fa3b150df";"Fake_Phishing326508";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418362" "0x0000000000e7f7e18e6b7890ea1227ff088e6653";"Fake_Phishing686515";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by ScamSniffer.";"";"Phish / Hack";"phish-hack";"2";"";"1734599538" "0x00000000020e203eb8fc5d0724e7c93e6b002c71";"Fake_Phishing119146";"";"";"";"Warning! This address may be attempting to impersonate a similar looking address. Please proceed with caution.";"";"Phish / Hack";"phish-hack";"2";"";"1738570688" This is a PRO endpoint, available to the [Enterprise tier](https://etherscan.io/apis) This endpoint is throttled to 2 calls/s and 100 calls/day ### [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-chainid) chainid string default:"1" Chain ID to query, only `1` for Ethereum supported at the moment. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-module) module string default:"nametag" Set to `nametag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-action) action string default:"exportaddresstags" Set to `exportaddresstags` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-label) label string default:"ofac-sanctioned" Use the [Label Master List](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist) to discover categeories like `phish-hack`, or pass `all` to export every label. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2#param-format) format string default:"csv" The response format, either `.zip` or `.csv`. Response Copy Ask AI "address";"nametag";"internal_nametag";"url";"shortdescription";"notes_1";"notes_2";"labels";"labels_slug";"reputation";"other_attributes";"lastupdatedtimestamp" "0x0000000000000000000000000000000000001111";"Fake_Phishing589039";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by HashDit.";"";"Phish / Hack";"phish-hack";"2";"";"1728292621" "0x00000000001adc2c0b202d0f72ad9d50f0675296";"Fake_Phishing1334182";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by BlockSec.";"";"Phish / Hack";"phish-hack";"2";"";"1757057505" "0x00000000006a2b6820feb8d5ac00cb6800795d8f";"Fake_Phishing326507";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418316" "0x0000000000d67e5d5f991a40f04ed40fa3b150df";"Fake_Phishing326508";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418362" "0x0000000000e7f7e18e6b7890ea1227ff088e6653";"Fake_Phishing686515";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by ScamSniffer.";"";"Phish / Hack";"phish-hack";"2";"";"1734599538" "0x00000000020e203eb8fc5d0724e7c93e6b002c71";"Fake_Phishing119146";"";"";"";"Warning! This address may be attempting to impersonate a similar looking address. Please proceed with caution.";"";"Phish / Hack";"phish-hack";"2";"";"1738570688" [Get Label Master List V2](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2) [Get Label Master List](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist) ⌘I --- # Export Address Tags - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation API Endpoints Export Address Tags [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api-metadata.etherscan.io / v1 / api.ashx Try it Export Address Tags cURL Copy Ask AI curl --request GET \ --url https://api-metadata.etherscan.io/v1/api.ashx Response Copy Ask AI "address";"nametag";"internal_nametag";"url";"shortdescription";"notes_1";"notes_2";"labels";"labels_slug";"reputation";"other_attributes";"lastupdatedtimestamp" "0x0000000000000000000000000000000000001111";"Fake_Phishing589039";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by HashDit.";"";"Phish / Hack";"phish-hack";"2";"";"1728292621" "0x00000000001adc2c0b202d0f72ad9d50f0675296";"Fake_Phishing1334182";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by BlockSec.";"";"Phish / Hack";"phish-hack";"2";"";"1757057505" "0x00000000006a2b6820feb8d5ac00cb6800795d8f";"Fake_Phishing326507";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418316" "0x0000000000d67e5d5f991a40f04ed40fa3b150df";"Fake_Phishing326508";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418362" "0x0000000000e7f7e18e6b7890ea1227ff088e6653";"Fake_Phishing686515";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by ScamSniffer.";"";"Phish / Hack";"phish-hack";"2";"";"1734599538" "0x00000000020e203eb8fc5d0724e7c93e6b002c71";"Fake_Phishing119146";"";"";"";"Warning! This address may be attempting to impersonate a similar looking address. Please proceed with caution.";"";"Phish / Hack";"phish-hack";"2";"";"1738570688" This is a PRO endpoint, available to the [Enterprise tier](https://etherscan.io/apis) This endpoint is throttled to 2 calls/s and 100 calls/day ### [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#param-module) module string default:"nametag" Set to `nametag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#param-action) action string default:"exportaddresstags" Set to `exportaddresstags` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#param-label) label string default:"ofac-sanctioned" Use the [Label Master List](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist) to discover categeories like `phish-hack`, or pass `all` to export every label. [​](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags#param-format) format string default:"csv" The response format, currently only in `.csv`. Response Copy Ask AI "address";"nametag";"internal_nametag";"url";"shortdescription";"notes_1";"notes_2";"labels";"labels_slug";"reputation";"other_attributes";"lastupdatedtimestamp" "0x0000000000000000000000000000000000001111";"Fake_Phishing589039";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by HashDit.";"";"Phish / Hack";"phish-hack";"2";"";"1728292621" "0x00000000001adc2c0b202d0f72ad9d50f0675296";"Fake_Phishing1334182";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by BlockSec.";"";"Phish / Hack";"phish-hack";"2";"";"1757057505" "0x00000000006a2b6820feb8d5ac00cb6800795d8f";"Fake_Phishing326507";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418316" "0x0000000000d67e5d5f991a40f04ed40fa3b150df";"Fake_Phishing326508";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it.";"";"Phish / Hack";"phish-hack";"2";"";"1711418362" "0x0000000000e7f7e18e6b7890ea1227ff088e6653";"Fake_Phishing686515";"";"";"";"There are reports that this address was used in a Phishing scam. Please exercise caution when interacting with it. Reported by ScamSniffer.";"";"Phish / Hack";"phish-hack";"2";"";"1734599538" "0x00000000020e203eb8fc5d0724e7c93e6b002c71";"Fake_Phishing119146";"";"";"";"Warning! This address may be attempting to impersonate a similar looking address. Please proceed with caution.";"";"Phish / Hack";"phish-hack";"2";"";"1738570688" [Get Label Master List](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist) [Reputation Reference](https://docs.etherscan.io/metadata/reputation-reference) ⌘I --- # Get Address ERC721 Token Inventory by Contract - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Address ERC721 Token Inventory by Contract [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftinventory&address=0x123432244443b54409430979df8333f9308a6040&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",\ "TokenId": "453"\ },\ {\ "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",\ "TokenId": "8160"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-action) action string default:"addresstokennftinventory" Set to `addresstokennftinventory` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-address) address string default:"0x123432244443b54409430979df8333f9308a6040" Address to check for inventory. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-contractaddress) contractaddress string default:"0xed5af388653567af2f388e6224dc7c4b3241c544" ERC-721 token contract address to filter by. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory#param-offset) offset integer default:"100" Number of records per page. Limited to 1000 records per query; use the `page` parameter for subsequent records. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftinventory&address=0x123432244443b54409430979df8333f9308a6040&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544&page=1&offset=100&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",\ "TokenId": "453"\ },\ {\ "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",\ "TokenId": "8160"\ }\ ] } [Get Address ERC721 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance) [Get Plasma Deposits by Address](https://docs.etherscan.io/api-reference/endpoint/txnbridge) ⌘I --- # Get Native Balance for an Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/balance#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Native Balance for an Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Native Balance for an Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status":"1", "message":"OK", "result":"172774397764084972158218" } ### [​](https://docs.etherscan.io/api-reference/endpoint/balance#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-action) action string default:"balance" Set to `balance` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-address) address string default:"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe`. Up to 20 addresses can be queried, separated by commas. [​](https://docs.etherscan.io/api-reference/endpoint/balance#param-tag) tag string default:"latest" Use `latest` for the last block number of the chain. Also accepts a specific block number in hex format, like `0x10d4f` up to the last 128 blocks. For historical balances, use the [Historical Balance](https://docs.etherscan.io/api-reference/endpoint/balancehistory) endpoint. Response Copy Ask AI { "status":"1", "message":"OK", "result":"172774397764084972158218" } [V2 Migration](https://docs.etherscan.io/v2-migration) [Get Historical Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balancehistory) ⌘I --- # Get Label Master List V2 - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation API Endpoints Get Label Master List V2 [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api-metadata.etherscan.io / v2 / api Try it Get Label Master List V2 cURL Copy Ask AI curl --request GET \ --url https://api-metadata.etherscan.io/v2/api Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "labelname":"Axelar",\ "labelslug":"axelar",\ "shortdescription":"Axelar delivers secure cross-chain communication for Web3. Its infrastructure enables dApp users to interact with any asset or application, on any chain, with one click. Axelar is an overlay network, delivering Turing-complete message passing via proof-of-stake and permissionless protocols.",\ "notes":"",\ "lastupdatedtimestamp":1712897117\ },\ {\ "labelname":"Binance",\ "labelslug":"binance",\ "shortdescription":"Binance is one of the world’s leading blockchain ecosystems, with a product suite that includes the largest digital asset exchange.",\ "notes":"",\ "lastupdatedtimestamp":1759922816\ }\ ] } This is a PRO endpoint, available to the [Enterprise tier](https://etherscan.io/apis) ### [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#param-chainid) chainid string default:"1" Chain ID to query, only `1` for Ethereum supported at the moment. [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#param-module) module string default:"nametag" Set to `nametag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2#param-action) action string default:"getlabelmasterlist" Set to `getlabelmasterlist` for this endpoint. Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "labelname":"Axelar",\ "labelslug":"axelar",\ "shortdescription":"Axelar delivers secure cross-chain communication for Web3. Its infrastructure enables dApp users to interact with any asset or application, on any chain, with one click. Axelar is an overlay network, delivering Turing-complete message passing via proof-of-stake and permissionless protocols.",\ "notes":"",\ "lastupdatedtimestamp":1712897117\ },\ {\ "labelname":"Binance",\ "labelslug":"binance",\ "shortdescription":"Binance is one of the world’s leading blockchain ecosystems, with a product suite that includes the largest digital asset exchange.",\ "notes":"",\ "lastupdatedtimestamp":1759922816\ }\ ] } [Introduction](https://docs.etherscan.io/metadata/introduction) [Export Address Tags V2](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2) ⌘I --- # Reputation Reference - Etherscan [Skip to main content](https://docs.etherscan.io/metadata/reputation-reference#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Resources Reputation Reference [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) | Score | Description | | --- | --- | | 0 | ’UNKNOWN’ (default) | | 1 | ’OK’ An OK reputation is not an endorsement but likely a known/public entity. | | 2 | ’CAUTION’ Moderate Caution Advised when interacting with the address. | | 3 | ’UNSAFE’ Extreme caution advised when interacting with the address. | [Export Address Tags](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags) [Other Attributes Reference](https://docs.etherscan.io/metadata/other-attributes-reference) ⌘I --- # Get Ethereum Daily Total Gas Used - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailygasused#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Gas Tracker Get Ethereum Daily Total Gas Used [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailygasused&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "gasUsed": "32761450415"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "gasUsed": "30168904532"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-action) action string default:"dailygasused" Set to `dailygasused` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailygasused#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailygasused&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "gasUsed": "32761450415"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "gasUsed": "30168904532"\ }\ ] } [Get Daily Average Gas Limit](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit) [Get Daily Average Gas Price](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice) ⌘I --- # Introduction - Etherscan [Skip to main content](https://docs.etherscan.io/metadata/introduction#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Introduction [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) The Metadata CSV export is an Enterprise feature that allows dataset exports of [labels](https://etherscan.io/labelcloud/) , name tags, and other metadata related to an address. This export currently supports Ethereum only, with other chains to follow. [Contact us](https://docs.etherscan.io/cdn-cgi/l/email-protection#d6b7a6bfa5a3a6a6b9a4a296b3a2beb3a4a5b5b7b8f8bfb9) to for more info and to book a demo. [Get Label Master List V2](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2) ⌘I --- # Get Daily Average Gas Limit - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Gas Tracker Get Daily Average Gas Limit [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavggaslimit&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "gasLimit": "8001360"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "gasLimit": "8001269"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-action) action string default:"dailyavggaslimit" Set to `dailyavggaslimit` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavggaslimit&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "gasLimit": "8001360"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "gasLimit": "8001269"\ }\ ] } [Get Gas Oracle](https://docs.etherscan.io/api-reference/endpoint/gasoracle) [Get Ethereum Daily Total Gas Used](https://docs.etherscan.io/api-reference/endpoint/dailygasused) ⌘I --- # Other Attributes Reference - Etherscan [Skip to main content](https://docs.etherscan.io/metadata/other-attributes-reference#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Resources Other Attributes Reference [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) | Header | Description | | --- | --- | | TT | Token Type. Types: `erc-20` and `nft`. | | TR | Token Reputation. Types: `Ok`, `Poor`, `Unsafe`, `Suspicious`, `Spam`, and `BrandInfringement`. | | SC | Verified Smart Contract. | | CN | Contract Name. | | ENS | Ethereum Name Service. | [Reputation Reference](https://docs.etherscan.io/metadata/reputation-reference) ⌘I --- # Get Historical Native Balance for an Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/balancehistory#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Historical Native Balance for an Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Get Historical Native Balance for an Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "610538078574759898951277" } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-action) action string default:"balancehistory" Set to `balancehistory` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-address) address string default:"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe`. [​](https://docs.etherscan.io/api-reference/endpoint/balancehistory#param-blockno) blockno integer default:"8000000" Block number to check balance at, all the way up to the genesis block `0`. Response Copy Ask AI { "status": "1", "message": "OK", "result": "610538078574759898951277" } [Get Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balance) [Get Normal Transactions By Address](https://docs.etherscan.io/api-reference/endpoint/txlist) ⌘I --- # Get Label Master List - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation API Endpoints Get Label Master List [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api-metadata.etherscan.io / v1 / api.ashx Try it Get Label Master List cURL Copy Ask AI curl --request GET \ --url https://api-metadata.etherscan.io/v1/api.ashx Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "labelname":"Axelar",\ "labelslug":"axelar",\ "shortdescription":"Axelar delivers secure cross-chain communication for Web3. Its infrastructure enables dApp users to interact with any asset or application, on any chain, with one click. Axelar is an overlay network, delivering Turing-complete message passing via proof-of-stake and permissionless protocols.",\ "notes":"",\ "lastupdatedtimestamp":1712897117\ },\ {\ "labelname":"Binance",\ "labelslug":"binance",\ "shortdescription":"Binance is one of the world’s leading blockchain ecosystems, with a product suite that includes the largest digital asset exchange.",\ "notes":"",\ "lastupdatedtimestamp":1759922816\ }\ ] } This is a PRO endpoint, available to the [Enterprise tier](https://etherscan.io/apis) ### [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist#param-module) module string default:"nametag" Set to `nametag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist#param-action) action string default:"getlabelmasterlist" Set to `getlabelmasterlist` for this endpoint. Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "labelname":"Axelar",\ "labelslug":"axelar",\ "shortdescription":"Axelar delivers secure cross-chain communication for Web3. Its infrastructure enables dApp users to interact with any asset or application, on any chain, with one click. Axelar is an overlay network, delivering Turing-complete message passing via proof-of-stake and permissionless protocols.",\ "notes":"",\ "lastupdatedtimestamp":1712897117\ },\ {\ "labelname":"Binance",\ "labelslug":"binance",\ "shortdescription":"Binance is one of the world’s leading blockchain ecosystems, with a product suite that includes the largest digital asset exchange.",\ "notes":"",\ "lastupdatedtimestamp":1759922816\ }\ ] } [Export Address Tags V2](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags-v2) [Export Address Tags](https://docs.etherscan.io/api-reference/endpoint/exportaddresstags) ⌘I --- # Get Daily Average Gas Price - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Gas Tracker Get Daily Average Gas Price [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavggasprice&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "maxGasPrice_Wei": "60814303896257",\ "minGasPrice_Wei": "432495",\ "avgGasPrice_Wei": "13234562600"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "maxGasPrice_Wei": "20000000000000",\ "minGasPrice_Wei": "2352",\ "avgGasPrice_Wei": "12000569516"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-action) action string default:"dailyavggasprice" Set to `dailyavggasprice` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavggasprice&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "maxGasPrice_Wei": "60814303896257",\ "minGasPrice_Wei": "432495",\ "avgGasPrice_Wei": "13234562600"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "maxGasPrice_Wei": "20000000000000",\ "minGasPrice_Wei": "2352",\ "avgGasPrice_Wei": "12000569516"\ }\ ] } [Get Ethereum Daily Total Gas Used](https://docs.etherscan.io/api-reference/endpoint/dailygasused) [eth\_blockNumber](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber) ⌘I --- # Get Daily Block Rewards - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Daily Block Rewards [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyblockrewards&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockRewards_Eth": "15300.65625"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockRewards_Eth": "15611.625"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-action) action string default:"dailyblockrewards" Set to `dailyblockrewards` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards#param-sort) sort string default:"desc" Sort order, either `asc` or `desc`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyblockrewards&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockRewards_Eth": "15300.65625"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockRewards_Eth": "15611.625"\ }\ ] } [Get Daily Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount) [Get Daily Average Block Time](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime) ⌘I --- # Get Ethereum Nodes Size - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/chainsize#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Ethereum Nodes Size [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=chainsize&startdate=2019-02-01&enddate=2019-02-28&clienttype=geth&syncmode=default&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "7156164",\ "chainTimeStamp": "2019-02-01",\ "chainSize": "184726421279",\ "clientType": "Geth",\ "syncMode": "Default"\ },\ {\ "blockNumber": "7161012",\ "chainTimeStamp": "2019-02-02",\ "chainSize": "184726654448",\ "clientType": "Geth",\ "syncMode": "Default"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-action) action string default:"chainsize" Set to `chainsize` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-clienttype) clienttype string default:"geth" Node client to query, either `geth` or `parity`. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-syncmode) syncmode string default:"default" Node type to run, either `default` or `archive`. [​](https://docs.etherscan.io/api-reference/endpoint/chainsize#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=chainsize&startdate=2019-02-01&enddate=2019-02-28&clienttype=geth&syncmode=default&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "7156164",\ "chainTimeStamp": "2019-02-01",\ "chainSize": "184726421279",\ "clientType": "Geth",\ "syncMode": "Default"\ },\ {\ "blockNumber": "7161012",\ "chainTimeStamp": "2019-02-02",\ "chainSize": "184726654448",\ "clientType": "Geth",\ "syncMode": "Default"\ }\ ] } [Get Ether Last Price](https://docs.etherscan.io/api-reference/endpoint/ethprice) [Get Total Nodes Count](https://docs.etherscan.io/api-reference/endpoint/nodecount) ⌘I --- # Get Daily Average Block Size - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Daily Average Block Size [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgblocksize&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockSize_bytes": 20373\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockSize_bytes": 17499\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-action) action string default:"dailyavgblocksize" Set to `dailyavgblocksize` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize#param-sort) sort string default:"desc" Sort order, either `asc` or `desc`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgblocksize&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockSize_bytes": 20373\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockSize_bytes": 17499\ }\ ] } [Get Block Number by Timestamp](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime) [Get Daily Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount) ⌘I --- # Get Daily Block Count and Rewards - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Daily Block Count and Rewards [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockCount": 4848,\ "blockRewards_Eth": "14929.464690870590355682"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockCount": 4935,\ "blockRewards_Eth": "15120.386084685869906669"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-action) action string default:"dailyblkcount" Set to `dailyblkcount` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount#param-sort) sort string default:"desc" Sort order, either `asc` or `desc`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockCount": 4848,\ "blockRewards_Eth": "14929.464690870590355682"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockCount": 4935,\ "blockRewards_Eth": "15120.386084685869906669"\ }\ ] } [Get Daily Average Block Size](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize) [Get Daily Block Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards) ⌘I --- # Check Proxy Contract Verification Status - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Check Proxy Contract Verification Status [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Check Proxy Contract Verification Status cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "0", "message": "NOTOK", "result": "The proxy contract at 0xcbdcd3815b5f975e1a2c944a9b2cd1c985a1cb7f does not seem to be verified. Please verify and publish the contract source before proceeding with this proxy verification." } ### [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#param-action) action string default:"checkproxyverification" Set to `checkproxyverification` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification#param-guid) guid string The GUID received from the proxy verification request. Response Copy Ask AI { "status": "0", "message": "NOTOK", "result": "The proxy contract at 0xcbdcd3815b5f975e1a2c944a9b2cd1c985a1cb7f does not seem to be verified. Please verify and publish the contract source before proceeding with this proxy verification." } [Verify Proxy Contract](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract) [Get Estimation of Confirmation Time](https://docs.etherscan.io/api-reference/endpoint/gasestimate) ⌘I --- # Get Daily Average Block Time - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Daily Average Block Time [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgblocktime&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockTime_sec": "17.67"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockTime_sec": "17.41"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-action) action string default:"dailyavgblocktime" Set to `dailyavgblocktime` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime#param-sort) sort string default:"desc" Sort order, either `asc` or `desc`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgblocktime&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "blockTime_sec": "17.67"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "blockTime_sec": "17.41"\ }\ ] } [Get Daily Block Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards) [Get Daily Uncle Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount) ⌘I --- # Check Source Code Verification Status - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Check Source Code Verification Status [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Check Source Code Verification Status cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "Pass - Verified" } ### [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#param-action) action string default:"checkverifystatus" Set to `checkverifystatus` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus#param-guid) guid string The GUID received from the verification request. Response Copy Ask AI { "status": "1", "message": "OK", "result": "Pass - Verified" } [Verify Stylus Source Code](https://docs.etherscan.io/api-reference/endpoint/verifystylus) [Verify Proxy Contract](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract) ⌘I --- # Get Daily Uncle Block Count and Rewards - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Daily Uncle Block Count and Rewards [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyuncleblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "uncleBlockCount": 287,\ "uncleBlockRewards_Eth": "729.75"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "uncleBlockCount": 304,\ "uncleBlockRewards_Eth": "778.125"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-action) action string default:"dailyuncleblkcount" Set to `dailyuncleblkcount` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount#param-sort) sort string default:"desc" Sort order, either `asc` or `desc`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyuncleblkcount&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "uncleBlockCount": 287,\ "uncleBlockRewards_Eth": "729.75"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "uncleBlockCount": 304,\ "uncleBlockRewards_Eth": "778.125"\ }\ ] } [Get Daily Average Block Time](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime) [Get Contract ABI](https://docs.etherscan.io/api-reference/endpoint/getabi) ⌘I --- # Verify with Remix - Etherscan [Skip to main content](https://docs.etherscan.io/contract-verification/verify-with-remix#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contract Verification Verify with Remix [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Activate](https://docs.etherscan.io/contract-verification/verify-with-remix#activate) * [Add an API Key](https://docs.etherscan.io/contract-verification/verify-with-remix#add-an-api-key) * [Verify](https://docs.etherscan.io/contract-verification/verify-with-remix#verify) [**Remix**](https://remix.ethereum.org/) is a no-frills, just works in your browser Solidity development tool. [​](https://docs.etherscan.io/contract-verification/verify-with-remix#activate) Activate ------------------------------------------------------------------------------------------- Once you’ve written and deployed your contract, click on the **Plugin Manager** and select **Contract Verification**. ![Remix homepage](https://mintcdn.com/etherscan/T1KjV-_fSmvoQ9iv/images/remix.png?w=2500&fit=max&auto=format&n=T1KjV-_fSmvoQ9iv&q=85&s=3fc42f11016731a64178367bf92964ef) [​](https://docs.etherscan.io/contract-verification/verify-with-remix#add-an-api-key) Add an API Key ------------------------------------------------------------------------------------------------------- The Etherscan verification plugin requires an API key because grumpy bots yell at us on a daily basis. Click the β€œEnable” link and add your key, leave the rest as default. ![Remix add key](https://mintcdn.com/etherscan/T1KjV-_fSmvoQ9iv/images/remix-add-key.png?w=2500&fit=max&auto=format&n=T1KjV-_fSmvoQ9iv&q=85&s=cdae9fb3610e98a915375504f21daf6a) [​](https://docs.etherscan.io/contract-verification/verify-with-remix#verify) Verify --------------------------------------------------------------------------------------- Fill in the chain, contract address, and contract name that you deployed. Now that the Etherscan checkbox is enabled, click Verify. Without this, the contract won’t show as verified on Etherscan’s explorer. ![Remix verify](https://mintcdn.com/etherscan/T1KjV-_fSmvoQ9iv/images/remix-verify.avif?w=2500&fit=max&auto=format&n=T1KjV-_fSmvoQ9iv&q=85&s=b644174694c9aeae0bd7d25c87b453d0) Once verified, you will see a happy green βœ…. ![Remix verified](https://mintcdn.com/etherscan/T1KjV-_fSmvoQ9iv/images/remix-verified.avif?w=2500&fit=max&auto=format&n=T1KjV-_fSmvoQ9iv&q=85&s=dcfc0914ab9dacc0e07ee2a734e73144) > _This open source integration was shipped by_ [**@manuelwedler**](https://github.com/manuelwedler) > _and the Remix team_. [Verify with Hardhat](https://docs.etherscan.io/contract-verification/verify-with-hardhat) [Common Verification Errors](https://docs.etherscan.io/contract-verification/common-verification-errors) ⌘I --- # Common Verification Errors - Etherscan [Skip to main content](https://docs.etherscan.io/contract-verification/common-verification-errors#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contract Verification Common Verification Errors [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Contract Doesn’t Match](https://docs.etherscan.io/contract-verification/common-verification-errors#contract-doesn%E2%80%99t-match) * [Solidity Compilation Error](https://docs.etherscan.io/contract-verification/common-verification-errors#solidity-compilation-error) * [Contract Not Deployed](https://docs.etherscan.io/contract-verification/common-verification-errors#contract-not-deployed) * [Missing or Invalid Library Names](https://docs.etherscan.io/contract-verification/common-verification-errors#missing-or-invalid-library-names) * [Missing Contract Name](https://docs.etherscan.io/contract-verification/common-verification-errors#missing-contract-name) * [Missing/Invalid Constructor Arguments](https://docs.etherscan.io/contract-verification/common-verification-errors#missing%2Finvalid-constructor-arguments) * [Mismatched bytecode metadata hash](https://docs.etherscan.io/contract-verification/common-verification-errors#mismatched-bytecode-metadata-hash) * [Similar Match Found](https://docs.etherscan.io/contract-verification/common-verification-errors#similar-match-found) * [Unsupported Solc Version](https://docs.etherscan.io/contract-verification/common-verification-errors#unsupported-solc-version) * [Source Code Already Verified](https://docs.etherscan.io/contract-verification/common-verification-errors#source-code-already-verified) * [Unsupported File Import Callback](https://docs.etherscan.io/contract-verification/common-verification-errors#unsupported-file-import-callback) * [Temporary Error](https://docs.etherscan.io/contract-verification/common-verification-errors#temporary-error) ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#contract-doesn%E2%80%99t-match) Contract Doesn’t Match β€œCompiled contract deployment bytecode does NOT match the transaction deployment bytecode” The submitted source code does not match the contract code deployed on chain. Common causes include using a different compiler version or enabling optimisation runs. For an exact match to be found, both **source code** and **compiler settings** specified have to exactly match the deployment conditions, for the same bytecode to be reproduced. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#solidity-compilation-error) Solidity Compilation Error β€œSolidity Compilation Error: Identifier not found or not unique” A compilation issue occured due to syntax errors in your Solidity source code. Consider debugging your contract with any compiler such as [**Remix**](https://remix.ethereum.org/) or [**Hardhat**](https://hardhat.org/) and reference the error from Solidity’s [**official documentation**](https://docs.soliditylang.org/) . ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#contract-not-deployed) Contract Not Deployed β€œUnable to locate ContractCode at 0x539a277b12a3f6723f4c1769edb11b0be7c214da” The contract has not been deployed at the specific address at the specific chain. Check the contract address you’ve deployed, if your contract deployment transaction has succeeded or if the [**chainId**](https://docs.etherscan.io/supported-chains) specified is correct. We usually pick up deployments within a few blocks from the chaintip, this will be delayed if the chain is having high activity. But no more than a few mins, [**ping us**](https://docs.etherscan.io/resources/contact-us) if you’ve verified the contract is deployed with the Etherscan link. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#missing-or-invalid-library-names) Missing or Invalid Library Names β€œLibrary was required but suitable match not found” A [**library**](https://solidity-by-example.org/library/) was used in your contract deployment, but was not specified, misspelt or using the wrong library address. Double check on your library names ( **case sensitive** such as β€œPRBMath” ) or ensure that a matching library name and library address is provided. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#missing-contract-name) Missing Contract Name β€œUnable to locate ContractName , did you specify the correct Contract Name ?” A match was not found with the name of the contract specified when multiple files are provided. Ensure that you have provided the correct contract name to be matched against, and making sure you submit the **main contract** name not its dependencies. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#missing/invalid-constructor-arguments) Missing/Invalid Constructor Arguments β€œPlease check if the correct constructor argument was entered” if your contract utilized the `constructor` keyword, you should provide it in hex format. Otherwise, leave this field empty as it is. You may reference your original deployment’s constructor arguments or determine it from the [**end of your compiled bytecode**](https://info.etherscan.com/contract-verification-constructor-arguments/) . ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#mismatched-bytecode-metadata-hash) Mismatched bytecode metadata hash β€œPlease check if the correct bytecodehash was specified via standard-json verification.” The [**metadata hash**](https://docs.soliditylang.org/en/v0.8.17/metadata.html#encoding-of-the-metadata-hash-in-the-bytecode) settings of your submitted source code differs from the settings of your original contract deployment, such as being set to `ipfs` or `none`. Submit your contract verification using the solc json input format, and [**specify the settings**](https://github.com/PaulRBerg/hardhat-template/blob/f6406c4e7c9e23d5169b39fb11d528a975b678e6/hardhat.config.ts#L104) accordingly there. Other submission formats such as single file or multifile **do not support** changing this setting, and will use the compiler defaults. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#similar-match-found) Similar Match Found β€œThis contract already Similar Matches the deployed ByteCode at 0x4200000000000000000000000000000000000042” This error indicates that the contract has already been verified via [**Similar Match**](https://info.etherscan.com/types-of-contract-verification/) to another contract. Kindly [**reach out**](https://info.etherscan.com/update-on-similar-match-contract-verification/) to us at this point of time to have this updated to Full Match if required. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#unsupported-solc-version) Unsupported Solc Version β€œInvalid or not supported solc version, see [https://etherscan.io/solcversions](https://etherscan.io/solcversions) for list” This error is thrown when you specify to use an invalid or unsupported version of the Solidity Compiler ie. below `v0.4.11-nightly.2017.3.15+`. Do [**let us know**](https://docs.etherscan.io/resources/contact-us) if you need to verify a contract below this supported version such as to prove you deployed the first NFT. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#source-code-already-verified) Source Code Already Verified β€œSource code already verified” An [**Exact Match**](https://info.etherscan.com/types-of-contract-verification/) has been obtained, get back to having your [**coffee**](https://media.giphy.com/media/11ISwbgCxEzMyY/giphy.gif) . If you think this might be a mistake, do check if you’ve submitted verification to the right **explorer/chain**, a contract that is verified on Etherscan is **not automatically verified** on other explorers. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#unsupported-file-import-callback) Unsupported File Import Callback β€œSource β€œ@openzeppelin/contracts/ERC20.sol” not found: File import callback not supported” This error is thrown when contracts reference imports from external sources, such as [**OpenZeppelin**](https://docs.openzeppelin.com/) libraries or Github links. Consider [**flattening**](https://hardhat.org/hardhat-runner/docs/advanced/flattening#flattening-your-contracts) your source code into a single file, or use the Solidity Standard Json Input format that comes with tools such as [**Hardhat**](https://hardhat.org/hardhat-runner/docs/guides/verifying#verifying-your-contracts) to resolve these external imports. ### [​](https://docs.etherscan.io/contract-verification/common-verification-errors#temporary-error) Temporary Error β€œThis could be a temporary error, please retry or contact us (Error Code 10001/10002/10003)” Something went wrong on our end, which could include downtime or [**maintenance**](https://etherscan.freshstatus.io/) windows. Please retry this in a while or [**ping us**](https://docs.etherscan.io/resources/contact-us) if this continues to persist. [Verify with Remix](https://docs.etherscan.io/contract-verification/verify-with-remix) [PRO Endpoints](https://docs.etherscan.io/resources/pro-endpoints) ⌘I --- # Common Error Messages - Etherscan [Skip to main content](https://docs.etherscan.io/resources/common-error-messages#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Resources Common Error Messages [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Missing or Unsupported Chain](https://docs.etherscan.io/resources/common-error-messages#missing-or-unsupported-chain) * [Invalid API Key](https://docs.etherscan.io/resources/common-error-messages#invalid-api-key) * [Max rate limit](https://docs.etherscan.io/resources/common-error-messages#max-rate-limit) * [Missing or invalid action](https://docs.etherscan.io/resources/common-error-messages#missing-or-invalid-action) * [Endpoint-specific errors](https://docs.etherscan.io/resources/common-error-messages#endpoint-specific-errors) * [Query Timeout](https://docs.etherscan.io/resources/common-error-messages#query-timeout) * [Free Tier Access](https://docs.etherscan.io/resources/common-error-messages#free-tier-access) An API call that encounters an error will return 0 as its `status code` and display the cause of the error under the `result` field. Copy Ask AI { "status": "0", "message": "NOTOK", "result": "Max rate limit reached, please use API Key for higher rate limit" } ### [​](https://docs.etherscan.io/resources/common-error-messages#missing-or-unsupported-chain) Missing or Unsupported Chain β€œMissing or unsupported chainid parameter (required for v2 api), please see chainlist for the list of supported chainids” The chain you’ve specified is not supported by us yet. It could also be that you’ve sent multiple chains at the same time like `420,10`, you can only send **one** at a time. ### [​](https://docs.etherscan.io/resources/common-error-messages#invalid-api-key) Invalid API Key β€œInvalid API Key” This error occurs when you specify an invalid API Key. Ensure you are using your **Etherscan API Key**, keys from other chains like Polygonscan/Arbiscan are not valid for V2. Keys do take a few minutes to activate, anything longer than should be alarming. ### [​](https://docs.etherscan.io/resources/common-error-messages#max-rate-limit) Max rate limit β€œMax rate limit reached, please use API Key for higher rate limit” This error occurs when you **exceed the rate limit** assigned to your specific API key. To resolve, adhere to the [rate limits](https://docs.etherscan.io/resources/rate-limits) of your available plan. If you are using a script or application, **apply throttling** like a token bucket to limit the frequency of calls. ### [​](https://docs.etherscan.io/resources/common-error-messages#missing-or-invalid-action) Missing or invalid action β€œError! Missing Or invalid Action name” This error occurs when you **do not specify**, or specify an **invalid** `module` and `action` name. To resolve, **double check** your API query to use a valid module and action name. If you require some help getting started, try copying the sample queries provided in the API Playground and pasting them into your browser. ### [​](https://docs.etherscan.io/resources/common-error-messages#endpoint-specific-errors) Endpoint-specific errors β€œError! Block number already passβ€β€œError! Invalid address formatβ€β€œContract source code not verified” These error messages returned are specific to certain endpoints and their **related parameters.** To resolve, kindly refer to the specific endpoint’s documentation, and check for the **correct format** or **values** to be specified as **parameters.** ### [​](https://docs.etherscan.io/resources/common-error-messages#query-timeout) Query Timeout β€œQuery Timeout occured. Please select a smaller result datasetβ€β€œUnexpected err, timeout occurred or server too busy. Please try again later” This error occurs when you have sent a particularly large query that did not manage to be completed in time. To resolve, consider selecting a smaller date/block range, though you may [**ping us**](https://docs.etherscan.io/resources/contact-us) if you think the issue may be performance related. ### [​](https://docs.etherscan.io/resources/common-error-messages#free-tier-access) Free Tier Access β€œFree API access is not supported for this chain. Please upgrade your api plan for full chain coverage.” Certain chains are not included under the Free tier. To access all [**supported networks**](https://docs.etherscan.io/supported-chains) , you may upgrade to any of our [**paid plans**](https://etherscan.io/apis) , check out the affordable Lite tier. [PRO Endpoints](https://docs.etherscan.io/resources/pro-endpoints) [Contact Us](https://docs.etherscan.io/resources/contact-us) ⌘I --- # Contact Us - Etherscan [Skip to main content](https://docs.etherscan.io/resources/contact-us#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Resources Contact Us [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Support Tickets](https://docs.etherscan.io/resources/contact-us#support-tickets) * [Twitter](https://docs.etherscan.io/resources/contact-us#twitter) * [Freshstatus](https://docs.etherscan.io/resources/contact-us#freshstatus) Beware of **phishing attempts** and emails **impersonating the team** at Etherscan, we only communicate from the channels below. ### [​](https://docs.etherscan.io/resources/contact-us#support-tickets) Support Tickets Our emails always come from the domain **@etherscan.io**. Keep in mind that as a block explorer service, we **cannot cancel, refund or reverse transactions** as we do not process them. If your issues are related to transactions, you may find helpful articles over at the [**Etherscan Information Center.**](https://info.etherscan.com/) Reach out to us via a [**support ticket.**](https://etherscan.io/contactus) ### [​](https://docs.etherscan.io/resources/contact-us#twitter) Twitter For general updates, new feature releases and community support, keep in touch with us via Twitter. Follow us on [**Twitter.**](https://twitter.com/etherscan) ### [​](https://docs.etherscan.io/resources/contact-us#freshstatus) Freshstatus Announcements for ongoing and scheduled maintenance works that may affect certain services used. Check Etherscan’s [**network status.**](https://etherscan.freshstatus.io/) [Common Error Messages](https://docs.etherscan.io/resources/common-error-messages) ⌘I --- # Get Daily Average Network Difficulty - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily Average Network Difficulty [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgnetdifficulty&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkDifficulty": "2,408.028"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkDifficulty": "2,358.910"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-action) action string default:"dailyavgnetdifficulty" Set to `dailyavgnetdifficulty` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavgnetdifficulty&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkDifficulty": "2,408.028"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkDifficulty": "2,358.910"\ }\ ] } [Get Daily Transaction Count](https://docs.etherscan.io/api-reference/endpoint/dailytx) [Get Ether Historical Price](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice) ⌘I --- # Get Daily Network Utilization - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily Network Utilization [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailynetutilization&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkUtilization": "0.8464"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkUtilization": "0.7687"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-action) action string default:"dailynetutilization" Set to `dailynetutilization` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailynetutilization&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkUtilization": "0.8464"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkUtilization": "0.7687"\ }\ ] } [Get Daily New Address Count](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress) [Get Daily Average Network Hash Rate](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate) ⌘I --- # Rate Limits - Etherscan [Skip to main content](https://docs.etherscan.io/resources/rate-limits#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Rate Limits [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) | API Tier | Rate Limit | API PRO | | --- | --- | --- | | Free | 3 calls/second, up to 100,000 calls/day, [selected chains](https://docs.etherscan.io/supported-chains)
only | Not Available | | Lite | 5 calls/second, up to 100,000 calls/day | Not Available | | Standard | 10 calls/second, up to 200,000 calls/day | Available | | Advanced | 20 calls/second, up to 500,000 calls/day | Available | | Professional | 30 calls/second, up to 1,000,000 calls/day | Available | | Pro Plus | 30 calls/second, up to 1,500,000 calls/day | Available | | Dedicated/Custom | [**Contact Us**](https://docs.etherscan.io/cdn-cgi/l/email-protection#9bfaebf2e8eeebebf4e9efdbfeeff3fee9e8f8faf5b5f2f4) | Available | [Supported Chains](https://docs.etherscan.io/supported-chains) [V2 Migration](https://docs.etherscan.io/v2-migration) ⌘I --- # Get Daily Average Network Hash Rate - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily Average Network Hash Rate [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavghashrate&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkHashRate": "143116.0140"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkHashRate": "143036.2313"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-action) action string default:"dailyavghashrate" Set to `dailyavghashrate` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailyavghashrate&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "networkHashRate": "143116.0140"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "networkHashRate": "143036.2313"\ }\ ] } [Get Daily Network Utilization](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization) [Get Daily Transaction Count](https://docs.etherscan.io/api-reference/endpoint/dailytx) ⌘I --- # Get Nametag (Metadata) for an Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Nametags Get Nametag (Metadata) for an Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Get Nametag (Metadata) for an Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api/v2/api Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "address":"0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",\ "nametag":"Coinbase 10",\ "internal_nametag":"",\ "url":"https://coinbase.com",\ "shortdescription":"",\ "notes_1":"",\ "notes_2":"",\ "labels":[\ "Coinbase",\ "Exchange"\ ],\ "labels_slug":[\ "coinbase",\ "exchange"\ ],\ "reputation":0,\ "other_attributes":[\ \ ],\ "lastupdatedtimestamp":1721899658\ }\ ] } This is a PRO endpoint and is available exclusively to the [Pro Plus tier](https://etherscan.io/apis) . This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#param-module) module string default:"nametag" Set to `nametag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#param-action) action string default:"getaddresstag" Set to `getaddresstag` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getaddresstag#param-address) address string default:"0x0000db5C8B030AE20308AC975898E09741E70000" The address to query, like `0x0000db5C8B030AE20308AC975898E09741E70000`. Response Copy Ask AI { "status":"1", "message":"OK", "result":[\ {\ "address":"0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",\ "nametag":"Coinbase 10",\ "internal_nametag":"",\ "url":"https://coinbase.com",\ "shortdescription":"",\ "notes_1":"",\ "notes_2":"",\ "labels":[\ "Coinbase",\ "Exchange"\ ],\ "labels_slug":[\ "coinbase",\ "exchange"\ ],\ "reputation":0,\ "other_attributes":[\ \ ],\ "lastupdatedtimestamp":1721899658\ }\ ] } [Get Withdrawal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs) [Chainlist](https://docs.etherscan.io/api-reference/endpoint/chainlist) ⌘I --- # Check Transaction Receipt Status - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Transactions Check Transaction Receipt Status [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=transaction&action=gettxreceiptstatus&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "status": "1" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#param-module) module string default:"transaction" Set to `transaction` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#param-action) action string default:"gettxreceiptstatus" Set to `gettxreceiptstatus` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus#param-txhash) txhash string Transaction hash to check the receipt status. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=transaction&action=gettxreceiptstatus&txhash=0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "status": "1" } } [Check Contract Execution Status](https://docs.etherscan.io/api-reference/endpoint/getstatus) [Get ERC20-Token TotalSupply by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokensupply) ⌘I --- # V2 Migration - Etherscan [Skip to main content](https://docs.etherscan.io/v2-migration#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started V2 Migration [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [How to Migrate](https://docs.etherscan.io/v2-migration#how-to-migrate) [Contract verification](https://docs.etherscan.io/contract-verification/verify-with-foundry) using Hardhat/Remix/Foundry also support using a single Etherscan API key for all chains As ofΒ **August 15th, 2025**, the legacyΒ **Etherscan API V1 endpoints have been deprecated**Β in favor of the newΒ **Etherscan API V2**, which introduces a unified multichain experience across 60+ supported networks 🌈. You’ll see a deprecation error message like this if you’re still using V1: Copy Ask AI { "status":"0", "message":"NOTOK", "result":"You are using a deprecated V1 endpoint, switch to Etherscan API V2." } All existing endpoints remain compatible once you update them to theΒ **V2 format**. ### [​](https://docs.etherscan.io/v2-migration#how-to-migrate) How to Migrate 1 Create an Etherscan account [**Sign up**](https://etherscan.io/register) if you don’t have an account or if you’re using other explorers like BaseScan, BscScan, Polygonscan, etc. 2 Create an Etherscan API Key Under your Etherscan [**API dashboard**](https://etherscan.io/apidashboard) , create a new key. This key can be used to access allΒ [supported chains](https://docs.etherscan.io/supported-chains) Β under API V2. 3 Migrating Endpoints from Etherscan API V1 UseΒ `https://api.etherscan.io/v2/api`Β as yourΒ **base path**, and include aΒ `chainid`Β for your target network (e.g.,Β 1Β for Ethereum).Before (V1): Copy Ask AI https://api.etherscan.io/api?&action=balance&apikey=YourEtherscanApiKey After (V2): Copy Ask AI https://api.etherscan.io/v2/api?chainid=1&action=balance&apikey=YourEtherscanApiKey 4 Migrating Endpoints from Other Explorers Use the same base path (`https://api.etherscan.io/v2/api`) and include a `chainid` for the relevant chain from [this list](https://docs.etherscan.io/supported-chains) , in this case `137` for Polygon.Pass in your **Etherscan API key** instead of the old explorer-specific one.Before (PolygonScan V1): Copy Ask AI https://api.polygonscan.com/api?&action=balance&apikey=YourPolygonscanApiKey After (V2): Copy Ask AI https://api.etherscan.io/v2/api?chainid=137&action=balance&apikey=YourEtherscanApiKey [Rate Limits](https://docs.etherscan.io/resources/rate-limits) [Get Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balance) ⌘I --- # Verify with Hardhat - Etherscan [Skip to main content](https://docs.etherscan.io/contract-verification/verify-with-hardhat#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contract Verification Verify with Hardhat [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Install](https://docs.etherscan.io/contract-verification/verify-with-hardhat#install) * [Config](https://docs.etherscan.io/contract-verification/verify-with-hardhat#config) * [Deploy and Verify (using Hardhat Ignition)](https://docs.etherscan.io/contract-verification/verify-with-hardhat#deploy-and-verify-using-hardhat-ignition) * [Verify an Existing Contract](https://docs.etherscan.io/contract-verification/verify-with-hardhat#verify-an-existing-contract) * [Custom Chains](https://docs.etherscan.io/contract-verification/verify-with-hardhat#custom-chains) This guide covers Hardhat 3. There is an official [**migration guide**](https://hardhat.org/docs/hardhat3/migration) from the Hardhat team. [**Hardhat**](https://hardhat.org/) is a smart contracts development tool, perfect if you’re familiar with Javascript/Typescript. This assumes you already have a [**Hardhat 3 project**](https://hardhat.org/docs/getting-started) **,** setup, and you’re about to deploy and verify next. [​](https://docs.etherscan.io/contract-verification/verify-with-hardhat#install) Install ------------------------------------------------------------------------------------------- Via npm. Copy Ask AI npm add --save-dev @nomicfoundation/hardhat-verify [​](https://docs.etherscan.io/contract-verification/verify-with-hardhat#config) Config ----------------------------------------------------------------------------------------- In `hardhat.config.ts`, import the plugin at the top and add it to the list of `plugins`. Then, specify a `verify` config with your Etherscan API key. This key works for most [**supported chains**](https://docs.etherscan.io/supported-chains) , otherwise you need to define a CustomChain below. Copy Ask AI import { defineConfig } from "hardhat/config"; import hardhatVerify from "@nomicfoundation/hardhat-verify"; export default defineConfig({ plugins: [\ hardhatVerify,\ // ...other plugins...\ ], solidity: "0.8.28", networks: { sepolia: { url: configVariable("SEPOLIA_RPC_URL"), accounts: [configVariable("SEPOLIA_PRIVATE_KEY")], }, }, verify: { etherscan: { apiKey: "YourEtherscanApiKey", }, }, }); [​](https://docs.etherscan.io/contract-verification/verify-with-hardhat#deploy-and-verify-using-hardhat-ignition) Deploy and Verify (using Hardhat Ignition) --------------------------------------------------------------------------------------------------------------------------------------------------------------- Copy Ask AI npx hardhat ignition deploy ignition/modules/Counter.ts --network sepolia --verify [​](https://docs.etherscan.io/contract-verification/verify-with-hardhat#verify-an-existing-contract) Verify an Existing Contract ----------------------------------------------------------------------------------------------------------------------------------- Copy Ask AI npx hardhat verify --network sepolia 0xdCBdBAA8404554502B433106e62728B659aCfE3b [​](https://docs.etherscan.io/contract-verification/verify-with-hardhat#custom-chains) Custom Chains ------------------------------------------------------------------------------------------------------- For new chains that have an Etherscan explorer but isn’t supported with Hardhat defaults, you need to add both the `networks` and `chainDescriptor` in `hardhat.config.ts`. Copy Ask AI export default defineConfig({ // ... networks: { monadTestnet: { type: "http", chainType: "l1", url: configVariable("MONAD_TESTNET_RPC_URL"), accounts: [configVariable("MONAD_TESTNET_PRIVATE_KEY")], } }, chainDescriptors: { 10143: { name: "monadTestnet", blockExplorers: { etherscan: { name: "Monad Testnet Explorer", url: "https://testnet.monadscan.com", apiUrl: "https://api.etherscan.io/v2/api", }, }, } }, }); Use the same deploy and verify command as above, but with the updated `--network`. In this example for `monadTestnet` Copy Ask AI npx hardhat ignition deploy ignition/modules/Counter.ts --network monadTestnet --verify [Verify with Foundry](https://docs.etherscan.io/contract-verification/verify-with-foundry) [Verify with Remix](https://docs.etherscan.io/contract-verification/verify-with-remix) ⌘I --- # Get Daily New Address Count - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily New Address Count [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailynewaddress&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "newAddressCount": 54081\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "newAddressCount": 65152\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-action) action string default:"dailynewaddress" Set to `dailynewaddress` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailynewaddress&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "newAddressCount": 54081\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "newAddressCount": 65152\ }\ ] } [Get Daily Network Transaction Fee](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee) [Get Daily Network Utilization](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization) ⌘I --- # Get Daily Transaction Count - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailytx#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily Transaction Count [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailytx&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "transactionCount": 498856\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "transactionCount": 450314\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-action) action string default:"dailytx" Set to `dailytx` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailytx#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailytx&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "transactionCount": 498856\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "transactionCount": 450314\ }\ ] } [Get Daily Average Network Hash Rate](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate) [Get Daily Average Network Difficulty](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty) ⌘I --- # Get Daily Network Transaction Fee - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Daily Network Transaction Fee [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailytxnfee&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "transactionFee_Eth": "358.558440870590355682"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "transactionFee_Eth": "286.886084685869906669"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-action) action string default:"dailytxnfee" Set to `dailytxnfee` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailytxnfee&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "transactionFee_Eth": "358.558440870590355682"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "transactionFee_Eth": "286.886084685869906669"\ }\ ] } [Get Total Nodes Count](https://docs.etherscan.io/api-reference/endpoint/nodecount) [Get Daily New Address Count](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress) ⌘I --- # Get Withdrawal Transactions by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation L2 Deposits/Withdrawals Get Withdrawal Transactions by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=10&module=account&action=getwithdrawaltxs&address=0x80f3950a4d371c43360f292a4170624abd9eed03&page=1&offset=10&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "No transactions found", "result": [] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#query-parameters) Query Parameters This endpoint is only available for the Arbitrum and Optimism stack chains. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-chainid) chainid string default:"10" Chain ID to query, eg `10` for Optimism or `42161` for Arbitrum from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-action) action string default:"getwithdrawaltxs" Set to `getwithdrawaltxs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-address) address string default:"0x80f3950a4d371c43360f292a4170624abd9eed03" Address to check for cross-chain withdrawals from L2 to Ethereum. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-offset) offset integer default:"10" Number of records per page. [​](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=10&module=account&action=getwithdrawaltxs&address=0x80f3950a4d371c43360f292a4170624abd9eed03&page=1&offset=10&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "No transactions found", "result": [] } [Get Deposit Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs) [Get Nametag (Metadata) for an Address](https://docs.etherscan.io/api-reference/endpoint/getaddresstag) ⌘I --- # Get Gas Oracle - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/gasoracle#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Gas Tracker Get Gas Oracle [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasoracle&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "LastBlock": "23467872", "SafeGasPrice": "0.496839934", "ProposeGasPrice": "0.496840168", "FastGasPrice": "0.55411917", "suggestBaseFee": "0.496839934", "gasUsedRatio": "0.405942555555556,0.784013777777778,0.502624148542588,0.719479644444444,0.45673524947105" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/gasoracle#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/gasoracle#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/gasoracle#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/gasoracle#param-module) module string default:"gastracker" Set to `gastracker` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/gasoracle#param-action) action string default:"gasoracle" Set to `gasoracle` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasoracle&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "LastBlock": "23467872", "SafeGasPrice": "0.496839934", "ProposeGasPrice": "0.496840168", "FastGasPrice": "0.55411917", "suggestBaseFee": "0.496839934", "gasUsedRatio": "0.405942555555556,0.784013777777778,0.502624148542588,0.719479644444444,0.45673524947105" } } [Get Estimation of Confirmation Time](https://docs.etherscan.io/api-reference/endpoint/gasestimate) [Get Daily Average Gas Limit](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit) ⌘I --- # Check Contract Execution Status - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getstatus#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Transactions Check Contract Execution Status [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=transaction&action=getstatus&txhash=0x15f8e5ea1079d9a0bb04a4c58ae5fe7654b5b2b4463375ff7ffb490aa0032f3a&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "isError": "1", "errDescription": "Bad jump destination" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#param-module) module string default:"transaction" Set to `transaction` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#param-action) action string default:"getstatus" Set to `getstatus` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getstatus#param-txhash) txhash string Transaction hash to check the execution status. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=transaction&action=getstatus&txhash=0x15f8e5ea1079d9a0bb04a4c58ae5fe7654b5b2b4463375ff7ffb490aa0032f3a&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "isError": "1", "errDescription": "Bad jump destination" } } [Get Ether Historical Price](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice) [Check Transaction Receipt Status](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus) ⌘I --- # Verify with Foundry - Etherscan [Skip to main content](https://docs.etherscan.io/contract-verification/verify-with-foundry#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contract Verification Verify with Foundry [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Deploy and Verify](https://docs.etherscan.io/contract-verification/verify-with-foundry#deploy-and-verify) * [Verify an Existing Contract](https://docs.etherscan.io/contract-verification/verify-with-foundry#verify-an-existing-contract) * [Custom Chains](https://docs.etherscan.io/contract-verification/verify-with-foundry#custom-chains) Ensuring you’re using the latest version of Foundry, via `foundryup` [**Foundry**](https://book.getfoundry.sh/) is a tool that helps take the heat off smart contract development steps, including compiling, deploying and finally submitting your contract for verification. This assumes you already have a [**Foundry project**](https://getfoundry.sh/guides/project-setup/creating-a-new-project) **,** setup, and you’re about to deploy and verify next. [​](https://docs.etherscan.io/contract-verification/verify-with-foundry#deploy-and-verify) Deploy and Verify --------------------------------------------------------------------------------------------------------------- Copy Ask AI forge create --broadcast --rpc-url https://rpc.sepolia.ethpandaops.io --private-key YourPrivateKey src/ContractFile.sol:ContractName --verify --verifier etherscan --etherscan-api-key YourApiKeyToken [​](https://docs.etherscan.io/contract-verification/verify-with-foundry#verify-an-existing-contract) Verify an Existing Contract ----------------------------------------------------------------------------------------------------------------------------------- Copy Ask AI forge verify-contract --watch --chain sepolia 0x324eca20b358b18e48f2611f7452560ce3b3c1bb src/ContractFile.sol:ContractName --verifier etherscan --etherscan-api-key YourApiKeyToken [​](https://docs.etherscan.io/contract-verification/verify-with-foundry#custom-chains) Custom Chains ------------------------------------------------------------------------------------------------------- Most chains with an Etherscan explorer are supported using the `--chain` flag. For (very) new chains that aren’t natively supported by Foundry, you can use a custom `--verifier-url` Append the Etherscan V2 base path and the new chainId, in this example for Stable Testnet(2201). Copy Ask AI forge verify-contract 0x324eca20b358b18e48f2611f7452560ce3b3c1bb src/ContractFile.sol:ContractName --verifier etherscan --verifier-url "https://api.etherscan.io/v2/api?chainid=2201" --etherscan-api-key YourEtherscanApiKey --watch > _This open source integration was shipped by_ [_@iainnash_](https://github.com/iainnash) > _and the Foundry team_ [Chainlist](https://docs.etherscan.io/api-reference/endpoint/chainlist) [Verify with Hardhat](https://docs.etherscan.io/contract-verification/verify-with-hardhat) ⌘I --- # eth_call - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethcall#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_call [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_call&to=0xAEEF46DB4855E25702F8237E8f403FddcaF931C0&data=0x70a08231000000000000000000000000e16359506c028e51f16be38986ec5746251e9724&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x00000000000000000000000000000000000000000000000000601d8888141c00" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-action) action string default:"eth\_call" Set to `eth_call` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-to) to string default:"0xAEEF46DB4855E25702F8237E8f403FddcaF931C0" The address to interact with. [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-data) data string Hash of the method signature and encoded parameters. [​](https://docs.etherscan.io/api-reference/endpoint/ethcall#param-tag) tag string default:"latest" Use `latest`, `earliest`, `pending`, or a block number in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_call&to=0xAEEF46DB4855E25702F8237E8f403FddcaF931C0&data=0x70a08231000000000000000000000000e16359506c028e51f16be38986ec5746251e9724&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x00000000000000000000000000000000000000000000000000601d8888141c00" } [eth\_getTransactionReceipt](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt) [eth\_getCode](https://docs.etherscan.io/api-reference/endpoint/ethgetcode) ⌘I --- # Get Ether Historical Price - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Ether Historical Price [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethdailyprice&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "value": "107.03"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "value": "111.00"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-action) action string default:"ethdailyprice" Set to `ethdailyprice` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-startdate) startdate string default:"2019-02-01" Starting date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-enddate) enddate string default:"2019-02-28" Ending date in `yyyy-MM-dd` format. [​](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice#param-sort) sort string default:"desc" Sort order either `desc` for the latest results first or `asc` for the oldest results first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethdailyprice&startdate=2019-02-01&enddate=2019-02-28&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "UTCDate": "2019-02-01",\ "unixTimeStamp": "1548979200",\ "value": "107.03"\ },\ {\ "UTCDate": "2019-02-02",\ "unixTimeStamp": "1549065600",\ "value": "111.00"\ }\ ] } [Get Daily Average Network Difficulty](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty) [Check Contract Execution Status](https://docs.etherscan.io/api-reference/endpoint/getstatus) ⌘I --- # Get Event Logs by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getlogs#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Logs Get Event Logs by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8&fromBlock=12878196&toBlock=12878196&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x0000000000000000000000000000000000000000000000000000000000000000",\ "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ },\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x1",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-module) module string default:"logs" Set to `logs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-action) action string default:"getLogs" Set to `getLogs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-address) address string default:"0xbd3531da5cf5857e7cfaa92426877b022e612cf8" Address to check for logs. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-from-block) fromBlock integer default:"12878196" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-to-block) toBlock integer default:"12878196" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs#param-offset) offset integer default:"1000" Number of records per page. Limited to 1000 records per query; use the `page` parameter for subsequent records. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8&fromBlock=12878196&toBlock=12878196&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x0000000000000000000000000000000000000000000000000000000000000000",\ "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ },\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x1",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ }\ ] } [eth\_estimateGas](https://docs.etherscan.io/api-reference/endpoint/ethestimategas) [Get Event Logs by Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics) ⌘I --- # Supported Chains - Etherscan [Skip to main content](https://docs.etherscan.io/supported-chains#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Supported Chains [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) The [**Get Contract ABI**](https://docs.etherscan.io/api-reference/endpoint/getabi) , [**Get Contract Source Code**](https://docs.etherscan.io/api-reference/endpoint/getsourcecode) , and [**Verify Source Code**](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode) endpoints are available on all chains for every API plan, including the Free Tier. For Solana(SOL) data, we’re also working on the [**Solscan APIs**](https://solscan.io/apis) , available separately. | Chain Name | Chain ID | Paid Tier | Free Tier | | --- | --- | --- | --- | | Ethereum Mainnet | 1 | Available | Available | | Sepolia Testnet | 11155111 | Available | Available | | Holesky Testnet | 17000 | Available | Available | | Hoodi Testnet | 560048 | Available | Available | | Abstract Mainnet | 2741 | Available | Available | | Abstract Sepolia Testnet | 11124 | Available | Available | | ApeChain Curtis Testnet | 33111 | Available | Available | | ApeChain Mainnet | 33139 | Available | Available | | Arbitrum Nova Mainnet | 42170 | Available | Available | | Arbitrum One Mainnet | 42161 | Available | Available | | Arbitrum Sepolia Testnet | 421614 | Available | Available | | Avalanche C-Chain | 43114 | Available | Not Available | | Avalanche Fuji Testnet | 43113 | Available | Not Available | | Base Mainnet | 8453 | Available | Not Available | | Base Sepolia Testnet | 84532 | Available | Not Available | | Berachain Bepolia Testnet | 80069 | Available | Available | | Berachain Mainnet | 80094 | Available | Available | | BitTorrent Chain Mainnet | 199 | Available | Available | | BitTorrent Chain Testnet | 1029 | Available | Available | | Blast Mainnet | 81457 | Available | Available | | Blast Sepolia Testnet | 168587773 | Available | Available | | BNB Smart Chain Mainnet | 56 | Available | Not Available | | BNB Smart Chain Testnet | 97 | Available | Not Available | | Celo Mainnet | 42220 | Available | Available | | Celo Sepolia Testnet | 11142220 | Available | Available | | Fraxtal Mainnet | 252 | Available | Available | | Fraxtal Hoodi Testnet | 2523 | Available | Available | | Gnosis | 100 | Available | Available | | HyperEVM Mainnet | 999 | Available | Available | | Katana Bokuto | 737373 | Available | Available | | Katana Mainnet | 747474 | Available | Available | | Linea Mainnet | 59144 | Available | Available | | Linea Sepolia Testnet | 59141 | Available | Available | | Mantle Mainnet | 5000 | Available | Available | | Mantle Sepolia Testnet | 5003 | Available | Available | | Memecore Testnet | 43521 | Available | Available | | Monad Mainnet | 143 | Available | Available | | Monad Testnet | 10143 | Available | Available | | Moonbase Alpha Testnet | 1287 | Available | Available | | Moonbeam Mainnet | 1284 | Available | Available | | Moonriver Mainnet | 1285 | Available | Available | | OP Mainnet | 10 | Available | Not Available | | OP Sepolia Testnet | 11155420 | Available | Not Available | | opBNB Mainnet | 204 | Available | Available | | opBNB Testnet | 5611 | Available | Available | | Polygon Amoy Testnet | 80002 | Available | Available | | Polygon Mainnet | 137 | Available | Available | | Scroll Mainnet | 534352 | Available | Available | | Scroll Sepolia Testnet | 534351 | Available | Available | | Sei Mainnet | 1329 | Available | Available | | Sei Testnet | 1328 | Available | Available | | Sonic Mainnet | 146 | Available | Available | | Sonic Testnet | 14601 | Available | Available | | Stable Mainnet | 988 | Available | Available | | Stable Testnet | 2201 | Available | Available | | Swellchain Mainnet | 1923 | Available | Available | | Swellchain Testnet | 1924 | Available | Available | | Taiko Hoodi | 167013 | Available | Available | | Taiko Mainnet | 167000 | Available | Available | | Unichain Mainnet | 130 | Available | Available | | Unichain Sepolia Testnet | 1301 | Available | Available | | World Mainnet | 480 | Available | Available | | World Sepolia Testnet | 4801 | Available | Available | | XDC Apothem Testnet | 51 | Available | Available | | XDC Mainnet | 50 | Available | Available | | zkSync Mainnet | 324 | Available | Available | | zkSync Sepolia Testnet | 300 | Available | Available | [Getting an API Key](https://docs.etherscan.io/getting-an-api-key) [Rate Limits](https://docs.etherscan.io/resources/rate-limits) ⌘I --- # eth_gasPrice - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_gasPrice [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_gasPrice&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 73, "result": "0x1d9d2db2" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgasprice#param-action) action string default:"eth\_gasPrice" Set to `eth_gasPrice` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_gasPrice&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 73, "result": "0x1d9d2db2" } [eth\_getStorageAt](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat) [eth\_estimateGas](https://docs.etherscan.io/api-reference/endpoint/ethestimategas) ⌘I --- # Get Estimation of Confirmation Time - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/gasestimate#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Gas Tracker Get Estimation of Confirmation Time [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasestimate&gasprice=2000000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "45" } ### [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#param-module) module string default:"gastracker" Set to `gastracker` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#param-action) action string default:"gasestimate" Set to `gasestimate` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/gasestimate#param-gasprice) gasprice string default:"2000000000" Gas price paid per unit of gas, in wei. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasestimate&gasprice=2000000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "45" } [Check Proxy Contract Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification) [Get Gas Oracle](https://docs.etherscan.io/api-reference/endpoint/gasoracle) ⌘I --- # Get Plasma Deposits by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txnbridge#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation L2 Deposits/Withdrawals Get Plasma Deposits by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=137&module=account&action=txnbridge&address=0x4880bd4695a8e59dc527d124085749744b6c988e&page=1&offset=10&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "hash": "0xf645deb2b6fbb8b76ccbcf4bde782e28d3520e8a30e9a568b9b8c526e2fd8434",\ "blockNumber": "51844560",\ "timeStamp": "1704181285",\ "from": "0x0000000000000000000000000000000000000000",\ "address": "0x4880bd4695a8e59dc527d124085749744b6c988e",\ "amount": "2341706540000000000",\ "tokenName": "Polygon Token",\ "symbol": "POL",\ "contractAddress": "0x0000000000000000000000000000000000001010",\ "divisor": "18"\ }\ ] } This endpoint is only available for Polygon (137), Xdai (100) and BTTC(199) ### [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-chainid) chainid string default:"137" Chain ID to query, eg `137` for Polygon from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-action) action string default:"txnbridge" Set to `txnbridge` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-address) address string default:"0x4880bd4695a8e59dc527d124085749744b6c988e" Address to check for Plasma deposits. [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/txnbridge#param-offset) offset integer default:"10" Number of records per page. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=137&module=account&action=txnbridge&address=0x4880bd4695a8e59dc527d124085749744b6c988e&page=1&offset=10&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "hash": "0xf645deb2b6fbb8b76ccbcf4bde782e28d3520e8a30e9a568b9b8c526e2fd8434",\ "blockNumber": "51844560",\ "timeStamp": "1704181285",\ "from": "0x0000000000000000000000000000000000000000",\ "address": "0x4880bd4695a8e59dc527d124085749744b6c988e",\ "amount": "2341706540000000000",\ "tokenName": "Polygon Token",\ "symbol": "POL",\ "contractAddress": "0x0000000000000000000000000000000000001010",\ "divisor": "18"\ }\ ] } [Get Address ERC721 Token Inventory by Contract](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory) [Get Deposit Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs) ⌘I --- # Get Event Logs by Topics - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Logs Get Event Logs by Topics [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&fromBlock=12878196&toBlock=12879196&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef&topic0_1_opr=and&topic1=0x0000000000000000000000000000000000000000000000000000000000000000&topic1_2_opr=and&topic2=0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d&topic2_3_opr=and&topic3=0x00000000000000000000000000000000000000000000000000000000000000b5&topic0_2_opr=and&topic0_3_opr=and&topic1_3_opr=and&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x0000000000000000000000000000000000000000000000000000000000000000",\ "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-module) module string default:"logs" Set to `logs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-action) action string default:"getLogs" Set to `getLogs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-from-block) fromBlock integer default:"12878196" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-to-block) toBlock integer default:"12879196" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic0) topic0 string First topic to filter by, such as an event signature. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic0-1-opr) topic0\_1\_opr string default:"and" Topic operator between `topic0` and `topic1`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic1) topic1 string Second topic to filter by. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic1-2-opr) topic1\_2\_opr string default:"and" Topic operator between `topic1` and `topic2`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic2) topic2 string Third topic to filter by. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic2-3-opr) topic2\_3\_opr string default:"and" Topic operator between `topic2` and `topic3`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic3) topic3 string Fourth topic to filter by. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic0-2-opr) topic0\_2\_opr string default:"and" Topic operator between `topic0` and `topic2`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic0-3-opr) topic0\_3\_opr string default:"and" Topic operator between `topic0` and `topic3`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-topic1-3-opr) topic1\_3\_opr string default:"and" Topic operator between `topic1` and `topic3`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics#param-offset) offset integer default:"1000" Number of records per page. Limited to 1000 records per query; use the `page` parameter for subsequent records. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&fromBlock=12878196&toBlock=12879196&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef&topic0_1_opr=and&topic1=0x0000000000000000000000000000000000000000000000000000000000000000&topic1_2_opr=and&topic2=0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d&topic2_3_opr=and&topic3=0x00000000000000000000000000000000000000000000000000000000000000b5&topic0_2_opr=and&topic0_3_opr=and&topic1_3_opr=and&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x0000000000000000000000000000000000000000000000000000000000000000",\ "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",\ "0x00000000000000000000000000000000000000000000000000000000000000b5"\ ],\ "data": "0x",\ "blockNumber": "0xc48174",\ "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",\ "timeStamp": "0x60f9ce56",\ "gasPrice": "0x2e90edd000",\ "gasUsed": "0x247205",\ "logIndex": "0x",\ "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",\ "transactionIndex": "0x"\ }\ ] } [Get Event Logs by Address](https://docs.etherscan.io/api-reference/endpoint/getlogs) [Get Event Logs by Address and Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics) ⌘I --- # Get Deposit Transactions by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation L2 Deposits/Withdrawals Get Deposit Transactions by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=10&module=account&action=getdeposittxs&address=0x80f3950a4d371c43360f292a4170624abd9eed03&page=1&offset=10&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "132992375",\ "timeStamp": "1741583527",\ "blockHash": "0xef2ff158c8b12be842429f4a8cde58bfa6a389c5274b46f8a1dd2ee7f958ca4d",\ "hash": "0x64ccd0cfa9f333578b36227492f3bc7f5f3ec4bfa82cdc46f82884db680d8e5b",\ "nonce": "520502",\ "from": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "to": "0x4200000000000000000000000000000000000007",\ "value": "598200000000000",\ "gas": "490798",\ "gasPrice": "0",\ "input": "0xd764ad0b000100000000000000000000000000000000000000000000000000000002802a00000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be10000000000000000000000004200000000000000000000000000000000000001000000000000000000000000000000000000000000000000000002200f4a81300000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000a41635f5fd0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae00000000000000000000000080f3950a4d371c43360f292a4170624abd9eed03000000000000000000000000000000000000000000000000000002200f4a813000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",\ "cumulativeGasUsed": "169497",\ "gasUsed": "117234",\ "isError": "0",\ "errDescription": "",\ "txreceipt_status": "1",\ "queueIndex": "999999",\ "L1transactionhash": "0x303bd05c47e62e1243a33210e535ebc70a7567e53a9972fbdef52ee5bcda5acb",\ "L1TxOrigin": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "tokenAddress": "ETH",\ "tokenSentFrom": "",\ "tokenSentTo": "0x80f3950a4d371c43360f292a4170624abd9eed03",\ "tokenValue": "598200000000000"\ },\ {\ "blockNumber": "134878032",\ "timeStamp": "1745354841",\ "blockHash": "0xd1a47b46e3aaed25c594507cf9df59c9ba7a25542fabed7e2b646efe8b6944f9",\ "hash": "0xb7cbf6eb529f60b28c6707a52e17c84e75bbe0a968e668a29e5a7550bfb00e92",\ "nonce": "527247",\ "from": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "to": "0x4200000000000000000000000000000000000007",\ "value": "1195403000000000",\ "gas": "490798",\ "gasPrice": "0",\ "input": "0xd764ad0b0001000000000000000000000000000000000000000000000000000000029a8300000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be100000000000000000000000042000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000043f36732dae00000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000a41635f5fd0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae00000000000000000000000080f3950a4d371c43360f292a4170624abd9eed030000000000000000000000000000000000000000000000000000043f36732dae000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",\ "cumulativeGasUsed": "147297",\ "gasUsed": "92234",\ "isError": "0",\ "errDescription": "",\ "txreceipt_status": "1",\ "queueIndex": "999999",\ "L1transactionhash": "0xdca5992b97fcb3d2aa4d06f8c47c0786c0007009d15445712931ee0998f94caa",\ "L1TxOrigin": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "tokenAddress": "ETH",\ "tokenSentFrom": "",\ "tokenSentTo": "0x80f3950a4d371c43360f292a4170624abd9eed03",\ "tokenValue": "1195403000000000"\ }\ ] } This endpoint is only available for the Arbitrum and Optimism stack chains. ### [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-chainid) chainid string default:"10" Chain ID to query, eg `10` for Optimism or `42161` for Arbitrum from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-action) action string default:"getdeposittxs" Set to `getdeposittxs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-address) address string default:"0x80f3950a4d371c43360f292a4170624abd9eed03" Address to check for cross-chain deposits from Ethereum to L2. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-offset) offset integer default:"10" Number of records per page. [​](https://docs.etherscan.io/api-reference/endpoint/getdeposittxs#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=10&module=account&action=getdeposittxs&address=0x80f3950a4d371c43360f292a4170624abd9eed03&page=1&offset=10&sort=desc&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "132992375",\ "timeStamp": "1741583527",\ "blockHash": "0xef2ff158c8b12be842429f4a8cde58bfa6a389c5274b46f8a1dd2ee7f958ca4d",\ "hash": "0x64ccd0cfa9f333578b36227492f3bc7f5f3ec4bfa82cdc46f82884db680d8e5b",\ "nonce": "520502",\ "from": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "to": "0x4200000000000000000000000000000000000007",\ "value": "598200000000000",\ "gas": "490798",\ "gasPrice": "0",\ "input": "0xd764ad0b000100000000000000000000000000000000000000000000000000000002802a00000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be10000000000000000000000004200000000000000000000000000000000000001000000000000000000000000000000000000000000000000000002200f4a81300000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000a41635f5fd0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae00000000000000000000000080f3950a4d371c43360f292a4170624abd9eed03000000000000000000000000000000000000000000000000000002200f4a813000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",\ "cumulativeGasUsed": "169497",\ "gasUsed": "117234",\ "isError": "0",\ "errDescription": "",\ "txreceipt_status": "1",\ "queueIndex": "999999",\ "L1transactionhash": "0x303bd05c47e62e1243a33210e535ebc70a7567e53a9972fbdef52ee5bcda5acb",\ "L1TxOrigin": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "tokenAddress": "ETH",\ "tokenSentFrom": "",\ "tokenSentTo": "0x80f3950a4d371c43360f292a4170624abd9eed03",\ "tokenValue": "598200000000000"\ },\ {\ "blockNumber": "134878032",\ "timeStamp": "1745354841",\ "blockHash": "0xd1a47b46e3aaed25c594507cf9df59c9ba7a25542fabed7e2b646efe8b6944f9",\ "hash": "0xb7cbf6eb529f60b28c6707a52e17c84e75bbe0a968e668a29e5a7550bfb00e92",\ "nonce": "527247",\ "from": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "to": "0x4200000000000000000000000000000000000007",\ "value": "1195403000000000",\ "gas": "490798",\ "gasPrice": "0",\ "input": "0xd764ad0b0001000000000000000000000000000000000000000000000000000000029a8300000000000000000000000099c9fc46f92e8a1c0dec1b1747d010903e884be100000000000000000000000042000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000043f36732dae00000000000000000000000000000000000000000000000000000000000000030d4000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000a41635f5fd0000000000000000000000001231deb6f5749ef6ce6943a275a1d3e7486f4eae00000000000000000000000080f3950a4d371c43360f292a4170624abd9eed030000000000000000000000000000000000000000000000000000043f36732dae000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",\ "cumulativeGasUsed": "147297",\ "gasUsed": "92234",\ "isError": "0",\ "errDescription": "",\ "txreceipt_status": "1",\ "queueIndex": "999999",\ "L1transactionhash": "0xdca5992b97fcb3d2aa4d06f8c47c0786c0007009d15445712931ee0998f94caa",\ "L1TxOrigin": "0x36bde71c97b33cc4729cf772ae268934f7ab70b2",\ "tokenAddress": "ETH",\ "tokenSentFrom": "",\ "tokenSentTo": "0x80f3950a4d371c43360f292a4170624abd9eed03",\ "tokenValue": "1195403000000000"\ }\ ] } [Get Plasma Deposits by Address](https://docs.etherscan.io/api-reference/endpoint/txnbridge) [Get Withdrawal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/getwithdrawaltxs) ⌘I --- # Getting an API Key - Etherscan [Skip to main content](https://docs.etherscan.io/getting-an-api-key#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Get Started Getting an API Key [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) 1 Create an Etherscan Account [Sign up](https://etherscan.io/register) for a Free account. 2 Navigate to the API Dashboard Under your [API Dashboard](https://etherscan.io/apidashboard) , click β€œAdd +” to create a new API key. This key can be used to access all [supported chains](https://docs.etherscan.io/supported-chains) under API V2.![Remix verify](https://mintcdn.com/etherscan/7r1uhEYn3uP2ppZz/images/dashboard-keys.avif?w=2500&fit=max&auto=format&n=7r1uhEYn3uP2ppZz&q=85&s=74c627eca1162db3caa62a7324bf5861) 3 Make your First Request Use your key to start testing requests in the [API Playground](https://docs.etherscan.io/api-reference) within this docs πŸš€. [Introduction](https://docs.etherscan.io/introduction) [Supported Chains](https://docs.etherscan.io/supported-chains) ⌘I --- # eth_getCode - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getCode [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getCode&address=0xf75e354c5edc8efed9b59ee9f67a80845ade7d0c&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x3660008037602060003660003473273930d21e01ee25e4c219b63259d214872220a261235a5a03f21560015760206000f3" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-action) action string default:"eth\_getCode" Set to `eth_getCode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-address) address string default:"0xf75e354c5edc8efed9b59ee9f67a80845ade7d0c" The address to query. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetcode#param-tag) tag string default:"latest" Use `latest`, `earliest`, `pending`, or a block number in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getCode&address=0xf75e354c5edc8efed9b59ee9f67a80845ade7d0c&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x3660008037602060003660003473273930d21e01ee25e4c219b63259d214872220a261235a5a03f21560015760206000f3" } [eth\_call](https://docs.etherscan.io/api-reference/endpoint/ethcall) [eth\_getStorageAt](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat) ⌘I --- # eth_estimateGas - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_estimateGas [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_estimateGas&data=0x4e71d92d&to=0xf0160428a8552ac9bb7e050d90eeade4ddd52843&value=0xff22&gasPrice=0x51da038cc&gas=0x5f5e0ff&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x66ac" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-action) action string default:"eth\_estimateGas" Set to `eth_estimateGas` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-data) data string default:"0x4e71d92d" Hash of the method signature and encoded parameters. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-to) to string default:"0xf0160428a8552ac9bb7e050d90eeade4ddd52843" The address to interact with. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-value) value string default:"0xff22" Value sent in this transaction, in hex. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-gas-price) gasPrice string default:"0x51da038cc" Gas price in wei. [​](https://docs.etherscan.io/api-reference/endpoint/ethestimategas#param-gas) gas string default:"0x5f5e0ff" Gas limit provided for the transaction, in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_estimateGas&data=0x4e71d92d&to=0xf0160428a8552ac9bb7e050d90eeade4ddd52843&value=0xff22&gasPrice=0x51da038cc&gas=0x5f5e0ff&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x66ac" } [eth\_gasPrice](https://docs.etherscan.io/api-reference/endpoint/ethgasprice) [Get Event Logs by Address](https://docs.etherscan.io/api-reference/endpoint/getlogs) ⌘I --- # eth_getBlockTransactionCountByNumber - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getBlockTransactionCountByNumber [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getBlockTransactionCountByNumber&tag=0x10FB78&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x3" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#param-action) action string default:"eth\_getBlockTransactionCountByNumber" Set to `eth_getBlockTransactionCountByNumber` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber#param-tag) tag string default:"0x10FB78" Block number in hex format. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getBlockTransactionCountByNumber&tag=0x10FB78&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x3" } [eth\_getUncleByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex) [eth\_getTransactionByHash](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash) ⌘I --- # eth_blockNumber - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_blockNumber [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_blockNumber&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 83, "result": "0x1661760" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber#param-action) action string default:"eth\_blockNumber" Set to `eth_blockNumber` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_blockNumber&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 83, "result": "0x1661760" } [Get Daily Average Gas Price](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice) [eth\_getBlockByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber) ⌘I --- # Get Block Number by Timestamp - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Block Number by Timestamp [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblocknobytime×tamp=1578638524&closest=before&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "9251482" } ### [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-module) module string default:"block" Set to `block` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-action) action string default:"getblocknobytime" Set to `getblocknobytime` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-timestamp) timestamp integer default:"1578638524" Unix timestamp in seconds. [​](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime#param-closest) closest string default:"before" Closest available block to the provided timestamp, either `before` or `after`. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblocknobytime×tamp=1578638524&closest=before&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "9251482" } [Get Estimated Block Countdown by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown) [Get Daily Average Block Size](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize) ⌘I --- # Get Event Logs by Address and Topics - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Logs Get Event Logs by Address and Topics [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&fromBlock=15073139&toBlock=15074139&address=0x59728544b08ab483533076417fbbb2fd0b17ce3a&topic0=0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d&topic0_1_opr=and&topic1=0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0x59728544b08ab483533076417fbbb2fd0b17ce3a",\ "topics": [\ "0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",\ "0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",\ "0x000000000000000000000000000000000000000000000000000000000000236d",\ "0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"\ ],\ "data": "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000f207539952d0000",\ "blockNumber": "0xe60262",\ "blockHash": "0xb40d77b4ffba5ae2a38cbc87a65a6c9b56f9af5d8bf320aa1f1b6af00b850778",\ "timeStamp": "0x62c26caf",\ "gasPrice": "0x5e2d742c9",\ "gasUsed": "0xfb7f8",\ "logIndex": "0x4b",\ "transactionHash": "0x26fe1a0a403fd44ef11ee72f3b4ceff590b6ea533684cb279cb4242be463304c",\ "transactionIndex": "0x39"\ },\ {\ "address": "0x59728544b08ab483533076417fbbb2fd0b17ce3a",\ "topics": [\ "0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",\ "0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",\ "0x0000000000000000000000000000000000000000000000000000000000002261",\ "0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"\ ],\ "data": "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a7640000",\ "blockNumber": "0xe6035b",\ "blockHash": "0x5a46aeca5eaf8af1fbf56439b12dfea8fb27d18ca31020cc723271e119cffc04",\ "timeStamp": "0x62c27ab1",\ "gasPrice": "0x27e523173",\ "gasUsed": "0x3b86e",\ "logIndex": "0x1d7",\ "transactionHash": "0x3a299413cf2c91e376e542efcf3fc308c562da79af6e992401217cc6208c7f74",\ "transactionIndex": "0x92"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-module) module string default:"logs" Set to `logs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-action) action string default:"getLogs" Set to `getLogs` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-from-block) fromBlock integer default:"15073139" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-to-block) toBlock integer default:"15074139" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-address) address string default:"0x59728544b08ab483533076417fbbb2fd0b17ce3a" Address to check for logs. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-topic0) topic0 string First topic to filter by, such as an event signature. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-topic0-1-opr) topic0\_1\_opr string default:"and" Topic operator between `topic0` and `topic1`, either `and` or `or`. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-topic1) topic1 string Second topic to filter by. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics#param-offset) offset integer default:"1000" Number of records per page. Limited to 1000 records per query; use the `page` parameter for subsequent records. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&fromBlock=15073139&toBlock=15074139&address=0x59728544b08ab483533076417fbbb2fd0b17ce3a&topic0=0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d&topic0_1_opr=and&topic1=0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b&page=1&offset=1000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "address": "0x59728544b08ab483533076417fbbb2fd0b17ce3a",\ "topics": [\ "0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",\ "0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",\ "0x000000000000000000000000000000000000000000000000000000000000236d",\ "0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"\ ],\ "data": "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000f207539952d0000",\ "blockNumber": "0xe60262",\ "blockHash": "0xb40d77b4ffba5ae2a38cbc87a65a6c9b56f9af5d8bf320aa1f1b6af00b850778",\ "timeStamp": "0x62c26caf",\ "gasPrice": "0x5e2d742c9",\ "gasUsed": "0xfb7f8",\ "logIndex": "0x4b",\ "transactionHash": "0x26fe1a0a403fd44ef11ee72f3b4ceff590b6ea533684cb279cb4242be463304c",\ "transactionIndex": "0x39"\ },\ {\ "address": "0x59728544b08ab483533076417fbbb2fd0b17ce3a",\ "topics": [\ "0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",\ "0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",\ "0x0000000000000000000000000000000000000000000000000000000000002261",\ "0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"\ ],\ "data": "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a7640000",\ "blockNumber": "0xe6035b",\ "blockHash": "0x5a46aeca5eaf8af1fbf56439b12dfea8fb27d18ca31020cc723271e119cffc04",\ "timeStamp": "0x62c27ab1",\ "gasPrice": "0x27e523173",\ "gasUsed": "0x3b86e",\ "logIndex": "0x1d7",\ "transactionHash": "0x3a299413cf2c91e376e542efcf3fc308c562da79af6e992401217cc6208c7f74",\ "transactionIndex": "0x92"\ }\ ] } [Get Event Logs by Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics) [Get Total Supply of Ether](https://docs.etherscan.io/api-reference/endpoint/ethsupply) ⌘I --- # eth_getTransactionByHash - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getTransactionByHash [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionByHash&txhash=0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0xf850331061196b8f2b67e1f43aaa9e69504c059d3d3fb9547b04f9ed4d141ab7", "blockNumber": "0xcf2420", "from": "0x00192fb10df37c9fb26829eb2cc623cd1bf599e8", "gas": "0x5208", "gasPrice": "0x19f017ef49", "maxFeePerGas": "0x1f6ea08600", "maxPriorityFeePerGas": "0x3b9aca00", "hash": "0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44", "input": "0x", "nonce": "0x33b79d", "to": "0xc67f4e626ee4d3f272c2fb31bad60761ab55ed9f", "transactionIndex": "0x5b", "value": "0x19755d4ce12c00", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0xa681faea68ff81d191169010888bbbe90ec3eb903e31b0572cd34f13dae281b9", "s": "0x3f59b0fa5ce6cf38aff2cfeb68e7a503ceda2a72b4442c7e2844d63544383e3", "yParity": "0x0" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#param-action) action string default:"eth\_getTransactionByHash" Set to `eth_getTransactionByHash` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash#param-txhash) txhash string The transaction hash to query. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionByHash&txhash=0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0xf850331061196b8f2b67e1f43aaa9e69504c059d3d3fb9547b04f9ed4d141ab7", "blockNumber": "0xcf2420", "from": "0x00192fb10df37c9fb26829eb2cc623cd1bf599e8", "gas": "0x5208", "gasPrice": "0x19f017ef49", "maxFeePerGas": "0x1f6ea08600", "maxPriorityFeePerGas": "0x3b9aca00", "hash": "0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44", "input": "0x", "nonce": "0x33b79d", "to": "0xc67f4e626ee4d3f272c2fb31bad60761ab55ed9f", "transactionIndex": "0x5b", "value": "0x19755d4ce12c00", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0xa681faea68ff81d191169010888bbbe90ec3eb903e31b0572cd34f13dae281b9", "s": "0x3f59b0fa5ce6cf38aff2cfeb68e7a503ceda2a72b4442c7e2844d63544383e3", "yParity": "0x0" } } [eth\_getBlockTransactionCountByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber) [eth\_getTransactionByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex) ⌘I --- # Get Total Supply of Ether - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethsupply#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Total Supply of Ether [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "122373866217800000000000000" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply#param-action) action string default:"ethsupply" Set to `ethsupply` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "122373866217800000000000000" } [Get Event Logs by Address and Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-address-topics) [Get Total Supply of Ether 2](https://docs.etherscan.io/api-reference/endpoint/ethsupply2) ⌘I --- # Get Estimated Block Countdown by Block Number - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Estimated Block Countdown by Block Number [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblockcountdown&blockno=16701588&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "NOTOK", "result": "Error! Block number already pass" } ### [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#param-module) module string default:"block" Set to `block` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#param-action) action string default:"getblockcountdown" Set to `getblockcountdown` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown#param-blockno) blockno integer default:"16701588" Block number to estimate time remaining for. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblockcountdown&blockno=16701588&apikey=YourApiKeyToken" Copy Ask AI { "status": "0", "message": "NOTOK", "result": "Error! Block number already pass" } [Get Block and Uncle Rewards by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockreward) [Get Block Number by Timestamp](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime) ⌘I --- # eth_getTransactionCount - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getTransactionCount [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionCount&address=0x4bd5900Cb274ef15b153066D736bf3e83A9ba44e&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x73" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-action) action string default:"eth\_getTransactionCount" Set to `eth_getTransactionCount` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-address) address string default:"0x4bd5900Cb274ef15b153066D736bf3e83A9ba44e" The address to query. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount#param-tag) tag string default:"latest" Use `latest`, `earliest`, `pending`, or a block number in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionCount&address=0x4bd5900Cb274ef15b153066D736bf3e83A9ba44e&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x73" } [eth\_getTransactionByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex) [eth\_sendRawTransaction](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction) ⌘I --- # eth_getBlockByNumber - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getBlockByNumber [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getBlockByNumber&tag=0x10d4f&boolean=true&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "difficulty": "0x1d95715bd14", "extraData": "0x", "gasLimit": "0x2fefd8", "gasUsed": "0x5208", "hash": "0x7eb7c23a5ac2f2d70aa1ba4e5c56d89de5ac993590e5f6e79c394e290d998ba8", "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0xf927a40c8b7f6e07c5af7fa2155b4864a4112b13", "mixHash": "0x13dd2c8aec729f75aebcd79a916ecb0f7edc6493efcc6a4da8d7b0ab3ee88444", "nonce": "0xc60a782e2e69ce22", "number": "0x10d4f", "parentHash": "0xf8d01370e6e274f8188954fbee435b40c35b2ad3d4ab671f6d086cd559e48f04", "receiptsRoot": "0x0c44b7ed0fefb613ec256341aa0ffdb643e869e3a0ebc8f58e36b4e47efedd33", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x275", "stateRoot": "0xd64a0f63e2c7f541e6e6f8548a10a5c4e49fda7ac1aa80f9dddef648c7b9e25f", "timestamp": "0x55c9ea07", "transactions": [\ {\ "blockHash": "0x7eb7c23a5ac2f2d70aa1ba4e5c56d89de5ac993590e5f6e79c394e290d998ba8",\ "blockNumber": "0x10d4f",\ "from": "0x4458f86353b4740fe9e09071c23a7437640063c9",\ "gas": "0x5208",\ "gasPrice": "0xba43b7400",\ "hash": "0xa442249820de6be754da81eafbd44a865773e4b23d7c0522d31fd03977823008",\ "input": "0x",\ "nonce": "0x1",\ "to": "0xbf3403210f9802205f426759947a80a9fda71b1e",\ "transactionIndex": "0x0",\ "value": "0xaa9f075c200000",\ "type": "0x0",\ "v": "0x1b",\ "r": "0x2c2789c6704ba2606e200e1ba4fd17ba4f0e0f94abe32a12733708c3d3442616",\ "s": "0x2946f47e3ece580b5b5ecb0f8c52604fa5f60aeb4103fc73adcbf6d620f9872b"\ }\ ], "transactionsRoot": "0x4a5b78c13d11559c9541576834b5172fe8b18507c0f9f76454fcdddedd8dff7a", "uncles": [] } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-action) action string default:"eth\_getBlockByNumber" Set to `eth_getBlockByNumber` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-tag) tag string default:"0x10d4f" Block number in hex format. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber#param-boolean) boolean string default:"true" Set to `true` to return full transaction objects or `false` for transaction hashes only. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getBlockByNumber&tag=0x10d4f&boolean=true&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "difficulty": "0x1d95715bd14", "extraData": "0x", "gasLimit": "0x2fefd8", "gasUsed": "0x5208", "hash": "0x7eb7c23a5ac2f2d70aa1ba4e5c56d89de5ac993590e5f6e79c394e290d998ba8", "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0xf927a40c8b7f6e07c5af7fa2155b4864a4112b13", "mixHash": "0x13dd2c8aec729f75aebcd79a916ecb0f7edc6493efcc6a4da8d7b0ab3ee88444", "nonce": "0xc60a782e2e69ce22", "number": "0x10d4f", "parentHash": "0xf8d01370e6e274f8188954fbee435b40c35b2ad3d4ab671f6d086cd559e48f04", "receiptsRoot": "0x0c44b7ed0fefb613ec256341aa0ffdb643e869e3a0ebc8f58e36b4e47efedd33", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x275", "stateRoot": "0xd64a0f63e2c7f541e6e6f8548a10a5c4e49fda7ac1aa80f9dddef648c7b9e25f", "timestamp": "0x55c9ea07", "transactions": [\ {\ "blockHash": "0x7eb7c23a5ac2f2d70aa1ba4e5c56d89de5ac993590e5f6e79c394e290d998ba8",\ "blockNumber": "0x10d4f",\ "from": "0x4458f86353b4740fe9e09071c23a7437640063c9",\ "gas": "0x5208",\ "gasPrice": "0xba43b7400",\ "hash": "0xa442249820de6be754da81eafbd44a865773e4b23d7c0522d31fd03977823008",\ "input": "0x",\ "nonce": "0x1",\ "to": "0xbf3403210f9802205f426759947a80a9fda71b1e",\ "transactionIndex": "0x0",\ "value": "0xaa9f075c200000",\ "type": "0x0",\ "v": "0x1b",\ "r": "0x2c2789c6704ba2606e200e1ba4fd17ba4f0e0f94abe32a12733708c3d3442616",\ "s": "0x2946f47e3ece580b5b5ecb0f8c52604fa5f60aeb4103fc73adcbf6d620f9872b"\ }\ ], "transactionsRoot": "0x4a5b78c13d11559c9541576834b5172fe8b18507c0f9f76454fcdddedd8dff7a", "uncles": [] } } [eth\_blockNumber](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber) [eth\_getUncleByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex) ⌘I --- # eth_getStorageAt - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getStorageAt [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getStorageAt&address=0x6e03d9cce9d60f3e9f2597e13cd4c54c55330cfd&position=0x0&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x0000000000000000000000000000000000000000000000000000000000000000" } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-action) action string default:"eth\_getStorageAt" Set to `eth_getStorageAt` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-address) address string default:"0x6e03d9cce9d60f3e9f2597e13cd4c54c55330cfd" The address to query. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-position) position string default:"0x0" Storage position in hex. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat#param-tag) tag string default:"latest" Use `latest`, `earliest`, `pending`, or a block number in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getStorageAt&address=0x6e03d9cce9d60f3e9f2597e13cd4c54c55330cfd&position=0x0&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": "0x0000000000000000000000000000000000000000000000000000000000000000" } [eth\_getCode](https://docs.etherscan.io/api-reference/endpoint/ethgetcode) [eth\_gasPrice](https://docs.etherscan.io/api-reference/endpoint/ethgasprice) ⌘I --- # eth_getTransactionReceipt - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getTransactionReceipt [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionReceipt&txhash=0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799", "blockNumber": "0xcf2427", "contractAddress": null, "cumulativeGasUsed": "0xeb67d5", "effectiveGasPrice": "0x1a96b24c26", "from": "0x292f04a44506c2fd49bac032e1ca148c35a478c8", "gasUsed": "0xb41d", "logs": [\ {\ "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x000000000000000000000000292f04a44506c2fd49bac032e1ca148c35a478c8",\ "0x000000000000000000000000ab6960a6511ff18ed8b8c012cb91c7f637947fc0"\ ],\ "data": "0x00000000000000000000000000000000000000000000000000000000013f81a6",\ "blockNumber": "0xcf2427",\ "transactionHash": "0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb",\ "transactionIndex": "0x122",\ "blockHash": "0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799",\ "logIndex": "0xdb",\ "removed": false\ }\ ], "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000400000000000400000000000000000001000000000000000000000000000000000000000000000000000000000800000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000001000000000110000000000000000000000000000000000000000000000000000000200100000000000000000000000000080000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "status": "0x1", "to": "0xdac17f958d2ee523a2206206994597c13d831ec7", "transactionHash": "0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb", "transactionIndex": "0x122", "type": "0x2" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#param-action) action string default:"eth\_getTransactionReceipt" Set to `eth_getTransactionReceipt` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt#param-txhash) txhash string The transaction hash to query. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionReceipt&txhash=0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799", "blockNumber": "0xcf2427", "contractAddress": null, "cumulativeGasUsed": "0xeb67d5", "effectiveGasPrice": "0x1a96b24c26", "from": "0x292f04a44506c2fd49bac032e1ca148c35a478c8", "gasUsed": "0xb41d", "logs": [\ {\ "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x000000000000000000000000292f04a44506c2fd49bac032e1ca148c35a478c8",\ "0x000000000000000000000000ab6960a6511ff18ed8b8c012cb91c7f637947fc0"\ ],\ "data": "0x00000000000000000000000000000000000000000000000000000000013f81a6",\ "blockNumber": "0xcf2427",\ "transactionHash": "0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb",\ "transactionIndex": "0x122",\ "blockHash": "0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799",\ "logIndex": "0xdb",\ "removed": false\ }\ ], "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000400000000000400000000000000000001000000000000000000000000000000000000000000000000000000000800000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000001000000000110000000000000000000000000000000000000000000000000000000200100000000000000000000000000080000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "status": "0x1", "to": "0xdac17f958d2ee523a2206206994597c13d831ec7", "transactionHash": "0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb", "transactionIndex": "0x122", "type": "0x2" } } [eth\_sendRawTransaction](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction) [eth\_call](https://docs.etherscan.io/api-reference/endpoint/ethcall) ⌘I --- # Get Ether Last Price - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethprice#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Ether Last Price [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethprice&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "ethbtc": "0.0368322132423383", "ethbtc_timestamp": "1759139509", "ethusd": "4129.30651044757", "ethusd_timestamp": "1759139509" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethprice#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethprice#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethprice#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethprice#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethprice#param-action) action string default:"ethprice" Set to `ethprice` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethprice&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "ethbtc": "0.0368322132423383", "ethbtc_timestamp": "1759139509", "ethusd": "4129.30651044757", "ethusd_timestamp": "1759139509" } } [Get Total Supply of Ether 2](https://docs.etherscan.io/api-reference/endpoint/ethsupply2) [Get Ethereum Nodes Size](https://docs.etherscan.io/api-reference/endpoint/chainsize) ⌘I --- # eth_getUncleByBlockNumberAndIndex - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getUncleByBlockNumberAndIndex [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getUncleByBlockNumberAndIndex&tag=0xC63276&index=0x0&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "baseFeePerGas": "0x65a42b13c", "difficulty": "0x1b1457a8247bbb", "extraData": "0x486976656f6e2063612d68656176792059476f6e", "gasLimit": "0x1ca359a", "gasUsed": "0xb48fe1", "hash": "0x1da88e3581315d009f1cb600bf06f509cd27a68cb3d6437bda8698d04089f14a", "logsBloom": "0xf1a360ca505cdda510d810c1c81a03b51a8a508ed601811084833072945290235c8721e012182e40d57df552cf00f1f01bc498018da19e008681832b43762a30c26e11709948a9b96883a42ad02568e3fcc3000004ee12813e4296498261619992c40e22e60bd95107c5bd8462fcca570a0095d52a4c24720b00f13a2c3d62aca81e852017470c109643b15041fd69742406083d67654fc841a18b405ab380e06a8c14c0138b6602ea8f48b2cd90ac88c3478212011136802900264718a085047810221225080dfb2c214010091a6f233883bb0084fa1c197330a10bb0006686e678b80e50e4328000041c218d1458880181281765d28d51066058f3f80a7822", "miner": "0x1ad91ee08f21be3de0ba2ba6918e714da6b45836", "mixHash": "0xa8e1dbbf073614c7ed05f44b9e92fbdb3e1d52575ed8167fa57f934210bbb0a2", "nonce": "0x28cc3e5b7bee9866", "number": "0xc63274", "parentHash": "0x496dae3e722efdd9ee1eb69499bdc7ed0dca54e13cd1157a42811c442f01941f", "receiptsRoot": "0x9c9a7a99b4af7607691a7f2a50d474290385c0a6f39c391131ea0c67307213f4", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x224", "stateRoot": "0xde9a11f0ee321390c1a7843cab7b9ffd3779d438bc8f77de4361dfe2807d7dee", "timestamp": "0x6110bd1a", "transactionsRoot": "0xa04a79e531db3ec373cb63e9ebfbc9c95525de6347958918a273675d4f221575", "uncles": [] } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-action) action string default:"eth\_getUncleByBlockNumberAndIndex" Set to `eth_getUncleByBlockNumberAndIndex` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-tag) tag string default:"0xC63276" Block number in hex format. [​](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex#param-index) index string default:"0x0" Position of the uncle in the block, in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getUncleByBlockNumberAndIndex&tag=0xC63276&index=0x0&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "baseFeePerGas": "0x65a42b13c", "difficulty": "0x1b1457a8247bbb", "extraData": "0x486976656f6e2063612d68656176792059476f6e", "gasLimit": "0x1ca359a", "gasUsed": "0xb48fe1", "hash": "0x1da88e3581315d009f1cb600bf06f509cd27a68cb3d6437bda8698d04089f14a", "logsBloom": "0xf1a360ca505cdda510d810c1c81a03b51a8a508ed601811084833072945290235c8721e012182e40d57df552cf00f1f01bc498018da19e008681832b43762a30c26e11709948a9b96883a42ad02568e3fcc3000004ee12813e4296498261619992c40e22e60bd95107c5bd8462fcca570a0095d52a4c24720b00f13a2c3d62aca81e852017470c109643b15041fd69742406083d67654fc841a18b405ab380e06a8c14c0138b6602ea8f48b2cd90ac88c3478212011136802900264718a085047810221225080dfb2c214010091a6f233883bb0084fa1c197330a10bb0006686e678b80e50e4328000041c218d1458880181281765d28d51066058f3f80a7822", "miner": "0x1ad91ee08f21be3de0ba2ba6918e714da6b45836", "mixHash": "0xa8e1dbbf073614c7ed05f44b9e92fbdb3e1d52575ed8167fa57f934210bbb0a2", "nonce": "0x28cc3e5b7bee9866", "number": "0xc63274", "parentHash": "0x496dae3e722efdd9ee1eb69499bdc7ed0dca54e13cd1157a42811c442f01941f", "receiptsRoot": "0x9c9a7a99b4af7607691a7f2a50d474290385c0a6f39c391131ea0c67307213f4", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x224", "stateRoot": "0xde9a11f0ee321390c1a7843cab7b9ffd3779d438bc8f77de4361dfe2807d7dee", "timestamp": "0x6110bd1a", "transactionsRoot": "0xa04a79e531db3ec373cb63e9ebfbc9c95525de6347958918a273675d4f221575", "uncles": [] } } [eth\_getBlockByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber) [eth\_getBlockTransactionCountByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber) ⌘I --- # Get Block and Uncle Rewards by Block Number - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getblockreward#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Blocks Get Block and Uncle Rewards by Block Number [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblockreward&blockno=2165403&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "blockNumber": "2165403", "timeStamp": "1472533979", "blockMiner": "0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3", "blockReward": "5314181600000000000", "uncles": [\ {\ "miner": "0xbcdfc35b86bedf72f0cda046a3c16829a2ef41d1",\ "unclePosition": "0",\ "blockreward": "3750000000000000000"\ },\ {\ "miner": "0x0d0c9855c722ff0c78f21e43aa275a5b8ea60dce",\ "unclePosition": "1",\ "blockreward": "3750000000000000000"\ }\ ], "uncleInclusionReward": "312500000000000000" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#param-chainid) chainid string default:"1" Chain ID you query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#param-module) module string default:"block" Set to `block` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#param-action) action string default:"getblockreward" Set to `getblockreward` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getblockreward#param-blockno) blockno integer default:"2165403" Block number to check rewards for. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=block&action=getblockreward&blockno=2165403&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "blockNumber": "2165403", "timeStamp": "1472533979", "blockMiner": "0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3", "blockReward": "5314181600000000000", "uncles": [\ {\ "miner": "0xbcdfc35b86bedf72f0cda046a3c16829a2ef41d1",\ "unclePosition": "0",\ "blockreward": "3750000000000000000"\ },\ {\ "miner": "0x0d0c9855c722ff0c78f21e43aa275a5b8ea60dce",\ "unclePosition": "1",\ "blockreward": "3750000000000000000"\ }\ ], "uncleInclusionReward": "312500000000000000" } } [Get Address Funded By](https://docs.etherscan.io/api-reference/endpoint/fundedby) [Get Estimated Block Countdown by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown) ⌘I --- # eth_sendRawTransaction - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_sendRawTransaction [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_sendRawTransaction&hex=0xf904808000831cfde080&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "error": { "code": -32000, "message": "rlp: value size exceeds available input length" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#param-action) action string default:"eth\_sendRawTransaction" Set to `eth_sendRawTransaction` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction#param-hex) hex string default:"0xf904808000831cfde080" The signed raw transaction data to broadcast. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_sendRawTransaction&hex=0xf904808000831cfde080&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "error": { "code": -32000, "message": "rlp: value size exceeds available input length" } } [eth\_getTransactionCount](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount) [eth\_getTransactionReceipt](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt) ⌘I --- # eth_getTransactionByBlockNumberAndIndex - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Geth/Parity Proxy eth\_getTransactionByBlockNumberAndIndex [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionByBlockNumberAndIndex&tag=0xC6331D&index=0x11A&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x13c5311a78b9a8790c58f1d0d0660226352a498cc98b06e1861f1967d3a9d1b4", "blockNumber": "0xc6331d", "from": "0xd1af036d589b6ebfbaa184b339a30d32ef611708", "gas": "0x11170", "gasPrice": "0x5b7e259a7", "maxFeePerGas": "0x5b7e259a7", "maxPriorityFeePerGas": "0x5b7e259a7", "hash": "0xc7ef51f0bfe85eefbb1d4d88f5a39e82fbfc94987d8cbcb515f74d80b6e44902", "input": "0x2d2da806000000000000000000000000d1af036d589b6ebfbaa184b339a30d32ef611708", "nonce": "0x0", "to": "0xabea9132b05a70803a4e85094fd0e1800777fbef", "transactionIndex": "0x11a", "value": "0x57930b5db6a000", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0x595619be17755f7427d07626275e4c89b8f9d5a0a668515165ea000d30f26325", "s": "0x33d4b22c7c779fc9f04c81788cb4268d2c3f8dc9e219245570bdd384c6ca6690", "yParity": "0x0" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-module) module string default:"proxy" Set to `proxy` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-action) action string default:"eth\_getTransactionByBlockNumberAndIndex" Set to `eth_getTransactionByBlockNumberAndIndex` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-tag) tag string default:"0xC6331D" Block number in hex format. [​](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex#param-index) index string default:"0x11A" Transaction index position in the block, in hex. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=proxy&action=eth_getTransactionByBlockNumberAndIndex&tag=0xC6331D&index=0x11A&apikey=YourApiKeyToken" Copy Ask AI { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x13c5311a78b9a8790c58f1d0d0660226352a498cc98b06e1861f1967d3a9d1b4", "blockNumber": "0xc6331d", "from": "0xd1af036d589b6ebfbaa184b339a30d32ef611708", "gas": "0x11170", "gasPrice": "0x5b7e259a7", "maxFeePerGas": "0x5b7e259a7", "maxPriorityFeePerGas": "0x5b7e259a7", "hash": "0xc7ef51f0bfe85eefbb1d4d88f5a39e82fbfc94987d8cbcb515f74d80b6e44902", "input": "0x2d2da806000000000000000000000000d1af036d589b6ebfbaa184b339a30d32ef611708", "nonce": "0x0", "to": "0xabea9132b05a70803a4e85094fd0e1800777fbef", "transactionIndex": "0x11a", "value": "0x57930b5db6a000", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0x595619be17755f7427d07626275e4c89b8f9d5a0a668515165ea000d30f26325", "s": "0x33d4b22c7c779fc9f04c81788cb4268d2c3f8dc9e219245570bdd384c6ca6690", "yParity": "0x0" } } [eth\_getTransactionByHash](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash) [eth\_getTransactionCount](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount) ⌘I --- # Get Total Supply of Ether 2 - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Total Supply of Ether 2 [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply2&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "EthSupply": "122373866217800000000000000", "Eth2Staking": "2940327167090033000000000", "BurntFees": "4610942856337430575173814", "WithdrawnTotal": "7618584348954597000000000" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/ethsupply2#param-action) action string default:"ethsupply2" Set to `ethsupply2` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply2&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "EthSupply": "122373866217800000000000000", "Eth2Staking": "2940327167090033000000000", "BurntFees": "4610942856337430575173814", "WithdrawnTotal": "7618584348954597000000000" } } [Get Total Supply of Ether](https://docs.etherscan.io/api-reference/endpoint/ethsupply) [Get Ether Last Price](https://docs.etherscan.io/api-reference/endpoint/ethprice) ⌘I --- # Get Contract Creator and Creation Tx Hash - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Get Contract Creator and Creation Tx Hash [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Contract Creator and Creation Tx Hash cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "contractAddress": "0xcbdcd3815b5f975e1a2c944a9b2cd1c985a1cb7f",\ "contractCreator": "0x3d080421c9dd5fb387d6e3124f7e1c241ade9568",\ "txHash": "0xdce495a9261c4a2a5d4e879cfb55c060b4616a846d3425c441a9e31aa34c956f",\ "blockNumber": "10720863",\ "timestamp": "1598242563",\ "contractFactory": "",\ "creationBytecode": "0x602d3d8160093d39f3363d3d373d3d3d363d73c6cf0f044ba8ea402bfedf9e87b88bf1c008d1625af43d82803e903d91602b57fd5bf3"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#param-action) action string default:"getcontractcreation" Set to `getcontractcreation` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation#param-contractaddresses) contractaddresses string Up to 5 contract addresses, separated by commas. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "contractAddress": "0xcbdcd3815b5f975e1a2c944a9b2cd1c985a1cb7f",\ "contractCreator": "0x3d080421c9dd5fb387d6e3124f7e1c241ade9568",\ "txHash": "0xdce495a9261c4a2a5d4e879cfb55c060b4616a846d3425c441a9e31aa34c956f",\ "blockNumber": "10720863",\ "timestamp": "1598242563",\ "contractFactory": "",\ "creationBytecode": "0x602d3d8160093d39f3363d3d373d3d3d363d73c6cf0f044ba8ea402bfedf9e87b88bf1c008d1625af43d82803e903d91602b57fd5bf3"\ }\ ] } [Get Contract Source Code](https://docs.etherscan.io/api-reference/endpoint/getsourcecode) [Verify Solidity Source Code](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode) ⌘I --- # Get Contract ABI - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getabi#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Get Contract ABI [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Contract ABI cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "[{\"constant\":false,\"inputs\":[{\"name\":\"_c\",\"type\":\"string\"}],\"name\":\"enterValue\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"test\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]" } ### [​](https://docs.etherscan.io/api-reference/endpoint/getabi#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getabi#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getabi#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getabi#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getabi#param-action) action string default:"getabi" Set to `getabi` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getabi#param-address) address string default:"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413" The contract address to query. Response Copy Ask AI { "status": "1", "message": "OK", "result": "[{\"constant\":false,\"inputs\":[{\"name\":\"_c\",\"type\":\"string\"}],\"name\":\"enterValue\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"test\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]" } [Get Daily Uncle Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount) [Get Contract Source Code](https://docs.etherscan.io/api-reference/endpoint/getsourcecode) ⌘I --- # Get ERC20-Token Account Balance for TokenContractAddress - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get ERC20-Token Account Balance for TokenContractAddress [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalance&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "135499" } ### [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-action) action string default:"tokenbalance" Set to `tokenbalance` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-contractaddress) contractaddress string default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055" Contract address of the ERC-20 token. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-address) address string default:"0xe04f27eb70e025b78871a2ad7eabe85e61212761" Address to check for token balance. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalance#param-tag) tag string default:"latest" Use `latest` for the last block number of the chain. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalance&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&tag=latest&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "135499" } [Get ERC20-Token TotalSupply by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokensupply) [Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory) ⌘I --- # Verify Stylus Source Code - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/verifystylus#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Verify Stylus Source Code [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) POST https://api.etherscan.io / v2 / api Try it Verify Stylus Source Code cURL Copy Ask AI curl --request POST \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } This endpoint is only available for the Arbitrum stack chains. ### [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-chainid) chainid string default:"42161" Chain ID to query, eg `42161` for Arbitrum One from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-action) action string default:"verifysourcecode" Set to `verifysourcecode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-codeformat) codeformat string default:"stylus" Use `stylus` for Stylus projects. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-source-code) sourceCode string Public Git repository that hosts the Stylus source code. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-contractaddress) contractaddress string default:"0x915f0B2f34F5B5b84D1F066b398D7F0E3C2F8f83" The address where the contract is deployed. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-contractname) contractname string default:"stylus\_hello\_world" The contract name that matches your Stylus deployment. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-compilerversion) compilerversion string default:"stylus:0.5.3" Stylus compiler version used for compilation. [​](https://docs.etherscan.io/api-reference/endpoint/verifystylus#param-license-type) licenseType integer default:"3" License identifier from the [open source license options](https://arbiscan.io/contract-license-types) . Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } [Verify Vyper Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyvyper) [Check Source Code Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus) ⌘I --- # Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=tokensupplyhistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&blockno=8000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "21265524714464" } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-action) action string default:"tokensupplyhistory" Set to `tokensupplyhistory` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-contractaddress) contractaddress string default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055" Contract address of the ERC-20 token. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory#param-blockno) blockno integer default:"8000000" Block number to check total supply for. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=tokensupplyhistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&blockno=8000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "21265524714464" } [Get ERC20-Token Account Balance for TokenContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokenbalance) [Get Historical ERC20-Token Account Balance by BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory) ⌘I --- # Verify Source Code on zkSync - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Verify Source Code on zkSync [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) POST https://api.etherscan.io / v2 / api Try it Verify Source Code on zkSync cURL Copy Ask AI curl --request POST \ --url https://api.etherscan.io/v2/api ### [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-chainid) chainid string default:"324" Chain ID to query, eg `324` for zkSync Era from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-action) action string default:"verifysourcecode" Set to `verifysourcecode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-codeformat) codeformat string default:"solidity-standard-json-input" Use `solidity-single-file` for a single file or `solidity-standard-json-input` for JSON input. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-source-code) sourceCode string The Solidity source code to verify. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-constructor-arguments) constructorArguments string Optional constructor arguments used in contract deployment. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-contractaddress) contractaddress string default:"0xf66f984e0b73453193b452f84c8fff0ed19f6d81" The address where the contract is deployed. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-contractname) contractname string default:"contracts/Verified.sol:Verified" The contract name, including path if applicable. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-compilerversion) compilerversion string default:"v0.8.24+commit.e11b9ed9" Compiler version used for compilation. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-zksolc-version) zksolcVersion string default:"1.3.13" zkSync compiler version used for compilation. [​](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode#param-compilermode) compilermode string default:"zksync" zkSync compiler mode to process the build artifacts. [Verify Solidity Source Code](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode) [Verify Vyper Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyvyper) ⌘I --- # Verify Vyper Source Code - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Verify Vyper Source Code [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) POST https://api.etherscan.io / api Try it Verify Vyper Source Code cURL Copy Ask AI curl --request POST \ --url https://api.etherscan.io/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } ### [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-action) action string default:"verifysourcecode" Set to `verifysourcecode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-codeformat) codeformat string default:"vyper-json" Use `vyper-json` for Vyper contracts. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-source-code) sourceCode string The Vyper source code in JSON format. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-constructor-arguments) constructorArguments string Optional constructor arguments used in contract deployment. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-contractaddress) contractaddress string default:"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413" The address where the contract is deployed. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-contractname) contractname string default:"contracts/Verified.vy:Verified" The contract name, including path if applicable. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-compilerversion) compilerversion string default:"vyper:0.4.0" Compiler version used for compilation. [​](https://docs.etherscan.io/api-reference/endpoint/verifyvyper#param-optimization-used) optimizationUsed string default:"0" Use `1` if compiler optimizations were enabled, otherwise `0`. Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } [Verify Source Code on zkSync](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode) [Verify Stylus Source Code](https://docs.etherscan.io/api-reference/endpoint/verifystylus) ⌘I --- # Get Address Funded By - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/fundedby#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Address Funded By [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Funding Address for an Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": { "block": 53708500, "timeStamp": "1708349932", "fundingAddress": "0x6969174fd72466430a46e18234d0b530c9fd5f49", "fundingTxn": "0xbc0ca4a67eb1555920552246409626cd60df01314dd2bcdb99718b506d9c9946", "value": "1000000000000000" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `137` for Polygon from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#param-action) action string default:"fundedby" Set to `fundedby` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/fundedby#param-address) address string default:"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97" The address to query, like `0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97`. Response Copy Ask AI { "status": "1", "message": "OK", "result": { "block": 53708500, "timeStamp": "1708349932", "fundingAddress": "0x6969174fd72466430a46e18234d0b530c9fd5f49", "fundingTxn": "0xbc0ca4a67eb1555920552246409626cd60df01314dd2bcdb99718b506d9c9946", "value": "1000000000000000" } } [Get Beacon Chain Withdrawals by Address](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal) [Get Block and Uncle Rewards by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockreward) ⌘I --- # Get Token Holder List by Contract Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Token Holder List by Contract Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokenholderlist&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&page=1&offset=10&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenHolderAddress": "0xa5b7d615c99f011a22f16f5809890ca6900200a3",\ "TokenHolderQuantity": "2"\ },\ {\ "TokenHolderAddress": "0x0412a1d25fbdcabc536603198330021ccb13240b",\ "TokenHolderQuantity": "3385700"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-module) module string default:"token" Set to `token` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-action) action string default:"tokenholderlist" Set to `tokenholderlist` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-contractaddress) contractaddress string default:"0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d" Contract address of the ERC-20 token. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist#param-offset) offset integer default:"10" Number of records per page. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokenholderlist&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&page=1&offset=10&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "TokenHolderAddress": "0xa5b7d615c99f011a22f16f5809890ca6900200a3",\ "TokenHolderQuantity": "2"\ },\ {\ "TokenHolderAddress": "0x0412a1d25fbdcabc536603198330021ccb13240b",\ "TokenHolderQuantity": "3385700"\ }\ ] } [Get Top Token Holders](https://docs.etherscan.io/api-reference/endpoint/toptokenholders) [Get Token Holder Count by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount) ⌘I --- # Verify Proxy Contract - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Verify Proxy Contract [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) POST https://api.etherscan.io / api Try it Verify Proxy Contract cURL Copy Ask AI curl --request POST \ --url https://api.etherscan.io/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } ### [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-action) action string default:"verifyproxycontract" Set to `verifyproxycontract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-address) address string default:"0xcbdcd3815b5f975e1a2c944a9b2cd1c985a1cb7f" The proxy contract address to verify. [​](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract#param-expectedimplementation) expectedimplementation string default:"0xB0F24CEB2616F6Bb608B00875Db306167c0f2E8C" Optional implementation address to enforce during verification. Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } [Check Source Code Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus) [Check Proxy Contract Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification) ⌘I --- # Verify Solidity Source Code - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Verify Solidity Source Code [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) POST https://api.etherscan.io / api Try it Verify Solidity Source Code cURL Copy Ask AI curl --request POST \ --url https://api.etherscan.io/api Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } ### [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-action) action string default:"verifysourcecode" Set to `verifysourcecode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-contractaddress) contractaddress string default:"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413" The address where the contract is deployed. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-source-code) sourceCode string The Solidity source code to verify. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-codeformat) codeformat string default:"solidity-standard-json-input" Use `solidity-single-file` for a single file or `solidity-standard-json-input` for JSON input. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-contractname) contractname string default:"contracts/Verified.sol:Verified" The contract name, including path if applicable. If `codeformat=solidity-standard-json-input`, then enter contractname as `erc20.sol:erc20`. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-compilerversion) compilerversion string default:"v0.8.24+commit.e11b9ed9" Compiler version used for compilation. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-optimization-used) optimizationUsed string default:"0" Use `1` if optimization was used or `0` if disabled, specify runs below. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-runs) runs string default:"200" Number of optimization runs. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-constructor-arguments) constructorArguments string Optional constructor arguments used in contract deployment. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-evm-version) evmVersion string default:"default" Use compiler `default` or specify an EVM version such as `byzantium`, `shanghai`. [​](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode#param-license-type) licenseType string default:"1" The [open source license](https://etherscan.io/contract-license-types) to associate with the verified source code, e.g `3` for MIT. Response Copy Ask AI { "status": "1", "message": "OK", "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj" } [Get Contract Creator and Creation Tx Hash](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation) [Verify Source Code on zkSync](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode) ⌘I --- # Get Blocks Validated by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Blocks Validated by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Blocks Validated by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "20226140",\ "timeStamp": "1720011623",\ "blockReward": "33424103001400554"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-action) action string default:"getminedblocks" Set to `getminedblocks` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-address) address string default:"0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b" Validator The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe`. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-blocktype) blocktype string default:"blocks" Use `blocks` for full blocks, optionally `uncles` for [pre-Merge](https://ethereum.org/en/roadmap/merge/) blocks. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/getminedblocks#param-offset) offset integer default:"1" Number of records per page. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "20226140",\ "timeStamp": "1720011623",\ "blockReward": "33424103001400554"\ }\ ] } [Get Internal Transactions by Transaction Hash](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash) [Get Beacon Chain Withdrawals by Address](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal) ⌘I --- # Get Top Token Holders - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Top Token Holders [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=topholders&contractaddress=0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9&offset=100&apikey=YourApiKeyToken" Response Copy Ask AI { "status": "1", "message": "Ok", "result": [\ {\ "TokenHolderAddress": "0x4da27a545c0c5b758a6ba100e3a049001de870f5",\ "TokenHolderQuantity": "2696124.3026660371030000",\ "TokenHolderAddressType": "C"\ },\ {\ "TokenHolderAddress": "0xa700b4eb416be35b2911fd5dee80678ff64ff6c9",\ "TokenHolderQuantity": "1650828.8050095955930000",\ "TokenHolderAddressType": "C"\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. HyperEVM (999) is not supported yet ![Token holders](https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=2500&fit=max&auto=format&n=_gIsWVKPgcVhiZQW&q=85&s=10569f23cde4d2374743a40c7f6fc00d) ### [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-module) module string default:"token" Set to `token` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-action) action string default:"topholders" Set to `topholders` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-contractaddress) contractaddress string default:"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9" Contract address of the ERC-20 token. [​](https://docs.etherscan.io/api-reference/endpoint/toptokenholders#param-offset) offset integer default:"100" Number of top holders to return, up to 1000. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=topholders&contractaddress=0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9&offset=100&apikey=YourApiKeyToken" Response Copy Ask AI { "status": "1", "message": "Ok", "result": [\ {\ "TokenHolderAddress": "0x4da27a545c0c5b758a6ba100e3a049001de870f5",\ "TokenHolderQuantity": "2696124.3026660371030000",\ "TokenHolderAddressType": "C"\ },\ {\ "TokenHolderAddress": "0xa700b4eb416be35b2911fd5dee80678ff64ff6c9",\ "TokenHolderQuantity": "1650828.8050095955930000",\ "TokenHolderAddressType": "C"\ }\ ] } [Get Historical ERC20-Token Account Balance by BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory) [Get Token Holder List by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist) ⌘I --- # Get Internal Transactions by Transaction Hash - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Internal Transactions by Transaction Hash [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Internal Transactions by Transaction Hash cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "1743059",\ "timeStamp": "1466489498",\ "from": "0x2cac6e4b11d6b58f6d3c1c9d5fe8faa89f60e5a2",\ "to": "0x66a1c3eaf0f1ffc28d209c0763ed0ca614f3b002",\ "value": "7106740000000000",\ "contractAddress": "",\ "input": "",\ "type": "call",\ "gas": "2300",\ "gasUsed": "0",\ "isError": "0",\ "errCode": ""\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#param-module) module string default:"account" Set to `account` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#param-action) action string default:"txlistinternal" Set to `txlistinternal` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash#param-txhash) txhash string Transaction hash to check for internal transactions, like `0x36dc7f05085d0e4f9c3e4116345a2a487ac8f23f7e71bcc0ae20e27abbfa931d`. Only non-zero value internal transactions are returned. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "1743059",\ "timeStamp": "1466489498",\ "from": "0x2cac6e4b11d6b58f6d3c1c9d5fe8faa89f60e5a2",\ "to": "0x66a1c3eaf0f1ffc28d209c0763ed0ca614f3b002",\ "value": "7106740000000000",\ "contractAddress": "",\ "input": "",\ "type": "call",\ "gas": "2300",\ "gasUsed": "0",\ "isError": "0",\ "errCode": ""\ }\ ] } [Get Internal Transactions by Block Range](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange) [Get Blocks Validated by Address](https://docs.etherscan.io/api-reference/endpoint/getminedblocks) ⌘I --- # Get Historical ERC20-Token Account Balance by BlockNo - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Historical ERC20-Token Account Balance by BlockNo [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "135499" } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-action) action string default:"tokenbalancehistory" Set to `tokenbalancehistory` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-contractaddress) contractaddress string default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055" Contract address of the ERC-20 token. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-address) address string default:"0xe04f27eb70e025b78871a2ad7eabe85e61212761" Address to check for balance. [​](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory#param-blockno) blockno integer default:"8000000" Block number to check balance for. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=tokenbalancehistory&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761&blockno=8000000&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "135499" } [Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory) [Get Top Token Holders](https://docs.etherscan.io/api-reference/endpoint/toptokenholders) ⌘I --- # Get Token Holder Count by Contract Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Token Holder Count by Contract Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokenholdercount&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "30506" } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above ### [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#param-module) module string default:"token" Set to `token` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#param-action) action string default:"tokenholdercount" Set to `tokenholdercount` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount#param-contractaddress) contractaddress string default:"0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d" Contract address of the ERC-20 token. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokenholdercount&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "30506" } [Get Token Holder List by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist) [Get Token Info by ContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokeninfo) ⌘I --- # Get Total Nodes Count - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/nodecount#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Stats Get Total Nodes Count [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=nodecount&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "UTCDate": "2025-09-25", "TotalNodeCount": "11786" } } ### [​](https://docs.etherscan.io/api-reference/endpoint/nodecount#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/nodecount#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/nodecount#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/nodecount#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/nodecount#param-action) action string default:"nodecount" Set to `nodecount` for this endpoint. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=nodecount&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": { "UTCDate": "2025-09-25", "TotalNodeCount": "11786" } } [Get Ethereum Nodes Size](https://docs.etherscan.io/api-reference/endpoint/chainsize) [Get Daily Network Transaction Fee](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee) ⌘I --- # Get Contract Source Code - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Contracts Get Contract Source Code [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Contract Source Code cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "SourceCode": "pragma solidity 0.4.26;\r\n\r\ncontract Test12345 {\r\n string public test;\r\n \r\n function enterValue(string _c) {\r\n test = _c;\r\n }\r\n}",\ "ABI": "[{\"constant\":false,\"inputs\":[{\"name\":\"_c\",\"type\":\"string\"}],\"name\":\"enterValue\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"test\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]",\ "ContractName": "Test12345",\ "CompilerVersion": "v0.4.26+commit.4563c3fc",\ "CompilerType": "solc",\ "OptimizationUsed": "1",\ "Runs": "200",\ "ConstructorArguments": "",\ "EVMVersion": "Default",\ "Library": "",\ "ContractFileName": "",\ "LicenseType": "None",\ "Proxy": "0",\ "Implementation": "",\ "SwarmSource": "bzzr://f6b932198e10e83a6c872406a4252cf5eea48f37bac9a33085eba887820370cf",\ "SimilarMatch": "0x60810f4d8a618edb533a168e790ab6c09b0e7707"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#param-module) module string default:"contract" Set to `contract` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#param-action) action string default:"getsourcecode" Set to `getsourcecode` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/getsourcecode#param-address) address string default:"0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413" The contract address to query. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "SourceCode": "pragma solidity 0.4.26;\r\n\r\ncontract Test12345 {\r\n string public test;\r\n \r\n function enterValue(string _c) {\r\n test = _c;\r\n }\r\n}",\ "ABI": "[{\"constant\":false,\"inputs\":[{\"name\":\"_c\",\"type\":\"string\"}],\"name\":\"enterValue\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[],\"name\":\"test\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}]",\ "ContractName": "Test12345",\ "CompilerVersion": "v0.4.26+commit.4563c3fc",\ "CompilerType": "solc",\ "OptimizationUsed": "1",\ "Runs": "200",\ "ConstructorArguments": "",\ "EVMVersion": "Default",\ "Library": "",\ "ContractFileName": "",\ "LicenseType": "None",\ "Proxy": "0",\ "Implementation": "",\ "SwarmSource": "bzzr://f6b932198e10e83a6c872406a4252cf5eea48f37bac9a33085eba887820370cf",\ "SimilarMatch": "0x60810f4d8a618edb533a168e790ab6c09b0e7707"\ }\ ] } [Get Contract ABI](https://docs.etherscan.io/api-reference/endpoint/getabi) [Get Contract Creator and Creation Tx Hash](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation) ⌘I --- # Get ERC721 Token Transfers by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get ERC721 Token Transfers by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get ERC721 Token Transfers by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "4708120",\ "timeStamp": "1512907118",\ "hash": "0x031e6968a8de362e4328d60dcc7f72f0d6fc84284c452f63176632177146de66",\ "nonce": "0",\ "blockHash": "0x4be19c278bfaead5cb0bc9476fa632e2447f6e6259e0303af210302d22779a24",\ "from": "0xb1690c08e213a35ed9bab7b318de14420fb57d8c",\ "contractAddress": "0x06012c8cf97bead5deae237070f9587f8e7a266d",\ "to": "0x6975be450864c02b4613023c2152ee0743572325",\ "tokenID": "202106",\ "tokenName": "CryptoKitties",\ "tokenSymbol": "CK",\ "tokenDecimal": "0",\ "transactionIndex": "81",\ "gas": "158820",\ "gasPrice": "40000000000",\ "gasUsed": "60508",\ "cumulativeGasUsed": "4880352",\ "input": "deprecated",\ "methodId": "0x454a2ab3",\ "functionName": "bid(uint256 _tokenId)",\ "confirmations": "18759540"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-action) action string default:"tokennfttx" Set to `tokennfttx` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-contractaddress) contractaddress string default:"0x06012c8cf97bead5deae237070f9587f8e7a266d" The ERC721 token contract address to filter transfers by, eg `0xbd3531da5cf5857e7cfaa92426877b022e612cf8` for [Pudgy Penguins](https://etherscan.io/token/0xbd3531da5cf5857e7cfaa92426877b022e612cf8) . [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-address) address string default:"0x6975be450864c02b4613023c2152ee0743572325" Address to filter token transfers by. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/tokennfttx#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "4708120",\ "timeStamp": "1512907118",\ "hash": "0x031e6968a8de362e4328d60dcc7f72f0d6fc84284c452f63176632177146de66",\ "nonce": "0",\ "blockHash": "0x4be19c278bfaead5cb0bc9476fa632e2447f6e6259e0303af210302d22779a24",\ "from": "0xb1690c08e213a35ed9bab7b318de14420fb57d8c",\ "contractAddress": "0x06012c8cf97bead5deae237070f9587f8e7a266d",\ "to": "0x6975be450864c02b4613023c2152ee0743572325",\ "tokenID": "202106",\ "tokenName": "CryptoKitties",\ "tokenSymbol": "CK",\ "tokenDecimal": "0",\ "transactionIndex": "81",\ "gas": "158820",\ "gasPrice": "40000000000",\ "gasUsed": "60508",\ "cumulativeGasUsed": "4880352",\ "input": "deprecated",\ "methodId": "0x454a2ab3",\ "functionName": "bid(uint256 _tokenId)",\ "confirmations": "18759540"\ }\ ] } [Get ERC20 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokentx) [Get ERC1155 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/token1155tx) ⌘I --- # Get Token Info by ContractAddress - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get Token Info by ContractAddress [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io/v2/api / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokeninfo&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "contractAddress": "0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",\ "tokenName": "Gods Unchained Cards",\ "symbol": "CARD",\ "divisor": "0",\ "tokenType": "ERC721",\ "totalSupply": "6972003",\ "blueCheckmark": "true",\ "description": "A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets.",\ "website": "https://godsunchained.com/",\ "email": "",\ "blog": "https://medium.com/@fuelgames",\ "reddit": "https://www.reddit.com/r/GodsUnchained/",\ "slack": "",\ "facebook": "https://www.facebook.com/godsunchained/",\ "twitter": "https://twitter.com/godsunchained",\ "bitcointalk": "",\ "github": "",\ "telegram": "",\ "wechat": "",\ "linkedin": "",\ "discord": "https://discordapp.com/invite/DKGr2pW",\ "whitepaper": "",\ "tokenPriceUSD": "0.000000000000000000",\ "image": ""\ }\ ] } This is a PRO endpoint, available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above This endpoint is throttled to **2 calls/second** regardless of API Pro tier. ### [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#param-module) module string default:"token" Set to `token` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#param-action) action string default:"tokeninfo" Set to `tokeninfo` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokeninfo#param-contractaddress) contractaddress string default:"0x0e3a2a1f2146d86a604adc220b4967a898d7fe07" Contract address of the token to retrieve info for. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokeninfo&contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "contractAddress": "0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",\ "tokenName": "Gods Unchained Cards",\ "symbol": "CARD",\ "divisor": "0",\ "tokenType": "ERC721",\ "totalSupply": "6972003",\ "blueCheckmark": "true",\ "description": "A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets.",\ "website": "https://godsunchained.com/",\ "email": "",\ "blog": "https://medium.com/@fuelgames",\ "reddit": "https://www.reddit.com/r/GodsUnchained/",\ "slack": "",\ "facebook": "https://www.facebook.com/godsunchained/",\ "twitter": "https://twitter.com/godsunchained",\ "bitcointalk": "",\ "github": "",\ "telegram": "",\ "wechat": "",\ "linkedin": "",\ "discord": "https://discordapp.com/invite/DKGr2pW",\ "whitepaper": "",\ "tokenPriceUSD": "0.000000000000000000",\ "image": ""\ }\ ] } [Get Token Holder Count by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount) [Get Address ERC20 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance) ⌘I --- # Get Internal Transactions by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Internal Transactions by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Internal Transactions by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "2535368",\ "timeStamp": "1477837690",\ "hash": "0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",\ "from": "0x20d42f2e99a421147acf198d775395cac2e8b03d",\ "to": "",\ "value": "0",\ "contractAddress": "0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",\ "input": "",\ "type": "create",\ "gas": "254791",\ "gasUsed": "46750",\ "traceId": "0",\ "isError": "0",\ "errCode": ""\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-module) module string default:"account" Set to `account` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-action) action string default:"txlistinternal" Set to `txlistinternal` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-address) address string default:"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe`. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "2535368",\ "timeStamp": "1477837690",\ "hash": "0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",\ "from": "0x20d42f2e99a421147acf198d775395cac2e8b03d",\ "to": "",\ "value": "0",\ "contractAddress": "0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",\ "input": "",\ "type": "create",\ "gas": "254791",\ "gasUsed": "46750",\ "traceId": "0",\ "isError": "0",\ "errCode": ""\ }\ ] } [Get ERC1155 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/token1155tx) [Get Internal Transactions by Block Range](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange) ⌘I --- # Get ERC1155 Token Transfers by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/token1155tx#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get ERC1155 Token Transfers by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get ERC1155 Token Transfers by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "13472395",\ "timeStamp": "1634973285",\ "hash": "0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d",\ "nonce": "41",\ "blockHash": "0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6",\ "transactionIndex": "100",\ "gas": "140000",\ "gasPrice": "52898577246",\ "gasUsed": "105030",\ "cumulativeGasUsed": "11739203",\ "input": "deprecated",\ "methodId": "0x3e6b214b",\ "functionName": "",\ "contractAddress": "0x76be3b62873462d2142405439777e971754e8e77",\ "from": "0x1e63326a84d2fa207bdfa856da9278a93deba418",\ "to": "0x83f564d180b58ad9a02a449105568189ee7de8cb",\ "tokenID": "10371",\ "tokenValue": "1",\ "tokenName": "parallel",\ "tokenSymbol": "LL",\ "confirmations": "9995266"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-action) action string default:"token1155tx" Set to `token1155tx` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-contractaddress) contractaddress string default:"0x76be3b62873462d2142405439777e971754e8e77" The ERC1155 token contract address to filter transfers by, eg `0x495f947276749ce646f68ac8c248420045cb7b5e` for [Opensea Shared Storefront](https://etherscan.io/token/0x495f947276749ce646f68ac8c248420045cb7b5e) . [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-address) address string default:"0x83f564d180b58ad9a02a449105568189ee7de8cb" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe` [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/token1155tx#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "13472395",\ "timeStamp": "1634973285",\ "hash": "0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d",\ "nonce": "41",\ "blockHash": "0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6",\ "transactionIndex": "100",\ "gas": "140000",\ "gasPrice": "52898577246",\ "gasUsed": "105030",\ "cumulativeGasUsed": "11739203",\ "input": "deprecated",\ "methodId": "0x3e6b214b",\ "functionName": "",\ "contractAddress": "0x76be3b62873462d2142405439777e971754e8e77",\ "from": "0x1e63326a84d2fa207bdfa856da9278a93deba418",\ "to": "0x83f564d180b58ad9a02a449105568189ee7de8cb",\ "tokenID": "10371",\ "tokenValue": "1",\ "tokenName": "parallel",\ "tokenSymbol": "LL",\ "confirmations": "9995266"\ }\ ] } [Get ERC721 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokennfttx) [Get Internal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/txlistinternal) ⌘I --- # Get ERC20-Token TotalSupply by ContractAddress - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokensupply#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Tokens Get ERC20-Token TotalSupply by ContractAddress [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=tokensupply&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "21265524714464" } ### [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#param-module) module string default:"stats" Set to `stats` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#param-action) action string default:"tokensupply" Set to `tokensupply` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/tokensupply#param-contractaddress) contractaddress string default:"0x57d90b64a1a57749b0f932f1a3395792e12e7055" Contract address of the ERC-20 token. Copy Ask AI curl "https://api.etherscan.io/v2/api?chainid=1&module=stats&action=tokensupply&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055&apikey=YourApiKeyToken" Copy Ask AI { "status": "1", "message": "OK", "result": "21265524714464" } [Check Transaction Receipt Status](https://docs.etherscan.io/api-reference/endpoint/gettxreceiptstatus) [Get ERC20-Token Account Balance for TokenContractAddress](https://docs.etherscan.io/api-reference/endpoint/tokenbalance) ⌘I --- # Get ERC20 Token Transfers by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/tokentx#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get ERC20 Token Transfers by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get ERC20 Token Transfers by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "4730207",\ "timeStamp": "1513240363",\ "hash": "0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4",\ "nonce": "406",\ "blockHash": "0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37",\ "from": "0x642ae78fafbb8032da552d619ad43f1d81e4dd7c",\ "contractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",\ "to": "0x4e83362442b8d1bec281594cea3050c8eb01311c",\ "value": "5901522149285533025181",\ "tokenName": "Maker",\ "tokenSymbol": "MKR",\ "tokenDecimal": "18",\ "transactionIndex": "81",\ "gas": "940000",\ "gasPrice": "32010000000",\ "gasUsed": "77759",\ "cumulativeGasUsed": "2523379",\ "input": "deprecated",\ "methodId": "0xbe040fb0",\ "functionName": "redeem()",\ "confirmations": "18737452"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-module) module string default:"account" Set to `account` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-action) action string default:"tokentx" Set to `tokentx` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-contractaddress) contractaddress string default:"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2" The ERC20 token contract address to filter transfers by, eg `0xdac17f958d2ee523a2206206994597c13d831ec7` for USDT. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-address) address string default:"0x4e83362442b8d1bec281594cea3050c8eb01311c" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe` [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/tokentx#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "4730207",\ "timeStamp": "1513240363",\ "hash": "0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4",\ "nonce": "406",\ "blockHash": "0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37",\ "from": "0x642ae78fafbb8032da552d619ad43f1d81e4dd7c",\ "contractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",\ "to": "0x4e83362442b8d1bec281594cea3050c8eb01311c",\ "value": "5901522149285533025181",\ "tokenName": "Maker",\ "tokenSymbol": "MKR",\ "tokenDecimal": "18",\ "transactionIndex": "81",\ "gas": "940000",\ "gasPrice": "32010000000",\ "gasUsed": "77759",\ "cumulativeGasUsed": "2523379",\ "input": "deprecated",\ "methodId": "0xbe040fb0",\ "functionName": "redeem()",\ "confirmations": "18737452"\ }\ ] } [Get Normal Transactions By Address](https://docs.etherscan.io/api-reference/endpoint/txlist) [Get ERC721 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokennfttx) ⌘I --- # Get Internal Transactions by Block Range - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Internal Transactions by Block Range [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Internal Transactions by Block Range cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "13481773",\ "timeStamp": "1635100060",\ "hash": "0x8b440f5ec0e986589517b131c5b75e921f2768b9912f028d2cdb009d759036ab",\ "from": "0x3909336de913344701c6f096502d26208210b39f",\ "to": "0xff62dfadca3b5643d0b283571fe154d886580c0c",\ "value": "1159078546481168231",\ "contractAddress": "",\ "input": "",\ "type": "call",\ "gas": "101300",\ "gasUsed": "13898",\ "traceId": "3",\ "isError": "0",\ "errCode": ""\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-action) action string default:"txlistinternal" Set to `txlistinternal` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-startblock) startblock integer default:"13481773" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "13481773",\ "timeStamp": "1635100060",\ "hash": "0x8b440f5ec0e986589517b131c5b75e921f2768b9912f028d2cdb009d759036ab",\ "from": "0x3909336de913344701c6f096502d26208210b39f",\ "to": "0xff62dfadca3b5643d0b283571fe154d886580c0c",\ "value": "1159078546481168231",\ "contractAddress": "",\ "input": "",\ "type": "call",\ "gas": "101300",\ "gasUsed": "13898",\ "traceId": "3",\ "isError": "0",\ "errCode": ""\ }\ ] } [Get Internal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/txlistinternal) [Get Internal Transactions by Transaction Hash](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash) ⌘I --- # Get Beacon Chain Withdrawals by Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Beacon Chain Withdrawals by Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Beacon Chain Withdrawals by Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "withdrawalIndex": "13",\ "validatorIndex": "117823",\ "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",\ "amount": "3402931175",\ "blockNumber": "17034877",\ "timestamp": "1681338599"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-module) module string default:"account" Set to `account` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-action) action string default:"txsBeaconWithdrawal" Set to `txsBeaconWithdrawal` for this endpoint. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-address) address string default:"0xB9D7934878B5FB9610B3fE8A5e441e8fad7E293f" Address to check for beacon withdrawals. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-offset) offset integer default:"1" Number of records per page. [​](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "withdrawalIndex": "13",\ "validatorIndex": "117823",\ "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",\ "amount": "3402931175",\ "blockNumber": "17034877",\ "timestamp": "1681338599"\ }\ ] } [Get Blocks Validated by Address](https://docs.etherscan.io/api-reference/endpoint/getminedblocks) [Get Address Funded By](https://docs.etherscan.io/api-reference/endpoint/fundedby) ⌘I --- # Get Normal Transactions By Address - Etherscan [Skip to main content](https://docs.etherscan.io/api-reference/endpoint/txlist#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Account Get Normal Transactions By Address [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) GET https://api.etherscan.io / v2 / api Try it Get Normal Transactions By Address cURL Copy Ask AI curl --request GET \ --url https://api.etherscan.io/v2/api Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "23467053",\ "blockHash": "0xf5646226f819fbdd6b2f1cb99de6e5d17da3d876ec166e69f4e9736c8ebf7ab4",\ "timeStamp": "1759129619",\ "hash": "0xf9db905d77704596d3600816bc70201586cfeec13bcf576320e2f38d6ca851a0",\ "nonce": "8",\ "transactionIndex": "184",\ "from": "0x2449ecef5012f0a0e153b278ef4fcc9625bc4c78",\ "to": "0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc",\ "value": "0",\ "gas": "73271",\ "gasPrice": "238744402",\ "input": "0x5c19a95c0000000000000000000000002449ecef5012f0a0e153b278ef4fcc9625bc4c78",\ "methodId": "0x5c19a95c",\ "functionName": "delegate(address to)",\ "contractAddress": "",\ "cumulativeGasUsed": "22498564",\ "txreceipt_status": "1",\ "gasUsed": "48847",\ "confirmations": "589",\ "isError": "0"\ }\ ] } ### [​](https://docs.etherscan.io/api-reference/endpoint/txlist#query-parameters) Query Parameters [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-apikey) apikey string default:"YourApiKeyToken" Your Etherscan API key. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-chainid) chainid string default:"1" Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](https://docs.etherscan.io/supported-chains) . [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-module) module string default:"account" Set to `account` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-action) action string default:"txlist" Set to `txlist` for this endpoint [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-address) address string default:"0xc5102fE9359FD9a28f877a67E36B0F050d81a3CC" The address to query, like `0xfefefefefefefefefefefefefefefefefefefefe`. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-startblock) startblock integer default:"0" Starting block number to search from. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-endblock) endblock integer default:"9999999999" Ending block number to search to. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-page) page integer default:"1" Page number for pagination. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-offset) offset integer default:"1" Number of transactions per page. [​](https://docs.etherscan.io/api-reference/endpoint/txlist#param-sort) sort string default:"desc" Sort order either `desc` for the latest transactions first or `asc` for the oldest transactions first. Response Copy Ask AI { "status": "1", "message": "OK", "result": [\ {\ "blockNumber": "23467053",\ "blockHash": "0xf5646226f819fbdd6b2f1cb99de6e5d17da3d876ec166e69f4e9736c8ebf7ab4",\ "timeStamp": "1759129619",\ "hash": "0xf9db905d77704596d3600816bc70201586cfeec13bcf576320e2f38d6ca851a0",\ "nonce": "8",\ "transactionIndex": "184",\ "from": "0x2449ecef5012f0a0e153b278ef4fcc9625bc4c78",\ "to": "0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc",\ "value": "0",\ "gas": "73271",\ "gasPrice": "238744402",\ "input": "0x5c19a95c0000000000000000000000002449ecef5012f0a0e153b278ef4fcc9625bc4c78",\ "methodId": "0x5c19a95c",\ "functionName": "delegate(address to)",\ "contractAddress": "",\ "cumulativeGasUsed": "22498564",\ "txreceipt_status": "1",\ "gasUsed": "48847",\ "confirmations": "589",\ "isError": "0"\ }\ ] } [Get Historical Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balancehistory) [Get ERC20 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokentx) ⌘I --- # PRO Endpoints - Etherscan [Skip to main content](https://docs.etherscan.io/resources/pro-endpoints#content-area) [Etherscan home page![light logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-dark.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=de6b19ab2ee635186e20de82cb4684a0)![dark logo](https://mintcdn.com/etherscan/3Bzz_zQxnltPim9f/logo/etherscan-logo-light.svg?fit=max&auto=format&n=3Bzz_zQxnltPim9f&q=85&s=637b866d48682d2277ff49a88ee1b61d)](https://docs.etherscan.io/) Search... ⌘K Search... Navigation Resources PRO Endpoints [API Documentation](https://docs.etherscan.io/introduction) [Model Context Protocol (MCP)](https://docs.etherscan.io/mcp-docs/introduction) [Metadata CSV](https://docs.etherscan.io/metadata/introduction) On this page * [Account](https://docs.etherscan.io/resources/pro-endpoints#account) * [Tokens](https://docs.etherscan.io/resources/pro-endpoints#tokens) * [Blocks](https://docs.etherscan.io/resources/pro-endpoints#blocks) * [Stats](https://docs.etherscan.io/resources/pro-endpoints#stats) * [Gas Tracker](https://docs.etherscan.io/resources/pro-endpoints#gas-tracker) * [Nametags](https://docs.etherscan.io/resources/pro-endpoints#nametags) A complete list of PRO endpoints available to the [Standard Plan](https://docs.etherscan.io/resources/rate-limits) and above. [​](https://docs.etherscan.io/resources/pro-endpoints#account) Account ------------------------------------------------------------------------- * [Get Historical Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balancehistory) [​](https://docs.etherscan.io/resources/pro-endpoints#tokens) Tokens ----------------------------------------------------------------------- * [Get Historical ERC20-Token Account Balance by BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokenbalancehistory) * [Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo](https://docs.etherscan.io/api-reference/endpoint/tokensupplyhistory) * [Get Top Token Holders](https://docs.etherscan.io/api-reference/endpoint/toptokenholders) * [Get Token Holder List by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholderlist) * [Get Token Holder Count by Contract Address](https://docs.etherscan.io/api-reference/endpoint/tokenholdercount) * [Get Address ERC20 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokenbalance) * [Get Address ERC721 Token Holding](https://docs.etherscan.io/api-reference/endpoint/addresstokennftbalance) * [Get Address ERC721 Token Inventory by Contract](https://docs.etherscan.io/api-reference/endpoint/addresstokennftinventory) [​](https://docs.etherscan.io/resources/pro-endpoints#blocks) Blocks ----------------------------------------------------------------------- * [Get Daily Average Block Size](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize) * [Get Daily Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount) * [Get Daily Block Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards) * [Get Daily Average Block Time](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime) * [Get Daily Uncle Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount) [​](https://docs.etherscan.io/resources/pro-endpoints#stats) Stats --------------------------------------------------------------------- * [Get Daily Network Transaction Fee](https://docs.etherscan.io/api-reference/endpoint/dailytxnfee) * [Get Daily New Address Count](https://docs.etherscan.io/api-reference/endpoint/dailynewaddress) * [Get Daily Network Utilization](https://docs.etherscan.io/api-reference/endpoint/dailynetutilization) * [Get Daily Average Network Hash Rate](https://docs.etherscan.io/api-reference/endpoint/dailyavghashrate) * [Get Daily Transaction Count](https://docs.etherscan.io/api-reference/endpoint/dailytx) * [Get Daily Average Network Difficulty](https://docs.etherscan.io/api-reference/endpoint/dailyavgnetdifficulty) * [Get Ether Historical Price](https://docs.etherscan.io/api-reference/endpoint/ethdailyprice) [​](https://docs.etherscan.io/resources/pro-endpoints#gas-tracker) Gas Tracker --------------------------------------------------------------------------------- * [Get Daily Average Gas Limit](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit) * [Get Ethereum Daily Total Gas Used](https://docs.etherscan.io/api-reference/endpoint/dailygasused) * [Get Daily Average Gas Price](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice) [​](https://docs.etherscan.io/resources/pro-endpoints#nametags) Nametags --------------------------------------------------------------------------- * [Get Nametag for an Address](https://docs.etherscan.io/api-reference/endpoint/getaddresstag) (Pro Plus tier) [Common Verification Errors](https://docs.etherscan.io/contract-verification/common-verification-errors) [Common Error Messages](https://docs.etherscan.io/resources/common-error-messages) ⌘I ---