> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Etherscan

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.

**Authentication:** API Key
**Categories:** Developer Tools, Analytics
**Tools:** 60: 60 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ETHERSCAN)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Etherscan connection

   In **AgentKit > Connections**, create an Etherscan connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'etherscan'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'etherscan_api_usage_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "etherscan"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="etherscan_api_usage_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Etherscan credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'etherscan_address_funded_by_get',
  toolInput: {
    address: '<address>',
  },
  connector: 'etherscan',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="etherscan_address_funded_by_get",
    tool_input={
        "address": "<address>",
    },
    connection_name="etherscan",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `etherscan_address_funded_by_get`

Get Address Funded By · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>"}`

### `etherscan_address_nft_holdings_list`

Get Address ERC721 Token Holding · Read-only

List the ERC-721 collections and token counts held by an address. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"address":"<address>"}`

### `etherscan_address_nft_inventory_list`

Get Address ERC721 Token Inventory by Contract · Read-only

List the ERC-721 token IDs an address holds in one collection. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"address":"<address>","contractaddress":"<contractaddress>"}`

### `etherscan_address_tag_get`

Get Metadata for an Address · Read-only

Get the name tag, labels, reputation and other metadata of an address. Metadata plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>"}`

### `etherscan_address_token_holdings_list`

Get Address ERC20 Token Holding · Read-only

List the ERC-20 tokens and balances held by an address. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"address":"<address>"}`

### `etherscan_api_usage_get`

Get API Usage · Read-only

Get your API credit usage and limit for the current interval. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `etherscan_balance_get`

Get Native Balance for an Address · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"address":"<address>"}`

### `etherscan_balance_history_get`

Get Historical Native Balance for an Address · Read-only

Get the native token balance of an address at a past block number. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `blockno` (`integer`, required): Block number. Example: 19000000.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>","blockno":19000000}`

### `etherscan_balances_multi_get`

Get Native Balance for Multiple Addresses · Read-only

Get the native token balances (in wei) of up to 20 addresses in one call. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Comma-separated addresses, up to 20. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"address":"<address>"}`

### `etherscan_beacon_withdrawals_list`

Get Beacon Chain Withdrawals by Address · Read-only

List beacon chain withdrawals to an address. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{}`

### `etherscan_block_number_by_time_get`

Get Block Number by Timestamp · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `closest` (`string`, required): Closest available block to the provided timestamp, either before or after. Example: before. One of: `before`, `after`.
- `timestamp` (`integer`, required): Unix timestamp in seconds. Example: 1735689600.
- `chainid` (`string`, optional): 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`.

Example input: `{"closest":"before","timestamp":1735689600}`

### `etherscan_block_reward_get`

Get Block and Uncle Rewards by Block Number · Read-only

Get the block reward and uncle rewards of a block, with its miner and timestamp. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockno` (`integer`, required): Block number. Example: 19000000.
- `chainid` (`string`, optional): 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`.

Example input: `{"blockno":19000000}`

### `etherscan_block_transaction_count_get`

Get Block Transaction Counts by Block Number · Read-only

Get the number of transactions, internal transactions and ERC-20, ERC-721 and ERC-1155 transfers in a block. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockno` (`integer`, required): Block number. Example: 19000000.
- `chainid` (`string`, optional): 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`.

Example input: `{"blockno":19000000}`

### `etherscan_chains_list`

Chainlist · Read-only

List every chain the Etherscan API supports, with its chain ID, name, explorer URL and status. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `etherscan_contract_abi_get`

Get Contract ABI · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>"}`

### `etherscan_contract_creation_get`

Get Contract Creator and Creation Tx Hash · Read-only

Get the deployer address and creation transaction hash of up to 5 contracts. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddresses` (`string`, required): Comma-separated contract addresses, up to 5. Example: 0xB83c27805aAcA5C7082eB45C868d955Cf04C337F,0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45.
- `chainid` (`string`, optional): 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`.

Example input: `{"contractaddresses":"<contractaddresses>"}`

### `etherscan_contract_source_get`

Get Contract Source Code · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>"}`

### `etherscan_daily_avg_gas_price_list`

Get Daily Average Gas Price · Read-only

Get the daily maximum, minimum and average gas price over a date range. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `enddate` (`string`, required): End date, YYYY-MM-DD. Example: 2026-01-31.
- `startdate` (`string`, required): Start date, YYYY-MM-DD. Example: 2026-01-01.
- `chainid` (`string`, optional): 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`.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"enddate":"<enddate>","startdate":"<startdate>"}`

