Set up your API key
Create a free key and make your first call in minutes.
Endpoints marked are available to the Standard plan and above. All others are available on the free plan.
Account
| Endpoint | Description |
|---|---|
| Get Native Balance for an Address | Retrieves the native token balance held by a specific address. |
| Get Native Balance for Multiple Addresses | Retrieves the native token balance held by multiple addresses in a single call. |
| Get Historical Native Balance for an Address | Retrieves the balance of a specified address at a given block height. |
| Get Normal Transactions By Address | Retrieves the transaction history of a specified address, with optional pagination. |
| Normal Transactions Advanced Filter | Retrieves Normal Transactions with advanced from and to address filtering. |
| Get ERC20 Token Transfers by Address | Retrieves the list of ERC-20 token transfers made by a specified address, with optional filtering by token contract. |
| ERC20 Token Transfers Advanced Filter | Retrieves ERC20 token transfers with advanced from and to address filtering. |
| Get ERC721 Token Transfers by Address | Retrieves the list of ERC-721 token transfers made by a specified address, with optional filtering by token contract. |
| ERC721 Token Transfers Advanced Filter | Retrieves ERC721 token transfers with advanced from and to address filtering. |
| Get ERC1155 Token Transfers by Address | Retrieves a list of ERC-1155 tokens transferred by a specific address, with optional filtering by token contract. |
| ERC1155 Token Transfers Advanced Filter | Retrieves ERC1155 token transfers with advanced from and to address filtering. |
| Get Internal Transactions by Address | Retrieves the internal transaction history of a specified address, with optional pagination. |
| Internal Transactions Advanced Filter | Retrieves Internal Transactions with advanced from and to address filtering. |
| Get Internal Transactions by Block Range | Returns internal transactions within a specified block range, with optional pagination. |
| Get Internal Transactions by Transaction Hash | Retrieves the list of internal transactions executed within a specific transaction. |
| Get Blocks Validated by Address | Retrieves the list of blocks validated by a specified address. |
| Get Beacon Chain Withdrawals by Address | Retrieves beacon chain withdrawal transactions made to a specified address. |
| Get Address Funded By | 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 | Retrieves block rewards along with associated Uncle block rewards. |
| Get Block Transaction Counts by Block Number | Retrieves transaction counts for a specified Ethereum block. |
| Get Estimated Block Countdown by Block Number | Retrieves the estimated time, in seconds, until a specified block is mined. |
| Get Block Number by Timestamp | Retrieves the block number mined at a specific timestamp. |
| Get Daily Average Block Size | Retrieves the average daily block size over a specified date range. |
| Get Daily Block Count and Rewards | Retrieves the daily count of mined blocks along with the corresponding block rewards. |
| Get Daily Block Rewards | Retrieves the daily distribution of block rewards to miners. |
| Get Daily Average Block Time | Retrieves the daily average time taken to successfully mine a block. |
| Get Daily Uncle Block Count and Rewards | Returns the daily count of Uncle blocks mined and their associated rewards. |
Contracts
| Endpoint | Description |
|---|---|
| Get Contract ABI | Retrieve the ABI for a verified smart contract. |
| Get Contract Source Code | Retrieve the source code for a verified smart contract. |
| Get Contract Creator and Creation Tx Hash | Retrieve a contract’s deployer address and creation transaction. |
| Verify Solidity Source Code | Submit a Solidity source code for verification. |
| Verify zkSync Source Code | Submit zkSync source code for verification. |
| Verify Vyper Source Code | Submit a Vyper contract for verification. |
| Verify Stylus Source Code | Submit Stylus source code for verification. |
| Verify Proxy Contract | Submit a proxy contract for verification. |
| Check Source Code Verification Status | Check the status of a source code verification request. |
| Check Proxy Contract Verification Status | Check the status of a proxy contract verification. |
Gas Tracker
| Endpoint | Description |
|---|---|
| Get Estimation of Confirmation Time | Estimate confirmation time based on a provided gas price. |
| Get Gas Oracle | Get current gas price recommendations. |
| Get Daily Average Gas Limit | Retrieve daily average gas limit statistics. |
| Get Ethereum Daily Total Gas Used | Retrieves the total daily gas usage for transactions within the network |
| Get Daily Average Gas Price | Retrieve daily average gas price statistics. |
Geth/Parity Proxy
| Endpoint | Description |
|---|---|
| eth_blockNumber | Fetch the latest block number. |
| eth_getBlockByNumber | Get block information by number. |
| eth_getUncleByBlockNumberAndIndex | Get uncle block details by block number and index. |
| eth_getBlockTransactionCountByNumber | Get the number of transactions in a block. |
| eth_getTransactionByHash | Get transaction details by hash. |
| eth_getTransactionByBlockNumberAndIndex | Get transaction details by block number and index. |
| eth_getTransactionCount | Get the number of transactions sent from an address. |
| eth_sendRawTransaction | Broadcast a signed transaction to the network. |
| eth_getTransactionReceipt | Get the receipt of a transaction by hash. |
| eth_call | Execute a call without creating a transaction. |
| eth_getCode | Get the code stored at an address. |
| eth_getStorageAt | Get the value at a storage position. |
| eth_gasPrice | Get the current gas price. |
| eth_estimateGas | Estimate the gas required for a transaction. |
Logs
| Endpoint | Description |
|---|---|
| Get Event Logs by Address | Retrieves event logs from a specific address, with optional block range filtering. |
| Get Event Logs by Topics | Retrieves event logs within a specified block range, filtered by topics. |
| Get Event Logs by Address and Topics | Retrieves event logs from a specified address, filtered by topics and block range. |
Stats
| Endpoint | Description |
|---|---|
| Get Total Supply of Ether | Retrieves the current circulating supply of Ether, excluding ETH2 staking rewards and EIP-1559 burned fees. |
| Get Total Supply of Ether 2 | 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 | Retrieves the latest price of the native/gas token. |
| Get Ethereum Nodes Size | Retrieves the total size of the Ethereum blockchain, in bytes, within a specified date range. |
| Get Total Nodes Count | Retrieves the total count of discoverable Ethereum nodes. |
| Get Daily Network Transaction Fee | Retrieves the total transaction fees paid to miners each day. |
| Get Historical Total Nodes Count | Retrieves the historical daily count of discoverable Ethereum nodes. |
| Get Daily New Address Count | Retrieves the daily count of newly created addresses. |
| Get Daily Network Utilization | Retrieves the daily average percentage of gas used relative to the gas limit. |
| Get Daily ENS Registration Count | Retrieves the daily count of ENS registrations on Ethereum. |
| Get Daily Average Network Hash Rate | Retrieves the historical hash rate, reflecting the processing power of the network over time. |
| Get Daily Transaction Count | Retrieves the daily number of transactions executed in the blockchain. |
| Get Daily Average Network Difficulty | Returns the historical mining difficulty data of the network. |
| Get Ether Historical Price | Returns the historical price data for 1 ETH. |
Transactions
| Endpoint | Description |
|---|---|
| Check Contract Execution Status | Retrieves the current status and execution result of a specific transaction. |
| Check Transaction Receipt Status | Retrieves the execution status of a specific transaction using its transaction hash. |
Tokens
| Endpoint | Description |
|---|---|
| Get ERC20-Token TotalSupply by ContractAddress | Returns the amount of an ERC-20 token in circulation. |
| Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo | Returns the amount of an ERC-20 token in circulation at a certain block height. |
| Get ERC20-Token Account Balance for TokenContractAddress | Retrieves the current ERC-20 token balance for a specified address. |
| Get Historical ERC20-Token Account Balance by BlockNo | Retrieves the ERC-20 token balance for a specified address at a given block height. |
| Get Top Token Holders | Returns the list of top holders for a specified ERC-20 token. |
| Get Token Holder List by Contract Address | Retrieves the current list of ERC-20 token holders and their token balances. |
| Get Token Holder Count by Contract Address | Retrieves a simple count of ERC-20 token holders. |
| Get Token Info by ContractAddress | Retrieves project details and social media links for an ERC-20/ERC-721/ERC-1155 token. |
| Get Address ERC20 Token Holding | Retrieves the current ERC-20 token balance for a specified address. |
| Get Address ERC721 Token Holding | Retrieves the ERC-721 tokens and their quantities owned by a specific address. |
| Get Address ERC721 Token Inventory by Contract | 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 | Retrieves a list of Plasma deposit transactions received by a specified address. |
| Get Deposit Transactions by Address | Retrieves all deposit transactions made by a specified address. |
| Get Withdrawal Transactions by Address | Retrieves all withdrawal transactions made by a specified address. |
Nametags
| Endpoint | Description |
|---|---|
| Get Metadata for an Address | Get nametags and metadata for the specified address. |
Usage
| Endpoint | Description |
|---|---|
| Get API Usage | Returns your current API credit usage and limit for the interval. |
| Chainlist | Returns the list of all supported Etherscan mainnet and testnet chains. |