Etherscan CLI - Etherscan

Explore endpoints interactively or script them across every supported chain by name or ID, with clean JSON by default (or tables and CSV for people) across accounts, contracts, tokens, logs, gas, stats, and name tags.

The Etherscan CLI interactive explorer (etherscan tui), listing the Account module endpoints

GitHub → | Command reference →

Get started

Install

brew install etherscan/etherscan-cli/etherscan

curl -fsSL https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.sh | sh

# PowerShell
irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex

# Command Prompt
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex"

# Requires Go 1.25+; ensure GOBIN (or GOPATH/bin) is on your PATH
go install github.com/etherscan/etherscan-cli/cmd/etherscan@latest

Then verify the install:

etherscan version

Upgrade any time with:

etherscan update

Prebuilt binaries for your operating system are also on the releases page.

Authenticate

First, create a free API key if you do not have one. Then save it locally and confirm the active identity:

etherscan login
etherscan whoami

Run your first commands

Get a native balance (JSON by default):

etherscan account balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Run the same query on another chain, by name or chain ID:

etherscan --chain arbitrum account balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

List every supported chain:

etherscan chains

Or open the full-screen interactive explorer:

etherscan tui

Command reference

Commands follow etherscan <module> <action>, mirroring the API. JSON is the default output; switch it with -o table or -o csv, use --compact to strip whitespace, and --all (bounded by --max-pages) to page through list endpoints.

Module	Covers
`account`	Balances, transactions, transfers, funding
`contract`	ABI, source, creation, verification
`transaction`	Execution and receipt status
`block`	Rewards, counts, timestamps
`gastracker`	Gas oracle and confirmation estimates
`logs`	Event logs
`stats`	Supply, price, and daily network metrics
`token`	Supply, holders, and token metadata
`proxy`	JSON-RPC-compatible calls

For a command’s options, run:

etherscan <module> --help

The full flag reference lives in the README.

Practical workflows

Common tasks and the commands you would run for each.

Follow wallet activity

Recent normal transactions:

etherscan account txlist 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --page 1 --offset 10

ERC-20 transfers as a readable table instead of the default JSON:

etherscan account tokentx 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -o table

Collect multiple pages for analysis:

etherscan account txlist 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --all --max-pages 50 -o csv

Inspect a smart contract

WETH contract ABI:

etherscan contract getabi 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Verified source metadata:

etherscan contract getsourcecode 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Switch chains

Chain names and numeric IDs both work:

etherscan --chain arbitrum gastracker oracle

etherscan --chain 42161 account balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

See every chain built into this release:

etherscan chains

Build scripts and agent workflows

Clean JSON for jq, Python, or an AI agent:

etherscan account txlist 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --compact | jq '.[0]'

CSV for spreadsheets and data pipelines:

etherscan account tokentx 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -o csv > token-transfers.csv

​Get started

​Command reference

​Practical workflows

​Follow wallet activity

​Inspect a smart contract

​Switch chains

​Build scripts and agent workflows