---
canonical_url: "https://docs.composio.dev/toolkits/etherscan"
markdown_url: "https://docs.composio.dev/toolkits/etherscan.md"
product: "platform"
version: null
last_updated: null
---

# Etherscan

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

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 54
- **Triggers:** 0
- **Slug:** `ETHERSCAN`
- **Version:** 20261111_00
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Call Contract

**Slug:** `ETHERSCAN_CALL_CONTRACT`

Execute a read-only eth_call at latest state and return raw ABI-encoded data; no transaction is created.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | Contract address to call. |
| `data` | string | No | Optional 0x-prefixed selector and ABI-encoded arguments. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `from_address` | string | No | Optional caller address; the provider defaults to the zero address. |
| `gas_limit_hex` | string | No | Optional gas limit as 0x-prefixed hexadecimal. |
| `value_wei_hex` | string | No | Optional simulated native value in wei as hexadecimal. |
| `gas_price_wei_hex` | string | No | Optional gas price in wei as hexadecimal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Estimate Confirmation Time

**Slug:** `ETHERSCAN_ESTIMATE_CONFIRMATION_TIME`

Estimate confirmation time in seconds for an optional exact gas price in wei.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `gas_price_wei` | string | No | Optional gas price in wei as an exact decimal string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Estimate Transaction Gas

**Slug:** `ETHERSCAN_ESTIMATE_TRANSACTION_GAS`

Estimate gas required for a transaction-like call without submitting a transaction.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | Optional destination address. |
| `data` | string | No | Optional method selector and encoded arguments as hexadecimal. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `gas_limit_hex` | string | No | Optional proposed gas limit as hexadecimal. |
| `gas_price_wei` | string | No | Optional gas price in wei as documented hexadecimal. |
| `value_wei_hex` | string | No | Optional native value in wei as hexadecimal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Address Funding Source

**Slug:** `ETHERSCAN_GET_ADDRESS_FUNDING_SOURCE`

Get the first transaction and address that funded an externally owned account. Contract addresses are unsupported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Externally owned account whose first funding source to return; contracts are unsupported. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Address Metadata

**Slug:** `ETHERSCAN_GET_ADDRESS_METADATA`

Get Etherscan nametags, labels, reputation, notes, and provider-defined metadata for up to 100 addresses. This PRO+ operation is available only on Pro Plus, is mainnet-only, and is limited to two calls per second.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal mainnet chain ID. |
| `addresses` | array | Yes | One to 100 addresses whose Etherscan metadata to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Address Transaction Count

**Slug:** `ETHERSCAN_GET_ADDRESS_TRANSACTION_COUNT`

Get the number of transactions sent from an address at an optional block tag, as hexadecimal.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Address whose sent-transaction count to return. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional named or hexadecimal block tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Usage

**Slug:** `ETHERSCAN_GET_API_USAGE`

Get API credits used, available, and allowed for the connected API key's current interval. This account-level operation has no chain selection.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block by Number

**Slug:** `ETHERSCAN_GET_BLOCK_BY_NUMBER`

Get JSON-RPC block information for an explicit hexadecimal block number or the latest block, returning transaction hashes or full transaction objects. Proxy-read chain and plan availability is dynamic and currently unknown; null-result behavior is unprobed.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID as a positive decimal string. |
| `block_tag` | string | No | Optional block to retrieve, either 'latest' or a 0x-prefixed hexadecimal block number. Etherscan documents no default. |
| `include_full_transactions` | boolean | Yes | Whether to return full transaction objects. False returns only transaction hashes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block Countdown

**Slug:** `ETHERSCAN_GET_BLOCK_COUNTDOWN`

