The Etherscan connector lets your AI agent act in each user's Etherscan account. Each user connects their own Etherscan API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 60 · 0 · 060 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Etherscan connection
In AgentKit > Connections, create an Etherscan connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'etherscan'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Etherscan:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'etherscan_api_usage_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "etherscan"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Etherscan:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="etherscan_api_usage_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Etherscan credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooletherscan_address_funded_by_getGet the address and transaction that first funded an externally owned address, to trace where its funds came from.Read-onlyGet Address Funded By
Get the address and transaction that first funded an externally owned address, to trace where its funds came from. Not available for contract addresses. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_address_nft_holdings_listList the ERC-721 collections and token counts held by an address.Read-onlyGet Address ERC721 Token Holding
List the ERC-721 collections and token counts held by an address. PRO plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
etherscan_address_nft_inventory_listList the ERC-721 token IDs an address holds in one collection.Read-onlyGet Address ERC721 Token Inventory by Contract
List the ERC-721 token IDs an address holds in one collection. PRO plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
etherscan_address_tag_getGet the name tag, labels, reputation and other metadata of an address.Read-onlyGet Metadata for an Address
Get the name tag, labels, reputation and other metadata of an address. Metadata plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_address_token_holdings_listList the ERC-20 tokens and balances held by an address.Read-onlyGet Address ERC20 Token Holding
List the ERC-20 tokens and balances held by an address. PRO plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
etherscan_api_usage_getGet your API credit usage and limit for the current interval.Read-onlyGet API Usage
Get your API credit usage and limit for the current interval. Returns status, message and result.
Inputs
This tool takes no inputs.
etherscan_balance_getGet the native token balance (e.g.Read-onlyGet Native Balance for an Address
Get the native token balance (e.g. ETH, in wei) of an address. Use etherscan_balances_multi_get for several addresses and etherscan_token_balance_get for an ERC-20 token. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_balance_history_getGet the native token balance of an address at a past block number.Read-onlyGet Historical Native Balance for an Address
Get the native token balance of an address at a past block number. PRO plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
blocknointegerrequired- Block number. Example: 19000000.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_balances_multi_getGet the native token balances (in wei) of up to 20 addresses in one call.Read-onlyGet Native Balance for Multiple Addresses
Get the native token balances (in wei) of up to 20 addresses in one call. Returns status, message and result.
Inputs
addressstringrequired- Comma-separated addresses, up to 20. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_beacon_withdrawals_listList beacon chain withdrawals to an address.Read-onlyGet Beacon Chain Withdrawals by Address
List beacon chain withdrawals to an address. Returns status, message and result.
Inputs
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
etherscan_block_number_by_time_getGet the block number mined at or closest to a Unix timestamp.Read-onlyGet Block Number by Timestamp
Get the block number mined at or closest to a Unix timestamp. Use this to turn a date into a block range. Returns status, message and result.
Inputs
closeststringrequired- Closest available block to the provided timestamp, either before or after. Example: before.one of
beforeafter timestampintegerrequired- Unix timestamp in seconds. Example: 1735689600.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_block_reward_getGet the block reward and uncle rewards of a block, with its miner and timestamp.Read-onlyGet Block and Uncle Rewards by Block Number
Get the block reward and uncle rewards of a block, with its miner and timestamp. Returns status, message and result.
Inputs
blocknointegerrequired- Block number. Example: 19000000.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_block_transaction_count_getGet the number of transactions, internal transactions and ERC-20, ERC-721 and ERC-1155 transfers in a block.Read-onlyGet Block Transaction Counts by Block Number
Get the number of transactions, internal transactions and ERC-20, ERC-721 and ERC-1155 transfers in a block. Returns status, message and result.
Inputs
blocknointegerrequired- Block number. Example: 19000000.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_chains_listList every chain the Etherscan API supports, with its chain ID, name, explorer URL and status.Read-onlyChainlist
List every chain the Etherscan API supports, with its chain ID, name, explorer URL and status. Returns status, message and result.
Inputs
This tool takes no inputs.
etherscan_contract_abi_getGet the ABI of a verified smart contract, as a JSON string.Read-onlyGet Contract ABI
Get the ABI of a verified smart contract, as a JSON string. Use etherscan_contract_source_get for the source code. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_contract_creation_getGet the deployer address and creation transaction hash of up to 5 contracts.Read-onlyGet Contract Creator and Creation Tx Hash
Get the deployer address and creation transaction hash of up to 5 contracts. Returns status, message and result.
Inputs
contractaddressesstringrequired- Comma-separated contract addresses, up to 5. Example: 0xB83c27805aAcA5C7082eB45C868d955Cf04C337F,0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_contract_source_getGet the verified source code of a contract with its ABI, compiler version and settings, constructor arguments and proxy implementation.Read-onlyGet Contract Source Code
Get the verified source code of a contract with its ABI, compiler version and settings, constructor arguments and proxy implementation. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_daily_avg_gas_price_listGet the daily maximum, minimum and average gas price over a date range.Read-onlyGet Daily Average Gas Price
Get the daily maximum, minimum and average gas price over a date range. PRO plan endpoint. Returns status, message and result.
Inputs
enddatestringrequired- End date, YYYY-MM-DD. Example: 2026-01-31.
startdatestringrequired- Start date, YYYY-MM-DD. Example: 2026-01-01.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_daily_transaction_fees_listGet the total transaction fees paid each day over a date range.Read-onlyGet Daily Network Transaction Fee
Get the total transaction fees paid each day over a date range. PRO plan endpoint. Returns status, message and result.
Inputs
enddatestringrequired- End date, YYYY-MM-DD. Example: 2026-01-31.
startdatestringrequired- Start date, YYYY-MM-DD. Example: 2026-01-01.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_daily_transactions_listGet the daily number of transactions on the chain over a date range.Read-onlyGet Daily Transaction Count
Get the daily number of transactions on the chain over a date range. PRO plan endpoint. Returns status, message and result.
Inputs
enddatestringrequired- End date, YYYY-MM-DD. Example: 2026-01-31.
startdatestringrequired- Start date, YYYY-MM-DD. Example: 2026-01-01.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_ens_resolveResolve an ENS name or subdomain, such as vitalik.eth, to its address.Read-onlyResolve an ENS Name to an Address
Resolve an ENS name or subdomain, such as vitalik.eth, to its address. Returns status, message and result.
Inputs
namestringrequired- The ENS name to resolve, such as etherscan.eth or gm.etherscan.eth. Example: vitalik.eth.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_erc1155_transfers_listList ERC-1155 token transfers of an address, of a token contract, or both.Read-onlyGet ERC1155 Token Transfers by Address
List ERC-1155 token transfers of an address, of a token contract, or both. Returns status, message and result.
Inputs
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 contractaddressstring- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
etherscan_eth_block_getGet a block by number (eth_getBlockByNumber), with full transactions when boolean is true or only hashes when false.Read-onlyeth_getBlockByNumber
Get a block by number (eth_getBlockByNumber), with full transactions when boolean is true or only hashes when false. Returns status, message and result.
Inputs
booleanbooleanrequired- Set to true to return full transaction objects or false for transaction hashes only. Example: true.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_block_number_getGet the number of the most recent block, in hex (eth_blockNumber).Read-onlyeth_blockNumber
Get the number of the most recent block, in hex (eth_blockNumber). Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_eth_block_transaction_count_getGet the number of transactions in a block (eth_getBlockTransactionCountByNumber), in hex.Read-onlyeth_getBlockTransactionCountByNumber
Get the number of transactions in a block (eth_getBlockTransactionCountByNumber), in hex. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_callExecute a read-only contract call without creating a transaction (eth_call), e.g.Read-onlyeth_call
Execute a read-only contract call without creating a transaction (eth_call), e.g. to read a token balance via balanceOf. Returns the raw hex result. Returns status, message and result.
Inputs
tostringrequired- The address to interact with, as a 0x-prefixed hex address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 datastring- The 4-byte function selector followed by the ABI-encoded arguments, as 0x-prefixed hex. For example, 0x70a08231 followed by a padded address calls balanceOf. Example: 0x70a08231000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
fromstring- The address the call is sent from, as a 0x-prefixed hex address. Defaults to the zero address, so set it when the result depends on the caller. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
gasstring- Gas limit, as 0x-prefixed hex, such as 0x5208 for 21000. Decimal values are read as hex: 21000 becomes 0x21000 (135168). Example: 0x5208.
gas_pricestring- Gas price in wei, as 0x-prefixed hex, such as 0x64 for 100 wei. Decimal values are read as hex: 100 becomes 0x100 (256 wei). Example: 0x77359400.
tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
valuestring- Native currency to send, in wei, as 0x-prefixed hex, such as 0x64 for 100 wei. Decimal values are read as hex: 100 becomes 0x100 (256 wei). Example: 0x0.
etherscan_eth_code_getGet the bytecode stored at an address (eth_getCode); 0x means it is not a contract.Read-onlyeth_getCode
Get the bytecode stored at an address (eth_getCode); 0x means it is not a contract. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_daily_price_listGet the daily USD price of the native token over a date range.Read-onlyGet Ether Historical Price
Get the daily USD price of the native token over a date range. PRO plan endpoint. Returns status, message and result.
Inputs
enddatestringrequired- End date, YYYY-MM-DD. Example: 2026-01-31.
startdatestringrequired- Start date, YYYY-MM-DD. Example: 2026-01-01.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_eth_gas_estimateEstimate the gas a transaction would use (eth_estimateGas), without sending it.Read-onlyeth_estimateGas
Estimate the gas a transaction would use (eth_estimateGas), without sending it. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 datastring- Hash of the method signature and encoded parameters. Example: 0x70a08231000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
gasstring- Gas limit provided for the transaction, in hex. Example: 0x5208.
gas_pricestring- Gas price in wei. Example: 0x77359400.
tostring- The address to interact with. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
valuestring- Value sent in this transaction, in hex. Example: 0x0.
etherscan_eth_gas_price_getGet the current gas price in wei, in hex (eth_gasPrice).Read-onlyeth_gasPrice
Get the current gas price in wei, in hex (eth_gasPrice). Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_eth_price_getGet the latest price of the native token in USD and BTC, with timestamps.Read-onlyGet Ether Last Price
Get the latest price of the native token in USD and BTC, with timestamps. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_eth_storage_getGet the value of a storage slot of a contract (eth_getStorageAt).Read-onlyeth_getStorageAt
Get the value of a storage slot of a contract (eth_getStorageAt). Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
positionstringrequired- Storage position in hex. Example: 0x0.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_supply_getGet the native token supply, including staking rewards, EIP-1559 burned fees and beacon chain withdrawals.Read-onlyGet Total Supply of Ether 2
Get the native token supply, including staking rewards, EIP-1559 burned fees and beacon chain withdrawals. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_eth_transaction_by_block_index_getGet the transaction at an index in a block (eth_getTransactionByBlockNumberAndIndex).Read-onlyeth_getTransactionByBlockNumberAndIndex
Get the transaction at an index in a block (eth_getTransactionByBlockNumberAndIndex). Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 indexstring- Transaction index position in the block, in hex. Example: 0x0.
tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_transaction_count_getGet the number of transactions sent from an address (its nonce) at a block (eth_getTransactionCount).Read-onlyeth_getTransactionCount
Get the number of transactions sent from an address (its nonce) at a block (eth_getTransactionCount). Returns status, message and result.
Inputs
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_eth_transaction_getGet a transaction by hash (eth_getTransactionByHash): from, to, value, gas, input and block.Read-onlyeth_getTransactionByHash
Get a transaction by hash (eth_getTransactionByHash): from, to, value, gas, input and block. Returns status, message and result.
Inputs
txhashstringrequired- Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_eth_transaction_receipt_getGet the receipt of a transaction (eth_getTransactionReceipt): status, gas used, logs and contract address.Read-onlyeth_getTransactionReceipt
Get the receipt of a transaction (eth_getTransactionReceipt): status, gas used, logs and contract address. Returns status, message and result.
Inputs
txhashstringrequired- Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_gas_confirmation_time_getEstimate how many seconds a transaction takes to confirm at a gas price in wei.Read-onlyGet Estimation of Confirmation Time
Estimate how many seconds a transaction takes to confirm at a gas price in wei. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 gaspricestring- Gas price paid per unit of gas, in wei. Example: 2000000000.
etherscan_gas_oracle_getGet current gas price recommendations (safe, propose and fast) in gwei, the base fee and recent block gas usage.Read-onlyGet Gas Oracle
Get current gas price recommendations (safe, propose and fast) in gwei, the base fee and recent block gas usage. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_internal_transactions_by_block_range_listList all internal transactions within a block range.Read-onlyGet Internal Transactions by Block Range
List all internal transactions within a block range. Returns status, message and result.
Inputs
endblockintegerrequired- Last block to include. Example: 99999999.
startblockintegerrequired- First block to include. Example: 0.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_internal_transactions_by_hash_listList the internal transactions executed inside one transaction.Read-onlyGet Internal Transactions by Transaction Hash
List the internal transactions executed inside one transaction. Returns status, message and result.
Inputs
txhashstringrequired- Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_internal_transactions_listList the internal transactions (value moved by contract calls) involving an address.Read-onlyGet Internal Transactions by Address
List the internal transactions (value moved by contract calls) involving an address. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
etherscan_l2_deposits_listList the L1-to-L2 deposit transactions of an address on L2 chains such as Arbitrum and Optimism.Read-onlyGet Deposit Transactions by Address
List the L1-to-L2 deposit transactions of an address on L2 chains such as Arbitrum and Optimism. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_l2_withdrawals_listList the L2-to-L1 withdrawal transactions of an address on L2 chains such as Arbitrum and Optimism.Read-onlyGet Withdrawal Transactions by Address
List the L2-to-L1 withdrawal transactions of an address on L2 chains such as Arbitrum and Optimism. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc
etherscan_logs_getGet event logs in a block range, filtered by contract address and/or up to four topics combined with and/or operators.Read-onlyGet Event Logs
Get event logs in a block range, filtered by contract address and/or up to four topics combined with and/or operators. Returns up to 1,000 logs per page. Returns status, message and result.
Inputs
from_blockintegerrequired- First block of the range. Example: 19000000.
to_blockintegerrequired- Last block of the range. Example: 19000100.
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
topic0string- The first topic to filter by. **At least one of topic0-topic3 is required.**. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef.
topic0_1_oprstring- Topic operator between topic0 and topic1, either and or or. Only apply when both topics are set. Example: and.one of
andor topic0_2_oprstring- Topic operator between topic0 and topic2, either and or or. Only apply when both topics are set. Example: and.one of
andor topic0_3_oprstring- Topic operator between topic0 and topic3, either and or or. Only apply when both topics are set. Example: and.one of
andor topic1string- Second topic to filter by. Example: 0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
topic1_2_oprstring- Topic operator between topic1 and topic2, either and or or. Only apply when both topics are set. Example: and.one of
andor topic1_3_oprstring- Topic operator between topic1 and topic3, either and or or. Only apply when both topics are set. Example: and.one of
andor topic2string- Third topic to filter by. Example: 0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
topic2_3_oprstring- Topic operator between topic2 and topic3, either and or or. Only apply when both topics are set. Example: and.one of
andor topic3string- Fourth topic to filter by. Example: 0x0000000000000000000000000000000000000000000000000000000000000001.
etherscan_mined_blocks_listList the blocks validated (mined) by an address.Read-onlyGet Blocks Validated by Address
List the blocks validated (mined) by an address. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
blocktypestring- Use blocks for full blocks, optionally uncles for pre-Merge blocks. Example: blocks.one of
blocksuncles chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
etherscan_nft_transfers_listList ERC-721 (NFT) transfers of an address, of a collection contract, or both.Read-onlyGet ERC721 Token Transfers by Address
List ERC-721 (NFT) transfers of an address, of a collection contract, or both. Returns status, message and result.
Inputs
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 contractaddressstring- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
etherscan_node_count_getGet the total number of discoverable Ethereum nodes.Read-onlyGet Total Nodes Count
Get the total number of discoverable Ethereum nodes. Returns status, message and result.
Inputs
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_balance_getGet the ERC-20 token balance of an address for one token contract, in the token's smallest unit.Read-onlyGet ERC20-Token Account Balance for TokenContractAddress
Get the ERC-20 token balance of an address for one token contract, in the token's smallest unit. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 tagstring- Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
etherscan_token_balance_history_getGet the ERC-20 token balance of an address at a past block number.Read-onlyGet Historical ERC20-Token Account Balance by BlockNo
Get the ERC-20 token balance of an address at a past block number. PRO plan endpoint. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
blocknointegerrequired- Block number. Example: 19000000.
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_holder_count_getGet the number of holders of an ERC-20 token.Read-onlyGet Token Holder Count by Contract Address
Get the number of holders of an ERC-20 token. Returns status, message and result.
Inputs
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_holders_listList the holders of an ERC-20 token and their balances.Read-onlyGet Token Holder List by Contract Address
List the holders of an ERC-20 token and their balances. PRO plan endpoint. Returns status, message and result.
Inputs
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
etherscan_token_info_getGet project details of a token: name, symbol, type, total supply, decimals, website, social links and description.Read-onlyGet Token Info by ContractAddress
Get project details of a token: name, symbol, type, total supply, decimals, website, social links and description. PRO plan endpoint. Returns status, message and result.
Inputs
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_supply_getGet the total supply of an ERC-20 token, in its smallest unit.Read-onlyGet ERC20-Token TotalSupply by ContractAddress
Get the total supply of an ERC-20 token, in its smallest unit. Returns status, message and result.
Inputs
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_supply_history_getGet the total supply of an ERC-20 token at a past block.Read-onlyGet Historical ERC20-Token TotalSupply by ContractAddress & BlockNo
Get the total supply of an ERC-20 token at a past block. PRO plan endpoint. Returns status, message and result.
Inputs
blocknointegerrequired- Block number. Example: 19000000.
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_token_top_holders_listList the top holders of an ERC-20 token with their balances.Read-onlyGet Top Token Holders
List the top holders of an ERC-20 token with their balances. PRO plan endpoint. Returns status, message and result.
Inputs
contractaddressstringrequired- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
etherscan_token_transfers_listList ERC-20 token transfers of an address, of a token contract, or of an address for one token.Read-onlyGet ERC20 Token Transfers by Address
List ERC-20 token transfers of an address, of a token contract, or of an address for one token. Returns status, message and result.
Inputs
addressstring- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 contractaddressstring- Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
etherscan_transaction_execution_status_getCheck whether a contract call transaction failed, with its error description.Read-onlyCheck Contract Execution Status
Check whether a contract call transaction failed, with its error description. Use etherscan_transaction_receipt_status_get for the receipt status. Returns status, message and result.
Inputs
txhashstringrequired- Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_transaction_receipt_status_getGet the receipt status of a transaction: 1 for success, 0 for failure (post-Byzantium transactions).Read-onlyCheck Transaction Receipt Status
Get the receipt status of a transaction: 1 for success, 0 for failure (post-Byzantium transactions). Returns status, message and result.
Inputs
txhashstringrequired- Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1
etherscan_transactions_listList the normal (external) transactions of an address, optionally in a block range, newest or oldest first.Read-onlyGet Normal Transactions By Address
List the normal (external) transactions of an address, optionally in a block range, newest or oldest first. Use etherscan_internal_transactions_list for internal transactions and etherscan_token_transfers_list for ERC-20 transfers. Returns status, message and result.
Inputs
addressstringrequired- Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
chainidstring- Chain ID to query: 1 Ethereum (default), 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 137 Polygon, 56 BNB Smart Chain, 43114 Avalanche C-Chain, 11155111 Sepolia, and the other chains in etherscan_chains_list. Example: 1.default
1 endblockinteger- Last block to include. Example: 99999999.
offsetinteger- Records per page (the API caps page times offset at 10,000). Example: 100.
pageinteger- Page number, starting at 1. Example: 1.
sortstring- Sort order: asc (oldest first) or desc (newest first). Example: desc.one of
ascdesc startblockinteger- First block to include. Example: 0.
No tools match.