### `etherscan_daily_transaction_fees_list`

Get Daily Network Transaction Fee · Read-only

Get the total transaction fees paid each day over a date range. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `enddate` (`string`, required): End date, YYYY-MM-DD. Example: 2026-01-31.
- `startdate` (`string`, required): Start date, YYYY-MM-DD. Example: 2026-01-01.
- `chainid` (`string`, optional): 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`.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"enddate":"<enddate>","startdate":"<startdate>"}`

### `etherscan_daily_transactions_list`

Get Daily Transaction Count · Read-only

Get the daily number of transactions on the chain over a date range. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `enddate` (`string`, required): End date, YYYY-MM-DD. Example: 2026-01-31.
- `startdate` (`string`, required): Start date, YYYY-MM-DD. Example: 2026-01-01.
- `chainid` (`string`, optional): 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`.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"enddate":"<enddate>","startdate":"<startdate>"}`

### `etherscan_ens_resolve`

Resolve an ENS Name to an Address · Read-only

Resolve an ENS name or subdomain, such as vitalik.eth, to its address. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): The ENS name to resolve, such as etherscan.eth or gm.etherscan.eth. Example: vitalik.eth.
- `chainid` (`string`, optional): 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`.

Example input: `{"name":"<name>"}`

### `etherscan_erc1155_transfers_list`

Get ERC1155 Token Transfers by Address · Read-only

List ERC-1155 token transfers of an address, of a token contract, or both. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `contractaddress` (`string`, optional): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{}`

### `etherscan_eth_block_get`

eth_getBlockByNumber · Read-only

Get a block by number (eth_getBlockByNumber), with full transactions when boolean is true or only hashes when false. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `boolean` (`boolean`, required): Set to true to return full transaction objects or false for transaction hashes only. Example: true.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"boolean":true}`

### `etherscan_eth_block_number_get`

eth_blockNumber · Read-only

Get the number of the most recent block, in hex (eth_blockNumber). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_eth_block_transaction_count_get`

eth_getBlockTransactionCountByNumber · Read-only

Get the number of transactions in a block (eth_getBlockTransactionCountByNumber), in hex. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{}`

### `etherscan_eth_call`

eth_call · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `to` (`string`, required): The address to interact with, as a 0x-prefixed hex address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.
- `data` (`string`, optional): 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.
- `from` (`string`, optional): 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.
- `gas` (`string`, optional): Gas limit, as 0x-prefixed hex, such as 0x5208 for 21000. Decimal values are read as hex: 21000 becomes 0x21000 (135168). Example: 0x5208.
- `gas_price` (`string`, optional): 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.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.
- `value` (`string`, optional): 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.

Example input: `{"to":"<to>"}`

### `etherscan_eth_code_get`

eth_getCode · Read-only

Get the bytecode stored at an address (eth_getCode); 0x means it is not a contract. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"address":"<address>"}`

### `etherscan_eth_daily_price_list`

Get Ether Historical Price · Read-only

Get the daily USD price of the native token over a date range. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `enddate` (`string`, required): End date, YYYY-MM-DD. Example: 2026-01-31.
- `startdate` (`string`, required): Start date, YYYY-MM-DD. Example: 2026-01-01.
- `chainid` (`string`, optional): 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`.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"enddate":"<enddate>","startdate":"<startdate>"}`

### `etherscan_eth_gas_estimate`

eth_estimateGas · Read-only

Estimate the gas a transaction would use (eth_estimateGas), without sending it. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.
- `data` (`string`, optional): Hash of the method signature and encoded parameters. Example: 0x70a08231000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
- `gas` (`string`, optional): Gas limit provided for the transaction, in hex. Example: 0x5208.
- `gas_price` (`string`, optional): Gas price in wei. Example: 0x77359400.
- `to` (`string`, optional): The address to interact with. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `value` (`string`, optional): Value sent in this transaction, in hex. Example: 0x0.

Example input: `{}`

### `etherscan_eth_gas_price_get`

eth_gasPrice · Read-only

Get the current gas price in wei, in hex (eth_gasPrice). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_eth_price_get`

Get Ether Last Price · Read-only

Get the latest price of the native token in USD and BTC, with timestamps. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_eth_storage_get`

eth_getStorageAt · Read-only

