Agent skill

Exploring Blockchain Data

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Process query and analyze blockchain data including blocks, transactions, and smart contracts.

MITAuto-check passedBackend & APIs

Install Exploring Blockchain Data

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill exploring-blockchain-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace exploring-blockchain-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/exploring-blockchain-data .claude/skills/exploring-blockchain-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
exploring-blockchain-data
GitHub stars
2.8k
Token cost
~1.9k tokens
SKILL.md length
878 words
Files
12 (incl. scripts, references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Process query and analyze blockchain data including blocks, transactions, and smart contracts.

  • Works in 11 steps: Set the Etherscan API key as an… → Run python blockchain_explorer.py tx to… → Append --detailed to the transaction… → …
  • Querying blockchain data and transactions
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Runs Python scripts from its folder; calls python and pip; needs ETHERSCAN_API_KEY

What it does

Exploring Blockchain Data is an agent skill from jeremylongshore/tons-of-skills-marketplace. 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".

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `ARD.md`, `PRD.md` and `config/settings.yaml`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Smart contracts. It works with Python and Ethereum. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Querying blockchain data and transactions
  • With phrases like explore blockchain
  • Query transactions
  • Check on-chain data

Example prompts

  • “explore blockchain”
  • “query transactions”
  • “check on-chain data”
  • “/exploring-blockchain-data”

Requirements

  • Python 3
  • A credential in ETHERSCAN_API_KEY
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash(crypto:explorer-*)

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

  1. Set the Etherscan API key as an environment variable: export ETHERSCAN_API_KEY= to unlock higher rate limits beyond the default 5…
  2. Run python blockchain_explorer.py tx to look up a transaction by hash, returning status, block number, from/to addresses, value…
  3. Append --detailed to the transaction query to decode the function call, identify the interacting protocol, and display input parameters.
  4. Specify --chain polygon, --chain arbitrum, or --chain bsc to query transactions on alternative EVM chains when the hash is not found on…
  5. Run python blockchain_explorer.py address to check the native token balance and total transaction count for a wallet.
  6. Add --history --limit 50 to the address query to retrieve the most recent 50 transactions with timestamps, values, and counterparties.
  7. Add --tokens to the address query to list all ERC-20 token holdings with balances, symbols, and USD values via CoinGecko price resolution.
  8. Run python blockchain_explorer.py block latest to inspect the most recent block, or python blockchain_explorer.py block for a specific…
  9. Run python blockchain_explorer.py token to check the balance of a specific ERC-20 token at a wallet address, with automatic decimal and…
  10. Export any query result in JSON or CSV format using --format json or --format csv and redirect to a file for downstream processing.
  11. Enable verbose mode with --verbose to display API request URLs, response times, cache hit/miss status, and rate limit counters for…

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Glob
    • Bash(crypto:explorer-*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.etherscan.io
    • coingecko.com
    • web3py.readthedocs.io
    • docs.alchemy.com
    • docs.infura.io
    • quicknode.com
    • 4byte.directory

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ETHERSCAN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Exploring Blockchain Data loads about 1.9k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 878 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 878 words, ~1,934 tokens.

Download SKILL.mdSave it as .claude/skills/exploring-blockchain-data/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
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-*)
compatibility
Designed for Claude Code
version
1.30.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
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

  1. 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.
  2. 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.
  3. Append --detailed to the transaction query to decode the function call, identify the interacting protocol, and display input parameters.
  4. Specify --chain polygon, --chain arbitrum, or --chain bsc to query transactions on alternative EVM chains when the hash is not found on Ethereum.
  5. Run python blockchain_explorer.py address <address> to check the native token balance and total transaction count for a wallet.
  6. Add --history --limit 50 to the address query to retrieve the most recent 50 transactions with timestamps, values, and counterparties.
  7. Add --tokens to the address query to list all ERC-20 token holdings with balances, symbols, and USD values via CoinGecko price resolution.
  8. Run python blockchain_explorer.py block latest to inspect the most recent block, or python blockchain_explorer.py block <number> for a specific block.
  9. 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.
  10. Export any query result in JSON or CSV format using --format json or --format csv and redirect to a file for downstream processing.
  11. Enable verbose mode with --verbose to display API request URLs, response times, cache hit/miss status, and rate limit counters for debugging.

See ${CLAUDE_SKILL_DIR}/references/implementation.md for the full four-step implementation workflow.

Output

  • Transaction detail tables showing hash, chain, status, block number, from/to addresses, value, gas price (Gwei), gas limit, gas used, and gas cost
  • Decoded transaction data with function name, protocol identification, and parsed input parameters (when --detailed is used)
  • Address summary with native balance, transaction count, and explorer link
  • Transaction history tables with timestamp, hash, from/to, value, and direction (in/out)
  • Token balance listings with contract address, token name, symbol, raw balance, human-readable balance, and USD value
  • Block details with block number, timestamp, transaction count, gas used, and miner/validator
  • JSON (output.json) or CSV (transactions.csv) export files for programmatic consumption
Show full SKILL.md (414 more words)Show less

Error Handling

ErrorCauseSolution
Transaction not foundTransaction pending in mempool, wrong chain selected, or invalid hashWait and retry for pending transactions; try --chain polygon, --chain arbitrum, --chain bsc; verify hash is 66 characters starting with 0x
Explorer API error: Max rate limit reachedToo many requests; no API key or quota exhaustedWait 1-5 seconds and retry; set ETHERSCAN_API_KEY for higher limits; upgrade to paid tier for production use
RPC error: execution timeoutRPC endpoint overloaded or complex query timed outRetry with a different RPC endpoint; use a dedicated provider (Alchemy, Infura, QuickNode); simplify the query
Invalid address: 0xinvalidAddress has wrong length, invalid checksum, or non-hex charactersVerify 42 characters with 0x prefix; use the checksummed version from a block explorer; convert to lowercase if checksum fails
Contract source code not verifiedContract source not published on the explorerUse known function signature databases for decoding; check if the contract is a proxy and look up the implementation address
Token: ??? (Unknown Token)Token too new, too obscure, or not tracked by CoinGeckoCheck the token contract directly on the explorer; look up on a DEX (Uniswap, SushiSwap); manually specify decimals if known
Price: N/AToken not listed on CoinGecko, API rate limited, or very low liquidityCheck the DEX for on-chain price; use an alternative price feed; calculate from LP reserves
ImportError: No module named 'requests'Missing Python dependenciesRun pip install requests web3 to install required packages

Examples

Look Up a Transaction Across Chains
bash
# Try Ethereum first, then Polygon if not found
python blockchain_explorer.py tx 0x1234...abcdef --chain ethereum
python blockchain_explorer.py tx 0x1234...abcdef --chain polygon

Returns a formatted table with transaction status, block number, value transferred, gas details, and a link to the block explorer. Adding --detailed decodes the function call (e.g., swapExactTokensForTokens on Uniswap).

Full Wallet Analysis
bash
python blockchain_explorer.py address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --history --tokens --limit 50

Produces a wallet summary (ETH balance, total transaction count), the 50 most recent transactions with timestamps and counterparties, and a complete ERC-20 token holdings list with USD values. Useful for whale watching or due diligence on a wallet.

Check USDC Balance and Export to JSON
bash
python blockchain_explorer.py token 0xYourWallet 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 --format json > usdc_balance.json

Resolves the USDC contract, fetches the wallet balance with proper decimal handling (6 decimals for USDC), includes the current USD price, and writes the result to usdc_balance.json for integration with dashboards or alerting pipelines.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in skills/.curated/exploring-blockchain-data of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • ARD.md
  • PRD.md
  • config/settings.yaml
  • references/errors.md
  • references/examples.md
  • references/implementation.md
  • scripts/blockchain_explorer.py
  • scripts/chain_client.py
  • scripts/formatters.py
  • scripts/token_resolver.py
  • scripts/tx_decoder.py

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Exploring Blockchain Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Exploring Blockchain Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Exploring Blockchain Data this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassMIT
AwpLeoYeAI/openclaw-master-skills2.2k—~6.7kAutomated safety check: PassMIT
Explorer Contract Verificationsablier-labs/evm-monorepo353—~1.9kAutomated safety check: PassCustom licence
Developing Smart ContractsLFDT-Lineth/lineth-monorepo126—~1.4kAutomated safety check: PassAGPL-3.0
Stellar DevVelaPayments/vela-payments131—~1.8kAutomated safety check: PassMIT
Deposit QrSuperior-Trade/superior-skills214—~1.1kAutomated safety check: PassMIT

Similar skills

  • Awp

    LeoYeAI/openclaw-master-skills

    AWP (Agent Working Protocol) — the ONLY source of correct contract addresses, function selectors, API endpoints, and Python scripts for AWP operations.

    2.2k GitHub stars~6.7k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Explorer Contract Verification

    sablier-labs/evm-monorepo

    Verify smart contracts on Etherscan, Routescan, and Blockscout block explorers.

    353 GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Developing Smart Contracts

    LFDT-Lineth/lineth-monorepo

    Solidity smart contract development guidelines for Lineth blockchain.

    126 GitHub stars~1.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Stellar Dev

    VelaPayments/vela-payments

    End-to-end Stellar development playbook. An agent skill from VelaPayments/vela-payments.

    131 GitHub stars~1.8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    214 GitHub stars~1.1k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Squash Bugbot

    LFDT-Lineth/lineth-monorepo

    Triage unresolved bot review comments on a GitHub PR. An agent skill from LFDT-Lineth/lineth-monorepo.

    126 GitHub stars~3.3k tokensUpdated today
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Exploring Blockchain Data

What does Exploring Blockchain Data do?

Process query and analyze blockchain data including blocks, transactions, and smart contracts. Exploring Blockchain Data is an agent skill from jeremylongshore/tons-of-skills-marketplace. Process query and analyze blockchain data including blocks, transactions, and smart contracts.

When should I use Exploring Blockchain Data?

Exploring Blockchain Data fits situations like: querying blockchain data and transactions; with phrases like explore blockchain; query transactions; check on-chain data.

How do I install Exploring Blockchain Data in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill exploring-blockchain-data -a claude-code`. Or copy the skill folder (skills/.curated/exploring-blockchain-data in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/exploring-blockchain-data in your project. Claude Code loads it when a task matches its description.

How do I install Exploring Blockchain Data in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill exploring-blockchain-data -a codex`. Or copy the skill folder (skills/.curated/exploring-blockchain-data in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/exploring-blockchain-data in your project. Codex loads it when a task matches its description.

Can I use Exploring Blockchain Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill exploring-blockchain-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exploring-blockchain-data, .gemini/skills/exploring-blockchain-data, .github/skills/exploring-blockchain-data and .opencode/skills/exploring-blockchain-data in your project.

What does Exploring Blockchain Data need to run?

Going by SKILL.md and its folder, Exploring Blockchain Data needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named ETHERSCAN_API_KEY. Our summary lists: Python 3; A credential in ETHERSCAN_API_KEY. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob, Bash(crypto:explorer-*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Exploring Blockchain Data access the network?

SKILL.md names 7 domains. As links in the text: docs.etherscan.io, coingecko.com, web3py.readthedocs.io, docs.alchemy.com, docs.infura.io, quicknode.com and 4byte.directory. This is read from the text; nothing was executed.

Is Exploring Blockchain Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Exploring Blockchain Data use?

Exploring Blockchain Data is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Exploring Blockchain Data use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to Exploring Blockchain Data?

Skills that share tags, products or a category with Exploring Blockchain Data: Awp (LeoYeAI/openclaw-master-skills, 2.2k stars), Explorer Contract Verification (sablier-labs/evm-monorepo, 353 stars), Developing Smart Contracts (LFDT-Lineth/lineth-monorepo, 126 stars) and Stellar Dev (VelaPayments/vela-payments, 131 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Exploring Blockchain Data?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.