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. Community endpoint access depends on the chain’s plan availability. Gnosis community endpoints require a Lite plan or above. Source code and ABI endpoints are available on all chains for every API plan, including the Free tier.
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 ERC-20 token transfers, filtered by address and/or 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 ERC-721 token transfers, filtered by address and/or 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 ERC-1155 token transfers, filtered by address and/or 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 withdrawals, optionally filtered by 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. |
Contract Verification
| Endpoint | Description |
|---|---|
| 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 Historical Total Nodes Count | Retrieves the historical daily count of discoverable Ethereum nodes. |
| Get Daily Network Transaction Fee | Retrieves the total transaction fees paid to miners each day. |
| Get Daily New Address Count | Retrieves the daily count of newly created addresses. |
| Get Daily ENS Registration Count | Retrieves the daily count of ENS registrations on Ethereum. |
| Get Daily Network Utilization | Retrieves the daily average percentage of gas used relative to the gas limit. |
| 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 list of ERC-20 tokens and balances held by 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 ERC-721 token IDs owned by an address for a given NFT contract. |
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. |
Beta Endpoints
| Endpoint | Description |
|---|---|
| Get Prediction Market Trades by Address | Retrieves prediction market trades from Polymarket by an address. |