Get the value of a storage slot of a contract (eth_getStorageAt). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `position` (`string`, required): Storage position in hex. Example: 0x0.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"address":"<address>","position":"<position>"}`

### `etherscan_eth_supply_get`

Get Total Supply of Ether 2 · Read-only

Get the native token supply, including staking rewards, EIP-1559 burned fees and beacon chain withdrawals. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_eth_transaction_by_block_index_get`

eth_getTransactionByBlockNumberAndIndex · Read-only

Get the transaction at an index in a block (eth_getTransactionByBlockNumberAndIndex). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.
- `index` (`string`, optional): Transaction index position in the block, in hex. Example: 0x0.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{}`

### `etherscan_eth_transaction_count_get`

eth_getTransactionCount · Read-only

Get the number of transactions sent from an address (its nonce) at a block (eth_getTransactionCount). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{}`

### `etherscan_eth_transaction_get`

eth_getTransactionByHash · Read-only

Get a transaction by hash (eth_getTransactionByHash): from, to, value, gas, input and block. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `txhash` (`string`, required): Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
- `chainid` (`string`, optional): 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`.

Example input: `{"txhash":"<txhash>"}`

### `etherscan_eth_transaction_receipt_get`

eth_getTransactionReceipt · Read-only

Get the receipt of a transaction (eth_getTransactionReceipt): status, gas used, logs and contract address. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `txhash` (`string`, required): Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
- `chainid` (`string`, optional): 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`.

Example input: `{"txhash":"<txhash>"}`

### `etherscan_gas_confirmation_time_get`

Get Estimation of Confirmation Time · Read-only

Estimate how many seconds a transaction takes to confirm at a gas price in wei. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.
- `gasprice` (`string`, optional): Gas price paid per unit of gas, in wei. Example: 2000000000.

Example input: `{}`

### `etherscan_gas_oracle_get`

Get Gas Oracle · Read-only

Get current gas price recommendations (safe, propose and fast) in gwei, the base fee and recent block gas usage. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_internal_transactions_by_block_range_list`

Get Internal Transactions by Block Range · Read-only

List all internal transactions within a block range. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `endblock` (`integer`, required): Last block to include. Example: 99999999.
- `startblock` (`integer`, required): First block to include. Example: 0.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"endblock":99999999,"startblock":0}`

### `etherscan_internal_transactions_by_hash_list`

Get Internal Transactions by Transaction Hash · Read-only

List the internal transactions executed inside one transaction. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `txhash` (`string`, required): Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
- `chainid` (`string`, optional): 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`.

Example input: `{"txhash":"<txhash>"}`

### `etherscan_internal_transactions_list`

Get Internal Transactions by Address · Read-only

List the internal transactions (value moved by contract calls) involving an address. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{"address":"<address>"}`

### `etherscan_l2_deposits_list`

Get Deposit Transactions by Address · Read-only

List the L1-to-L2 deposit transactions of an address on L2 chains such as Arbitrum and Optimism. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"address":"<address>"}`

### `etherscan_l2_withdrawals_list`

Get Withdrawal Transactions by Address · Read-only

List the L2-to-L1 withdrawal transactions of an address on L2 chains such as Arbitrum and Optimism. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.

Example input: `{"address":"<address>"}`

### `etherscan_logs_get`

Get Event Logs · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_block` (`integer`, required): First block of the range. Example: 19000000.
- `to_block` (`integer`, required): Last block of the range. Example: 19000100.
- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `topic0` (`string`, optional): The first topic to filter by. **At least one of topic0-topic3 is required.**. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef.
- `topic0_1_opr` (`string`, optional): Topic operator between topic0 and topic1, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic0_2_opr` (`string`, optional): Topic operator between topic0 and topic2, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic0_3_opr` (`string`, optional): Topic operator between topic0 and topic3, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic1` (`string`, optional): Second topic to filter by. Example: 0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
- `topic1_2_opr` (`string`, optional): Topic operator between topic1 and topic2, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic1_3_opr` (`string`, optional): Topic operator between topic1 and topic3, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic2` (`string`, optional): Third topic to filter by. Example: 0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae.
- `topic2_3_opr` (`string`, optional): Topic operator between topic2 and topic3, either and or or. Only apply when both topics are set. Example: and. One of: `and`, `or`.
- `topic3` (`string`, optional): Fourth topic to filter by. Example: 0x0000000000000000000000000000000000000000000000000000000000000001.

Example input: `{"from_block":19000000,"to_block":19000100}`

### `etherscan_mined_blocks_list`

Get Blocks Validated by Address · Read-only

List the blocks validated (mined) by an address. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `blocktype` (`string`, optional): Use blocks for full blocks, optionally uncles for pre-Merge blocks. Example: blocks. One of: `blocks`, `uncles`.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"address":"<address>"}`