Estimate blocks and seconds remaining until a future block is mined.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_number` | integer | Yes | Future target block number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block Number by Timestamp

**Slug:** `ETHERSCAN_GET_BLOCK_NUMBER_BY_TIMESTAMP`

Get the decimal block number closest before or after a Unix timestamp in seconds. This community operation's chain and plan availability is dynamic and currently unknown.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `closest` | string ("before" | "after") | Yes | Return the closest available block before or after the timestamp. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `timestamp` | integer | Yes | Nonnegative Unix timestamp in seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block Rewards

**Slug:** `ETHERSCAN_GET_BLOCK_REWARDS`

Get a block's miner reward, uncle inclusion reward, and included uncle records.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_number` | integer | Yes | Block number whose rewards to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block Transaction Count

**Slug:** `ETHERSCAN_GET_BLOCK_TRANSACTION_COUNT`

Get a block's total JSON-RPC transaction count as hexadecimal, without transfer-type breakdowns.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional block number as 0x-prefixed hexadecimal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block Transaction Counts

**Slug:** `ETHERSCAN_GET_BLOCK_TRANSACTION_COUNTS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Ethereum mainnet chain ID 1; this detailed count endpoint is Ethereum-only. |
| `block_number` | integer | Yes | Decimal block number whose detailed counts to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract ABI

**Slug:** `ETHERSCAN_GET_CONTRACT_ABI`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Verified contract address whose ABI to return. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string. This operation is available on all supported chains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Bytecode

**Slug:** `ETHERSCAN_GET_CONTRACT_BYTECODE`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Address whose stored bytecode to return. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional latest, earliest, pending, or hexadecimal block tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Creation

**Slug:** `ETHERSCAN_GET_CONTRACT_CREATION`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `contract_addresses` | array | Yes | One to five contract addresses whose creation metadata to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Execution Status

**Slug:** `ETHERSCAN_GET_CONTRACT_EXECUTION_STATUS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `transaction_hash` | string | Yes | Transaction hash whose contract execution status to inspect. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Source Code

**Slug:** `ETHERSCAN_GET_CONTRACT_SOURCE_CODE`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Contract address whose source and verification metadata to return. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string. This operation is available on all supported chains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Storage

**Slug:** `ETHERSCAN_GET_CONTRACT_STORAGE`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Contract address whose storage to read. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional latest, earliest, pending, or hexadecimal block tag. |
| `position_hex` | string | Yes | Storage position as 0x-prefixed hexadecimal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Gas Price

**Slug:** `ETHERSCAN_GET_CURRENT_GAS_PRICE`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get ERC20 Balance

**Slug:** `ETHERSCAN_GET_ERC20_BALANCE`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Account address whose ERC20 token balance to return. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string. |
| `block_tag` | string | No | Use latest for the current balance; this endpoint documents no other tag. |
| `block_number` | integer | No | Historical block number. |
| `contract_address` | string | Yes | ERC20 token contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get ERC20 Total Supply

**Slug:** `ETHERSCAN_GET_ERC20_TOTAL_SUPPLY`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `block_number` | integer | No | Historical block number. When omitted, return current supply; historical lookup requires Standard+ and a supported mainnet. |
| `contract_address` | string | Yes | ERC20 token contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ether Supply

**Slug:** `ETHERSCAN_GET_ETHER_SUPPLY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `detail` | string ("basic" | "components") | Yes | Basic supply scalar or detailed supply components. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Gas Oracle

**Slug:** `ETHERSCAN_GET_GAS_ORACLE`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one chain ID, as a string. The endpoint documentation displays Ethereum, BNB Smart Chain, Polygon, Celo, Gnosis, and Linea mainnets; availability on other chains is unknown. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Latest Block Number

**Slug:** `ETHERSCAN_GET_LATEST_BLOCK_NUMBER`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Latest Native Price

**Slug:** `ETHERSCAN_GET_LATEST_NATIVE_PRICE`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Native Balance

**Slug:** `ETHERSCAN_GET_NATIVE_BALANCE`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Account address whose native-token balance to return. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `block_tag` | string | No | Use latest or a hexadecimal block number within the last 128 blocks; older historical balances require a different endpoint. |
| `block_number` | integer | No | Historical block number, including genesis block 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Native Balances

**Slug:** `ETHERSCAN_GET_NATIVE_BALANCES`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `addresses` | array | Yes | One to 20 account addresses whose native-token balances to return. |
| `block_tag` | string | No | Use latest or a hexadecimal block number within the last 128 blocks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Node Count

**Slug:** `ETHERSCAN_GET_NODE_COUNT`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | History order; invalid for current. |
| `period` | string ("current" | "history") | Yes | Current snapshot or historical series. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | No | History end date. |
| `start_date` | string | No | History start date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Holder Count

**Slug:** `ETHERSCAN_GET_TOKEN_HOLDER_COUNT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal mainnet chain ID. |
| `contract_address` | string | Yes | ERC20 token contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Info

