| name | exploring-blockchain-data |
| description | Process query and analyze blockchain data including blocks, transactions, and smart contracts.
Use when querying blockchain data and transactions.
Trigger with phrases like "explore blockchain", "query transactions", or "check on-chain data".
|
| allowed-tools | Read, Write, Edit, Grep, Glob, Bash(crypto:explorer-*) |
| version | 1.0.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | MIT |
| compatible-with | claude-code, codex, openclaw |
| tags | ["crypto","exploring-blockchain"] |
Exploring Blockchain Data
Overview
Query and analyze blockchain data across multiple EVM-compatible networks including Ethereum, Polygon, Arbitrum, Optimism, and BSC. Supports transaction lookups, address balance checks, block inspection, token balance queries, transaction history retrieval, and whale wallet tracking via a unified CLI.
Prerequisites
- Python 3.8+ with
requests and web3 libraries installed (pip install requests web3)
- Etherscan API key (free tier provides 5 requests/second; set via
ETHERSCAN_API_KEY environment variable)
- Optional: API keys for Polygonscan, Arbiscan, and other chain-specific explorers for higher rate limits
blockchain_explorer.py CLI script, chain_client.py, and token_resolver.py modules available in the plugin directory- RPC endpoint access (public endpoints work; dedicated providers like Alchemy, Infura, Chainstack, or QuickNode recommended for reliability)
Instructions
- Set the Etherscan API key as an environment variable:
export ETHERSCAN_API_KEY=<key> to unlock higher rate limits beyond the default 5 requests/second.
- Run
python blockchain_explorer.py tx <hash> to look up a transaction by hash, returning status, block number, from/to addresses, value transferred, and gas details.
- Append
--detailed to the transaction query to decode the function call, identify the interacting protocol, and display input parameters.
- Specify
--chain polygon, --chain arbitrum, or --chain bsc to query transactions on alternative EVM chains when the hash is not found on Ethereum.
- Run
python blockchain_explorer.py address <address> to check the native token balance and total transaction count for a wallet.
- Add
--history --limit 50 to the address query to retrieve the most recent 50 transactions with timestamps, values, and counterparties.
- Add
--tokens to the address query to list all ERC-20 token holdings with balances, symbols, and USD values via CoinGecko price resolution.
- Run
python blockchain_explorer.py block latest to inspect the most recent block, or python blockchain_explorer.py block <number> for a specific block.
- Run
python blockchain_explorer.py token <wallet> <contract> to check the balance of a specific ERC-20 token at a wallet address, with automatic decimal and symbol resolution.
