exploring-blockchain-data

BbgnsurfTech's avatarfrom BbgnsurfTech

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".

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 18, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive suite for blockchain data exploration and cryptocurrency market analysis. It enables users to query real-time market metrics, analyze on-chain transactions, and evaluate smart contract interactions across various networks. By integrating blockchain RPC endpoints and market APIs, the skill facilitates deep-dive research into liquidity, volatility, and network activity, delivering actionable insights through automated reporting and technical indicator analysis.

Use Cases

  • Investment Research: Analyze real-time price movements, trading volumes, and market capitalization across thousands of crypto assets to identify emerging trends.
  • On-Chain Data Auditing: Track wallet activities, monitor large-scale 'whale' transactions, and analyze network health metrics like active addresses and gas usage.
  • DeFi Protocol Analysis: Evaluate decentralized finance ecosystems by querying Total Value Locked (TVL), smart contract interactions, and token holder concentration.
  • Risk Assessment: Generate detailed reports on portfolio volatility, correlation metrics, and Value at Risk (VaR) to inform position sizing and risk mitigation strategies.
  • Technical Analysis Automation: Apply indicators such as RSI, MACD, and Bollinger Bands to blockchain data to generate automated trading signals and chart pattern recognition.
nameexploring-blockchain-data
version1.0.0
description|
allowed-toolsRead, Write, Edit, Grep, Glob, Bash(crypto:explorer-*)
licenseMIT

Prerequisites

Before using this skill, ensure you have:

  • Access to crypto market data APIs (CoinGecko, CoinMarketCap, or similar)
  • Blockchain RPC endpoints or node access (Infura, Alchemy, or self-hosted)
  • API keys for exchanges if trading or querying account data
  • Web3 libraries installed (ethers.js, web3.py, or equivalent)
  • Understanding of blockchain concepts and crypto market dynamics

Instructions

Step 1: Configure Data Sources

Set up connections to crypto data providers:

  1. Use Read tool to load API credentials from {baseDir}/config/crypto-apis.env
  2. Configure blockchain RPC endpoints for target networks
  3. Set up exchange API connections if required
  4. Verify rate limits and subscription tiers
  5. Test connectivity and authentication

Step 2: Query Crypto Data

Retrieve relevant blockchain and market data:

  1. Use Bash(crypto:explorer-*) to execute crypto data queries
  2. Fetch real-time prices, volumes, and market cap data
  3. Query blockchain for on-chain metrics and transactions
  4. Retrieve exchange order book and trade history
  5. Aggregate data from multiple sources for accuracy

Step 3: Analyze and Process

Process crypto data to generate insights:

  • Calculate key metrics (returns, volatility, correlation)
  • Identify patterns and anomalies in data
  • Apply technical indicators or on-chain signals
  • Compare across timeframes and assets
  • Generate actionable insights and alerts

Step 4: Generate Reports

Document findings in {baseDir}/crypto-reports/:

  • Market summary with key price movements
  • Detailed analysis with charts and metrics
  • Trading signals or opportunity recommendations
  • Risk assessment and position sizing guidance
  • Historical context and trend analysis

Output

The skill generates comprehensive crypto analysis:

Market Data

Real-time and historical metrics:

  • Current prices across exchanges with spread analysis
  • 24h volume, market cap, and circulating supply
  • Price changes across multiple timeframes (1h, 24h, 7d, 30d)
  • Trading volume distribution by exchange
  • Liquidity metrics and slippage estimates

On-Chain Metrics

Blockchain-specific analysis:

  • Transaction count and network activity
  • Active addresses and user growth metrics
  • Token holder distribution and concentration
  • Smart contract interactions and DeFi TVL
  • Gas usage and network congestion indicators

Technical Analysis

Trading indicators and signals:

  • Moving averages (SMA, EMA) and trend identification
  • RSI, MACD, Bollinger Bands technical indicators
  • Support and resistance levels
  • Chart patterns and breakout signals
  • Volume profile and accumulation zones

Risk Metrics

Portfolio and position risk assessment:

  • Value at Risk (VaR) calculations
  • Portfolio correlation and diversification metrics
  • Volatility analysis and beta to market
  • Drawdown statistics and recovery times
  • Liquidation risk for leveraged positions

Error Handling

Common issues and solutions:

API Rate Limit Exceeded

  • Error: Too many requests to crypto data API
  • Solution: Implement request throttling; use caching for frequently accessed data; upgrade API tier if needed

Blockchain RPC Errors

  • Error: Cannot connect to blockchain node or timeout
  • Solution: Switch to backup RPC endpoint; verify network connectivity; check if node is synced

Invalid Address or Transaction

  • Error: Blockchain address format invalid or transaction not found
  • Solution: Validate address checksums; verify network (mainnet vs testnet); allow time for transaction confirmation

Exchange API Authentication Failed

  • Error: Invalid API key or signature mismatch
  • Solution: Regenerate API keys; verify permissions (read/trade); check system clock synchronization for signatures

Resources

Crypto Data Providers

  • CoinGecko API for market data across thousands of assets
  • Etherscan API for Ethereum blockchain data
  • Dune Analytics for on-chain SQL queries
  • The Graph for decentralized blockchain indexing

Web3 Libraries

  • ethers.js for Ethereum smart contract interaction
  • web3.py for Python-based blockchain queries
  • viem for TypeScript Web3 development
  • Hardhat for local blockchain testing

Trading and Analysis Tools

  • TradingView for technical analysis and charting
  • Glassnode for advanced on-chain metrics
  • DeFi Llama for DeFi protocol analytics
  • Nansen for wallet tracking and smart money flows

Best Practices

  • Never store private keys or seed phrases in code
  • Always verify smart contract addresses from official sources
  • Use testnet for experimentation before mainnet
  • Implement proper error handling for network failures
  • Monitor gas prices before submitting transactions
  • Validate all user inputs to prevent injection attacks