**Slug:** `ETHERSCAN_GET_TOKEN_INFO`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal mainnet chain ID. |
| `contract_address` | string | Yes | ERC20, ERC721, or ERC1155 contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transaction

**Slug:** `ETHERSCAN_GET_TRANSACTION`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lookup` | string ("hash" | "block_index") | Yes | Select lookup by transaction hash or by block and index. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional hexadecimal block number for block-index lookup. |
| `transaction_hash` | string | No | Transaction hash, required only for hash lookup. |
| `transaction_index_hex` | string | No | Optional hexadecimal transaction index for block-index lookup. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transaction Receipt

**Slug:** `ETHERSCAN_GET_TRANSACTION_RECEIPT`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID as a positive decimal string; multiple or comma-separated chain IDs are invalid. |
| `transaction_hash` | string | Yes | Transaction hash whose full receipt to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transaction Receipt Status

**Slug:** `ETHERSCAN_GET_TRANSACTION_RECEIPT_STATUS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string; comma-separated or multiple chain IDs are invalid. |
| `transaction_hash` | string | Yes | Transaction hash whose receipt status to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Uncle Block

**Slug:** `ETHERSCAN_GET_UNCLE_BLOCK`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_tag` | string | No | Optional parent block number as hexadecimal. |
| `uncle_index_hex` | string | No | Optional uncle position as hexadecimal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Verification Status

**Slug:** `ETHERSCAN_GET_VERIFICATION_STATUS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guid` | string | Yes | GUID returned by the matching verification submission endpoint. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal chain ID. |
| `verification_type` | string ("source_code" | "proxy") | Yes | Verification submission type: source_code or proxy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Beacon Withdrawals

**Slug:** `ETHERSCAN_LIST_BEACON_WITHDRAWALS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `offset` | integer | No | Records requested for this provider page. |
| `address` | string | No | Optional withdrawal recipient filter. |
| `chain_id` | string | Yes | Supported positive decimal chain ID. |
| `end_block` | integer | No | Last block to include. |
| `start_block` | integer | No | First block to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Chain Size

**Slug:** `ETHERSCAN_LIST_CHAIN_SIZE`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | Yes | Last UTC date in YYYY-MM-DD format. |
| `sync_mode` | string ("default" | "archive") | Yes | Node sync mode used for the measurement. |
| `start_date` | string | Yes | First UTC date in YYYY-MM-DD format. |
| `client_type` | string ("geth" | "parity") | Yes | Node client used for the measurement. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Daily Block Counts and Rewards

**Slug:** `ETHERSCAN_LIST_DAILY_BLOCK_COUNTS_AND_REWARDS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | Yes | Last UTC date in YYYY-MM-DD format. |
| `start_date` | string | Yes | First UTC date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Daily Gas Prices

**Slug:** `ETHERSCAN_LIST_DAILY_GAS_PRICES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | Yes | Last UTC date in YYYY-MM-DD format. |
| `start_date` | string | Yes | First UTC date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Daily Network Metrics

