# Etherscan

Etherscan API V2 provides multichain access to account balances, transactions, token activity, contracts, logs, gas data, and blocks.

Category: Developer. Connect from any Opisense bot at https://www.opisense.com/integrations/etherscan/.

## Actions

- **Call Contract** (read-only): Execute a read-only eth_call at latest state and return raw ABI-encoded data.
- **Estimate Confirmation Time** (read-only): Estimate confirmation time in seconds for an optional exact gas price in wei.
- **Estimate Transaction Gas** (read-only): Estimate gas required for a transaction-like call without submitting a transaction.
- **Get Address Funding Source** (read-only): Get the first transaction and address that funded an externally owned account.
- **Get Address Metadata** (read-only): Get Etherscan nametags, labels, reputation, notes, and provider-defined metadata for up to 100 addresses.
- **Get Address Transaction Count** (read-only): Get the number of transactions sent from an address at an optional block tag, as hexadecimal.
- **Get API Usage** (read-only): Get API credits used, available, and allowed for the connected API key's current interval.
- **Get Block by Number** (read-only): Get JSON-RPC block information for an explicit hexadecimal block number or the latest block, returning transaction hashes or full…
- **Get Block Countdown** (read-only): Estimate blocks and seconds remaining until a future block is mined.
- **Get Block Number by Timestamp** (read-only): Get the decimal block number closest before or after a Unix timestamp in seconds.
- **Get Block Rewards** (read-only): Get a block's miner reward, uncle inclusion reward, and included uncle records.
- **Get Block Transaction Count** (read-only): Get a block's total JSON-RPC transaction count as hexadecimal, without transfer-type breakdowns.
- **Get Block Transaction Counts** (read-only): Get Ethereum mainnet normal, internal, ERC20, ERC721, and ERC1155 transaction counts for a decimal block number.
- **Get Contract ABI** (read-only): Get the JSON-encoded ABI string for a verified contract.
- **Get Contract Bytecode** (read-only): Get bytecode stored at an address for an optional named or hexadecimal block tag.
- **Get Contract Creation** (read-only): Get creator, creation transaction, block, Unix-second timestamp, factory, and creation bytecode for up to five contracts on one chain.
- **Get Contract Execution Status** (read-only): Get whether a transaction's contract execution failed and any provider error description.
- **Get Contract Source Code** (read-only): Get source code plus compiler, proxy, implementation, license, and verification metadata for one contract.
- **Get Contract Storage** (read-only): Get the raw value at a contract storage position for an optional block tag.
- **Get Current Gas Price** (read-only): Get the canonical JSON-RPC current gas price in wei as hexadecimal.
- **Get ERC20 Balance** (read-only): Get one address's ERC20 token balance in exact smallest units, optionally at a historical block.
- **Get ERC20 Total Supply** (read-only): Get an ERC20 token's current total supply, or its historical supply when block_number is provided.
- **Get Ether Supply** (read-only): Get Ether supply in wei, either the basic block-reward supply or the ETH-specific component breakdown including staking, EIP-1559 burned…
- **Get Gas Oracle** (read-only): Get current safe, proposed, and fast gas-price recommendations and the suggested base fee as gwei strings.
- **Get Latest Block Number** (read-only): Get the latest block number as an exact hexadecimal JSON-RPC quantity.
- **Get Latest Native Price** (read-only): Get the latest native-token prices in BTC and USD with their Unix-second timestamps.
- **Get Native Balance** (read-only): Get one address's native-token balance in exact wei, optionally at a historical block.
- **Get Native Balances** (read-only): Get native-token balances for up to 20 addresses in one call, returning wei as exact decimal strings on one chain.
- **Get Node Count** (read-only): Get the current discoverable-node count or daily historical counts over a UTC date range.
- **Get Token Holder Count** (read-only): Get the number of addresses currently holding an ERC20 token.
- **Get Token Info** (read-only): Get token identity, standard, supply, verification, project links, price, and logo metadata for an ERC20, ERC721, or ERC1155 contract.
- **Get Transaction** (read-only): Get one full JSON-RPC transaction by hash or by hexadecimal block number and transaction index.
- **Get Transaction Receipt** (read-only): Get a full JSON-RPC transaction receipt, including event logs, by hash on one chain.
- **Get Transaction Receipt Status** (read-only): Get a transaction receipt's success or failure status string.
- **Get Uncle Block** (read-only): Get an uncle block by optional hexadecimal parent block number and uncle index.
- **Get Verification Status** (read-only): Check source-code or proxy verification status for a GUID returned by a prior verification submission.
- **List Beacon Withdrawals** (read-only): List one page of beacon-chain withdrawals, optionally filtered by recipient and inclusive block range.
- **List Chain Size** (read-only): List daily Ethereum node-chain size measurements for one client and sync mode over a date range.
- **List Daily Block Counts and Rewards** (read-only): List daily mined-block counts and corresponding block rewards in ether over a UTC date range.
- **List Daily Gas Prices** (read-only): List daily minimum, average, and maximum gas prices in wei over a UTC date range.
- **List Daily Network Metrics** (read-only): List one normalized daily scalar metric over a UTC date range.
- **List Daily Uncle Counts and Rewards** (read-only): List daily uncle-block counts and uncle rewards in ether over a UTC date range.
- **List ERC721 Inventory** (read-only): List one page of ERC721 token IDs owned by an address for one collection.
- **List Event Logs** (read-only): List one provider page of event logs over an inclusive block range, filtered by an emitting address, indexed topics, or both.
- **List Internal Transactions** (read-only): List internal transactions by address, transaction hash, or an unfiltered block range.
- **List L2 Bridge Transactions** (read-only): List one page of canonical L2 deposits from Ethereum or withdrawals to Ethereum for an address on a supported L2.
- **List Normal Transactions** (read-only): List one provider page of an address's normal transactions, optionally filtered by start and end block.
- **List Plasma Deposits** (read-only): List one page of Plasma deposit transactions on documented Polygon, Gnosis, or BitTorrent Chain networks, optionally filtered by recipient…
- **List Supported Chains** (read-only): List current Etherscan mainnet and testnet chains, explorer and API URLs, and service status.
- **List Token Holders** (read-only): List one page of ERC20 holders or up to 1000 top holders for a token.
- **List Token Holdings** (read-only): List one page of ERC20 token balances or ERC721 collection quantities held by an address.
- **List Token Transfers** (read-only): List one provider page of ERC20, ERC721, or ERC1155 transfers, selected by token_standard and filtered by an account, token contract, or…
- **List Validated Blocks** (read-only): List one page of full blocks or pre-Merge uncle blocks validated by an address.
- **Resolve ENS Name** (read-only): Resolve an ENS name or supported onchain subdomain to an address on Ethereum mainnet.
