CLI
The short path
npx @agntn/explorers vitalik.eth
npx @agntn/explorers tx vitalik.eth -n 5
npx @agntn/explorers providers
A first argument that looks like an address defaults to balance. When both provider and chain are omitted, balance reads start on Ethereum; an explicit --provider keeps that provider's default chain, so explorers balance 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa -p mempool reads Bitcoin without a -c.
Commands
| Command | What it does | Example |
|---|---|---|
balance | Native token balance, including ENS | explorers balance vitalik.eth |
tx | Transaction history or one transaction | explorers tx vitalik.eth -n 5 |
contract | ABI, source and verification status | explorers contract 0x1f984... |
tokens | ERC-20, SPL and Cardano native holdings | explorers tokens vitalik.eth |
transfers | ERC-20 transfer history for an address | explorers transfers vitalik.eth |
gas | Current gas prices | explorers gas -c base |
block | Block data by number | explorers block 18000000 |
providers | Registered providers and their capabilities | explorers providers |
mcp | The MCP server over stdio | explorers mcp |
Options
| Option | Meaning |
|---|---|
-c, --chain | Chain name or alias, for example eth, mainnet, btc or arbitrum |
-p, --provider | Explorer backend, for example etherscan, blockscout or mempool |
-n, --limit | Maximum number of transactions |
-m, --mode | Force tx into history or detail mode when the input is ambiguous |
-t, --token | Limit transfers to one token contract |
When tx cannot tell
tx classifies its argument: a 64-hex string is a hash on Ethereum, a hash on Bitcoin, TRON and Cardano too, and a base58 string of the right length is a hash on Solana and Sui. Everything else is treated as an address. Arweave breaks that rule, because a transaction id and a wallet address have the same shape there, so say what you mean:
explorers tx FPjbN_btYKzcf8QASjs30v5C0FPv7XpwKXENBW8dqVw -c arweave -n 3
explorers tx 2Bg8S0GcQmbC-FeT5dDKcj0WOK2YmH7Y4mlW-mO8_yE -p arweave -m detail
--mode accepts history or detail and nothing else. A typo is an error, not a guess.
Keys
Keys come from the environment and only from there. ETHERSCAN_API_KEY, SOLSCAN_API_KEY, HELIUS_API_KEY, TRONSCAN_API_KEY, BLOCKBERRY_API_KEY, and BLOCKCHAIR_API_KEY for a higher Blockchair tier. Set one and the matching provider moves to the front of the queue for every chain it serves; the ranking is in Provider selection. explorers providers prints which ones are active on this machine.
Exit codes
A failed read prints the error and exits 1. An invalid --limit, a --mode outside the two values, or a provider that cannot serve the operation all fail the same way, before any request goes out.