**Slug:** `ETHERSCAN_LIST_DAILY_NETWORK_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `metric` | string ("average_block_size_bytes" | "average_block_time_seconds" | "average_gas_limit" | "average_hash_rate_ghs" | "average_network_difficulty" | "block_rewards_eth" | "ens_registration_count" | "gas_used" | "network_utilization_ratio" | "new_address_count" | "transaction_count" | "transaction_fees_eth" | "ether_price_usd") | Yes | Daily scalar series to return; selects a fixed stats operation and unit. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | Yes | Last UTC date in YYYY-MM-DD format. |
| `start_date` | string | Yes | First UTC date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Daily Uncle Counts and Rewards

**Slug:** `ETHERSCAN_LIST_DAILY_UNCLE_COUNTS_AND_REWARDS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `end_date` | string | Yes | Last UTC date in YYYY-MM-DD format. |
| `start_date` | string | Yes | First UTC date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List ERC721 Inventory

**Slug:** `ETHERSCAN_LIST_ERC721_INVENTORY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `offset` | integer | No | Records requested for this provider page. |
| `address` | string | Yes | Owner address whose NFT inventory to list. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `contract_address` | string | Yes | ERC721 collection contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Logs

**Slug:** `ETHERSCAN_LIST_EVENT_LOGS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number to return, starting at 1. |
| `offset` | integer | No | Logs requested for this provider page. The official documentation does not establish a maximum. |
| `address` | string | No | Emitting contract address. If omitted, at least one topic is required. |
| `topic_0` | string | No | Topic at index 0, commonly the event-signature hash. |
| `topic_1` | string | No | Topic at index 1. |
| `topic_2` | string | No | Topic at index 2. Supported only when address is omitted. |
| `topic_3` | string | No | Topic at index 3. Supported only when address is omitted. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID as a decimal string. |
| `to_block` | integer | Yes | Last block number in the inclusive range. Keep ranges narrow to reduce timeout risk. |
| `from_block` | integer | Yes | First block number in the inclusive range. Keep ranges narrow to reduce timeout risk. |
| `topic_0_1_operator` | string ("and" | "or") | No | How topic_0 and topic_1 are combined; both topics are required. |
| `topic_0_2_operator` | string ("and" | "or") | No | How topic_0 and topic_2 are combined in topic-only mode; both topics are required. |
| `topic_0_3_operator` | string ("and" | "or") | No | How topic_0 and topic_3 are combined in topic-only mode; both topics are required. |
| `topic_1_2_operator` | string ("and" | "or") | No | How topic_1 and topic_2 are combined in topic-only mode; both topics are required. |
| `topic_1_3_operator` | string ("and" | "or") | No | How topic_1 and topic_3 are combined in topic-only mode; both topics are required. |
| `topic_2_3_operator` | string ("and" | "or") | No | How topic_2 and topic_3 are combined in topic-only mode; both topics are required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Internal Transactions

**Slug:** `ETHERSCAN_LIST_INTERNAL_TRANSACTIONS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1, for address or block-range mode. Do not provide this in transaction-hash mode. |
| `sort` | string ("asc" | "desc") | No | Block order for address or block-range mode. Do not provide this in transaction-hash mode. |
| `offset` | integer | No | Records requested for this page in address or block-range mode. Etherscan documents no maximum. Do not provide this in transaction-hash mode. |
| `address` | string | No | Address whose internal transactions to list. Omit for transaction-hash or block-range-only mode. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID as a decimal string. Block-range-only mode requires a mainnet. |
| `end_block` | integer | No | Last block to include. With no address or transaction_hash, both block bounds are required and select Standard+ mainnet-only block-range mode. |
| `start_block` | integer | No | First block to include. With no address or transaction_hash, both block bounds are required and select Standard+ mainnet-only block-range mode. |
| `transaction_hash` | string | No | Transaction hash whose non-zero-value internal transactions to list. When set, omit every other selector, block bound, and pagination option. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List L2 Bridge Transactions

**Slug:** `ETHERSCAN_LIST_L2_BRIDGE_TRANSACTIONS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `sort` | string ("asc" | "desc") | No | Oldest-first or newest-first order. |
| `offset` | integer | No | Records requested for this provider page. |
| `address` | string | Yes | Address whose bridge transactions to list. |
| `chain_id` | string | Yes | Supported positive decimal L2 chain ID. |
| `direction` | string ("deposit" | "withdrawal") | Yes | Bridge direction relative to Ethereum. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Normal Transactions

