Add Etherscan to your AI agent

Get Ethereum mainnet normal, internal, ERC20, ERC721, and ERC1155 transaction counts for a decimal block number.

Get the JSON-encoded ABI string for a verified contract. Etherscan documents this operation as available on every supported chain and every API plan, including Free.

Get bytecode stored at an address for an optional named or hexadecimal block tag.

Get creator, creation transaction, block, Unix-second timestamp, factory, and creation bytecode for up to five contracts on one chain. This operation's chain and plan availability is dynamic and currently unknown.

Get whether a transaction's contract execution failed and any provider error description. A failed contract execution is returned as successful read data, not as a tool error. This community operation's chain and plan availability is dynamic and currently unknown; pending and missing-transaction behavior is unprobed.

Get source code plus compiler, proxy, implementation, license, and verification metadata for one contract. Etherscan documents this operation as available on every supported chain and every API plan, including Free. Unverified contracts may legitimately return empty source code and ABI error text.

Get the raw value at a contract storage position for an optional block tag.

Get the canonical JSON-RPC current gas price in wei as hexadecimal; use Get Gas Oracle for recommendations.

Get one address's ERC20 token balance in exact smallest units, optionally at a historical block. Historical lookup requires Standard+, is mainnet-only and unavailable on testnets; current balance availability is dynamic.

Get an ERC20 token's current total supply, or its historical supply when block_number is provided; historical lookup requires Standard+, is mainnet-only, and is unavailable on testnets.

Get Ether supply in wei, either the basic block-reward supply or the ETH-specific component breakdown including staking, EIP-1559 burned fees, and staking withdrawals.

Get current safe, proposed, and fast gas-price recommendations and the suggested base fee as gwei strings. The documentation displays Ethereum, BNB Smart Chain, Polygon, Celo, Gnosis, and Linea mainnets; plan availability and availability on other chains are unknown.

Get the latest block number as an exact hexadecimal JSON-RPC quantity.

Get the latest native-token prices in BTC and USD with their Unix-second timestamps.

Get one address's native-token balance in exact wei, optionally at a historical block. Historical lookup requires Standard+, is mainnet-only and unavailable on testnets, and is limited to 2 calls/second; current/recent availability is dynamic.

Get native-token balances for up to 20 addresses in one call, returning wei as exact decimal strings on one chain. This community operation's chain and plan availability is dynamic and currently unknown.

Get the current discoverable-node count or daily historical counts over a UTC date range. Historical mode requires Standard+ and Ethereum mainnet chain_id 1.

Get the number of addresses currently holding an ERC20 token. This PRO Standard+ operation is available on supported mainnets only.

Get token identity, standard, supply, verification, project links, price, and logo metadata for an ERC20, ERC721, or ERC1155 contract. This PRO Standard+ operation is mainnet-only and limited to two calls per second.

Get one full JSON-RPC transaction by hash or by hexadecimal block number and transaction index.

Get a full JSON-RPC transaction receipt, including event logs, by hash on one chain. Proxy-read chain and plan availability is dynamic and currently unknown. Hexadecimal quantities are preserved as strings; an explicit null result is returned without assigning unverified pending or not-found meaning.

Get a transaction receipt's success or failure status string. The status may be empty for a pre-Byzantium block. This community operation's chain and plan availability is dynamic and currently unknown; pending and missing-transaction behavior is unprobed.

Get an uncle block by optional hexadecimal parent block number and uncle index.

Check source-code or proxy verification status for a GUID returned by a prior verification submission. This read-only action does not submit verification; pending and failed verification text is returned as data.

List one page of beacon-chain withdrawals, optionally filtered by recipient and inclusive block range.

List daily Ethereum node-chain size measurements for one client and sync mode over a date range.

List daily mined-block counts and corresponding block rewards in ether over a UTC date range.

List daily minimum, average, and maximum gas prices in wei over a UTC date range.

List one normalized daily scalar metric over a UTC date range. The response echoes the metric and unit; Ether historical price is explicitly ETH-specific. All variants require Standard+, are mainnet-only, and are unavailable on testnets; ens_registration_count additionally requires chain_id 1.

List daily uncle-block counts and uncle rewards in ether over a UTC date range.

List one page of ERC721 token IDs owned by an address for one collection. Requires Standard+, is mainnet-only and unavailable on testnets, and is limited to 2 calls/second.

List one provider page of event logs over an inclusive block range, filtered by an emitting address, indexed topics, or both. Chain and plan availability is dynamic; hexadecimal quantities are preserved exactly.

List internal transactions by address, transaction hash, or an unfiltered block range. Address and hash availability depends on the current chain and API plan. Block-range-only mode explicitly requires an Etherscan Standard or higher plan, is available on mainnets only, and is unavailable on testnets. Address and block-range modes return one provider page. Hash mode is not paginated and returns only matching non-zero-value internal transactions. After a query timeout, narrow the block range or reduce offset.

List one page of canonical L2 deposits from Ethereum or withdrawals to Ethereum for an address on a supported L2.

List one provider page of an address's normal transactions, optionally filtered by start and end block. Chain and plan availability is dynamic.

List one page of Plasma deposit transactions on documented Polygon, Gnosis, or BitTorrent Chain networks, optionally filtered by recipient address.

List current Etherscan mainnet and testnet chains, explorer and API URLs, and service status. This discovery operation has no chain selection and is the time-sensitive authority for supported chain IDs.

List one page of ERC20 holders or up to 1000 top holders for a token. Top ranking includes contract-versus-EOA address type. Both operations require PRO Standard+, are mainnet-only, and top ranking is limited to two calls per second.

List one page of ERC20 token balances or ERC721 collection quantities held by an address. Requires Standard+ and mainnet access, is unavailable on testnets, and both variants are limited to 2 calls/second.

List one provider page of ERC20, ERC721, or ERC1155 transfers, selected by token_standard and filtered by an account, token contract, or both on one chain. Standard-specific amounts, token IDs, token counts, and blockchain quantities remain exact strings. Chain and plan availability is dynamic; after a query timeout, narrow the block range or reduce offset.

List one page of full blocks or pre-Merge uncle blocks validated by an address.

Resolve an ENS name or supported onchain subdomain to an address on Ethereum mainnet. Offchain and wildcard resolution are unsupported; Free-tier calls are limited to one per second and results may be cached for five minutes.