### `etherscan_nft_transfers_list`

Get ERC721 Token Transfers by Address · Read-only

List ERC-721 (NFT) transfers of an address, of a collection contract, or both. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `contractaddress` (`string`, optional): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{}`

### `etherscan_node_count_get`

Get Total Nodes Count · Read-only

Get the total number of discoverable Ethereum nodes. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chainid` (`string`, optional): 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`.

Example input: `{}`

### `etherscan_token_balance_get`

Get ERC20-Token Account Balance for TokenContractAddress · Read-only

Get the ERC-20 token balance of an address for one token contract, in the token's smallest unit. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.
- `tag` (`string`, optional): Block to read at: latest, earliest, pending or a block number in hex. Example: latest.

Example input: `{"address":"<address>","contractaddress":"<contractaddress>"}`

### `etherscan_token_balance_history_get`

Get Historical ERC20-Token Account Balance by BlockNo · Read-only

Get the ERC-20 token balance of an address at a past block number. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `blockno` (`integer`, required): Block number. Example: 19000000.
- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.

Example input: `{"address":"<address>","blockno":19000000,"contractaddress":"<contractaddress>"}`

### `etherscan_token_holder_count_get`

Get Token Holder Count by Contract Address · Read-only

Get the number of holders of an ERC-20 token. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.

Example input: `{"contractaddress":"<contractaddress>"}`

### `etherscan_token_holders_list`

Get Token Holder List by Contract Address · Read-only

List the holders of an ERC-20 token and their balances. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{"contractaddress":"<contractaddress>"}`

### `etherscan_token_info_get`

Get Token Info by ContractAddress · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.

Example input: `{"contractaddress":"<contractaddress>"}`

### `etherscan_token_supply_get`

Get ERC20-Token TotalSupply by ContractAddress · Read-only

Get the total supply of an ERC-20 token, in its smallest unit. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.

Example input: `{"contractaddress":"<contractaddress>"}`

### `etherscan_token_supply_history_get`

Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo · Read-only

Get the total supply of an ERC-20 token at a past block. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockno` (`integer`, required): Block number. Example: 19000000.
- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.

Example input: `{"blockno":19000000,"contractaddress":"<contractaddress>"}`

### `etherscan_token_top_holders_list`

Get Top Token Holders · Read-only

List the top holders of an ERC-20 token with their balances. PRO plan endpoint. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contractaddress` (`string`, required): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `chainid` (`string`, optional): 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`.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.

Example input: `{"contractaddress":"<contractaddress>"}`

### `etherscan_token_transfers_list`

Get ERC20 Token Transfers by Address · Read-only

List ERC-20 token transfers of an address, of a token contract, or of an address for one token. Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `contractaddress` (`string`, optional): Token contract address. Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{}`

### `etherscan_transaction_execution_status_get`

Check Contract Execution Status · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `txhash` (`string`, required): Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
- `chainid` (`string`, optional): 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`.

Example input: `{"txhash":"<txhash>"}`

### `etherscan_transaction_receipt_status_get`

Check Transaction Receipt Status · Read-only

Get the receipt status of a transaction: 1 for success, 0 for failure (post-Byzantium transactions). Returns status, message and result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `txhash` (`string`, required): Transaction hash. Example: 0xb5c8bd9430b6cc87a0e2fe110ece6bf527fa4f170a4bc8cd032f768fc5219838.
- `chainid` (`string`, optional): 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`.

Example input: `{"txhash":"<txhash>"}`

### `etherscan_transactions_list`

Get Normal Transactions By Address · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address to query, 0x followed by 40 hex characters. Example: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.
- `chainid` (`string`, optional): 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`.
- `endblock` (`integer`, optional): Last block to include. Example: 99999999.
- `offset` (`integer`, optional): Records per page (the API caps page times offset at 10,000). Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): Sort order: asc (oldest first) or desc (newest first). Example: desc. One of: `asc`, `desc`.
- `startblock` (`integer`, optional): First block to include. Example: 0.

Example input: `{"address":"<address>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