**Slug:** `ETHERSCAN_LIST_NORMAL_TRANSACTIONS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number to return, starting at 1. |
| `sort` | string ("asc" | "desc") | No | Sort by block order ascending or descending. |
| `offset` | integer | No | Records requested for this page. The official documentation does not establish a maximum. |
| `address` | string | Yes | Account address whose normal transactions to list. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported chain ID, as a string. |
| `end_block` | integer | No | Last block number to include; narrow ranges reduce timeout risk. |
| `start_block` | integer | No | First block number to include; narrow ranges reduce timeout risk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Plasma Deposits

**Slug:** `ETHERSCAN_LIST_PLASMA_DEPOSITS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `offset` | integer | No | Records requested for this provider page. |
| `address` | string | No | Optional recipient address filter. |
| `chain_id` | string ("137" | "100" | "199") | Yes | Supported Plasma chain ID; the official operation documents Polygon 137, Gnosis 100, and BitTorrent Chain 199. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Chains

**Slug:** `ETHERSCAN_LIST_SUPPORTED_CHAINS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Token Holders

**Slug:** `ETHERSCAN_LIST_TOKEN_HOLDERS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number; valid only for all ranking. |
| `offset` | integer | No | Records requested; top ranking permits at most 1000. |
| `ranking` | string ("all" | "top") | Yes | Use all for a paged holder list or top for top-ranked holders. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal mainnet chain ID. |
| `contract_address` | string | Yes | ERC20 token contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Token Holdings

**Slug:** `ETHERSCAN_LIST_TOKEN_HOLDINGS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `offset` | integer | No | Records requested for this provider page. |
| `address` | string | Yes | Address whose holdings to list. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `token_standard` | string ("erc20" | "erc721") | Yes | Holding type; selects ERC20 or ERC721 holdings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Token Transfers

**Slug:** `ETHERSCAN_LIST_TOKEN_TRANSFERS`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number to return, starting at 1. |
| `sort` | string ("asc" | "desc") | No | Sort transfers by block order ascending or descending. |
| `offset` | integer | No | Records requested for this page. The official documentation does not establish a maximum. |
| `address` | string | No | Account address involved in transfers. At least one of address or contract_address is required. |
| `chain_id` | string | Yes | Exactly one current Etherscan-supported positive decimal chain ID. |
| `end_block` | integer | No | Last block number to include. |
| `start_block` | integer | No | First block number to include. |
| `token_standard` | string ("erc20" | "erc721" | "erc1155") | Yes | Token standard whose transfers to list: erc20, erc721, or erc1155. |
| `contract_address` | string | No | Token contract address for the selected standard. At least one of address or contract_address is required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Validated Blocks

**Slug:** `ETHERSCAN_LIST_VALIDATED_BLOCKS`

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

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Provider page number, starting at 1. |
| `offset` | integer | No | Records requested for this provider page. |
| `chain_id` | string | Yes | Exactly one supported positive decimal chain ID. |
| `block_type` | string ("blocks" | "uncles") | No | Full blocks or pre-Merge uncle blocks. |
| `validator_address` | string | Yes | Validator or miner address whose blocks to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve ENS Name

**Slug:** `ETHERSCAN_RESOLVE_ENS_NAME`

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.

**Instant:** Supported on the latest version.

**Instant pricing:** Estimated $0.016 per 1,000 API calls

**Discount:** 17

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | ENS name or onchain subdomain to resolve. |
| `chain_id` | string | Yes | Ethereum mainnet chain ID 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |