Etherscan CLI

A cross-platform Go CLI and interactive explorer for the Etherscan V2 API. It maps supported Etherscan endpoints into commands for accounts, tokens, contracts, logs, gas, stats, proxy/RPC-style methods, API usage, address metadata, across multiple EVM chains.

Etherscan's API documentation remains as the main reference for endpoint parameters, responses, rate limits, supported chains, and errors.

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

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

The installers select the correct binary, verify its checksum, and add etherscan to your PATH. Open a new terminal after installation.

Download the appropriate archive and checksums.txt from GitHub Releases. Verify the checksum, extract the archive, and place etherscan on your PATH.

If installation fails, open a GitHub issue.

Store and validate an Etherscan API key, then make your first request:

etherscan login
etherscan whoami
etherscan account balance 0x0000000000000000000000000000000000000000

Select a chain by name or chain ID:

etherscan --chain base account txlist 0x0000000000000000000000000000000000000000 --page 1 --offset 5
etherscan --chain 8453 gastracker oracle

Use JSON when handing results to another program or agent:

etherscan account txlist 0x0000000000000000000000000000000000000000 --json

Run etherscan in an interactive terminal, allowing you to explore, pick and fill in the parameters of each endpoint.

etherscan

Tables are the default. Use JSON or CSV for scripts and pipelines:

etherscan account balance 0x... --json
etherscan account balance 0x... --json --compact
etherscan account txlist 0x... --csv
etherscan account txlist 0x... --all --max-pages 50 --json

If --all reaches --max-pages, the result may be truncated.