> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoint Overview

export const Pro = () => <span style={{
  display: "inline-block",
  verticalAlign: "middle",
  fontSize: "0.62em",
  fontWeight: 700,
  lineHeight: 1.35,
  letterSpacing: "0.04em",
  textTransform: "uppercase",
  padding: "0.15em 0.45em",
  borderRadius: "0.35em",
  background: "#0784C3",
  color: "#ffffff",
  marginLeft: "0.35em",
  whiteSpace: "nowrap"
}}>
    PRO
  </span>;

Every Etherscan API endpoint, grouped by module. One key works across all 60+ [supported chains](/supported-chains).

<Card title="Set up your API key" icon="key" href="/set-up-your-api-key" horizontal arrow="true">
  Create a free key and make your first call in minutes.
</Card>

<Tip>
  Endpoints marked <Pro /> are available to the [Standard plan](/rate-limits) and above. All others are available on the free plan.
</Tip>

## Account

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

## Blocks

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

## Contracts

| Endpoint                                                                                   | Description                                                      |
| ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| [Get Contract ABI](/api-reference/endpoint/getabi)                                         | Retrieve the ABI for a verified smart contract.                  |
| [Get Contract Source Code](/api-reference/endpoint/getsourcecode)                          | Retrieve the source code for a verified smart contract.          |
| [Get Contract Creator and Creation Tx Hash](/api-reference/endpoint/getcontractcreation)   | Retrieve a contract's deployer address and creation transaction. |
| [Verify Solidity Source Code](/api-reference/endpoint/verifysourcecode)                    | Submit a Solidity source code for verification.                  |
| [Verify zkSync Source Code](/api-reference/endpoint/verifyzksyncsourcecode)                | Submit zkSync source code for verification.                      |
| [Verify Vyper Source Code](/api-reference/endpoint/verifyvyper)                            | Submit a Vyper contract for verification.                        |
| [Verify Stylus Source Code](/api-reference/endpoint/verifystylus)                          | Submit Stylus source code for verification.                      |
| [Verify Proxy Contract](/api-reference/endpoint/verifyproxycontract)                       | Submit a proxy contract for verification.                        |
| [Check Source Code Verification Status](/api-reference/endpoint/checkverifystatus)         | Check the status of a source code verification request.          |
| [Check Proxy Contract Verification Status](/api-reference/endpoint/checkproxyverification) | Check the status of a proxy contract verification.               |

## Gas Tracker

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

## Geth/Parity Proxy

| Endpoint                                                                                                   | Description                                          |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| [eth\_blockNumber](/api-reference/endpoint/ethblocknumber)                                                 | Fetch the latest block number.                       |
| [eth\_getBlockByNumber](/api-reference/endpoint/ethgetblockbynumber)                                       | Get block information by number.                     |
| [eth\_getUncleByBlockNumberAndIndex](/api-reference/endpoint/ethgetunclebyblocknumberandindex)             | Get uncle block details by block number and index.   |
| [eth\_getBlockTransactionCountByNumber](/api-reference/endpoint/ethgetblocktransactioncountbynumber)       | Get the number of transactions in a block.           |
| [eth\_getTransactionByHash](/api-reference/endpoint/ethgettransactionbyhash)                               | Get transaction details by hash.                     |
| [eth\_getTransactionByBlockNumberAndIndex](/api-reference/endpoint/ethgettransactionbyblocknumberandindex) | Get transaction details by block number and index.   |
| [eth\_getTransactionCount](/api-reference/endpoint/ethgettransactioncount)                                 | Get the number of transactions sent from an address. |
| [eth\_sendRawTransaction](/api-reference/endpoint/ethsendrawtransaction)                                   | Broadcast a signed transaction to the network.       |
| [eth\_getTransactionReceipt](/api-reference/endpoint/ethgettransactionreceipt)                             | Get the receipt of a transaction by hash.            |
| [eth\_call](/api-reference/endpoint/ethcall)                                                               | Execute a call without creating a transaction.       |
| [eth\_getCode](/api-reference/endpoint/ethgetcode)                                                         | Get the code stored at an address.                   |
| [eth\_getStorageAt](/api-reference/endpoint/ethgetstorageat)                                               | Get the value at a storage position.                 |
| [eth\_gasPrice](/api-reference/endpoint/ethgasprice)                                                       | Get the current gas price.                           |
| [eth\_estimateGas](/api-reference/endpoint/ethestimategas)                                                 | Estimate the gas required for a transaction.         |

## Logs

| Endpoint                                                                               | Description                                                                        |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Get Event Logs by Address](/api-reference/endpoint/getlogs)                           | Retrieves event logs from a specific address, with optional block range filtering. |
| [Get Event Logs by Topics](/api-reference/endpoint/getlogs-topics)                     | Retrieves event logs within a specified block range, filtered by topics.           |
| [Get Event Logs by Address and Topics](/api-reference/endpoint/getlogs-address-topics) | Retrieves event logs from a specified address, filtered by topics and block range. |

## Stats

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

## Transactions

| Endpoint                                                                       | Description                                                                          |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| [Check Contract Execution Status](/api-reference/endpoint/getstatus)           | Retrieves the current status and execution result of a specific transaction.         |
| [Check Transaction Receipt Status](/api-reference/endpoint/gettxreceiptstatus) | Retrieves the execution status of a specific transaction using its transaction hash. |

## Tokens

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

## L2 Deposits/Withdrawals

| Endpoint                                                                           | Description                                                                      |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [Get Plasma Deposits by Address](/api-reference/endpoint/txnbridge)                | Retrieves a list of Plasma deposit transactions received by a specified address. |
| [Get Deposit Transactions by Address](/api-reference/endpoint/getdeposittxs)       | Retrieves all deposit transactions made by a specified address.                  |
| [Get Withdrawal Transactions by Address](/api-reference/endpoint/getwithdrawaltxs) | Retrieves all withdrawal transactions made by a specified address.               |

## Nametags

| Endpoint                                                                    | Description                                          |
| --------------------------------------------------------------------------- | ---------------------------------------------------- |
| [Get Metadata for an Address](/api-reference/endpoint/getaddresstag)<Pro /> | Get nametags and metadata for the specified address. |

## Usage

| Endpoint                                             | Description                                                             |
| ---------------------------------------------------- | ----------------------------------------------------------------------- |
| [Get API Usage](/api-reference/endpoint/getapilimit) | Returns your current API credit usage and limit for the interval.       |
| [Chainlist](/api-reference/endpoint/chainlist)       | Returns the list of all supported Etherscan mainnet and testnet chains. |
