alchemy_skill

Overview

This skill provides a utility toolkit for interacting with blockchain data using the Alchemy API. It exposes CLI commands to fetch balances, token and NFT details, transactions, blocks, gas prices, logs, and asset transfers. Outputs are JSON by default for easy scripting and integration. It requires an ALCHEMY_API_KEY to operate.

How this skill works

The skill is a single Python CLI script that maps commands to Alchemy REST endpoints and processes responses into JSON. You call commands with flags like --address, --hash, --contract, or --token-id to retrieve specific data. It supports queries for ERC-20 balances, NFTs and metadata, transaction and block lookups, event logs, gas pricing, and webhook-ready outputs. Responses can be piped into other tools or stored for archival and analysis.

When to use it

• Fetch ETH and ERC-20 token balances for wallets
• Retrieve NFTs owned by an address and their metadata
• Audit transactions or fetch a transaction by hash for troubleshooting
• Monitor gas prices or latest block info for transaction timing
• Extract event logs and asset transfer history for on-chain analysis

Best practices

• Set ALCHEMY_API_KEY as an environment variable to avoid exposing credentials
• Use JSON output to integrate results with scripts, databases, or logging systems
• Batch queries where possible to stay within API rate limits
• Filter logs and transfers by block range and topics to reduce payload size
• Validate contract addresses and token IDs before querying to avoid unnecessary API calls

Example use cases

• Automated balance checks for a set of customer wallets in a cron job
• Generate a report of NFT holdings and metadata for a collector dashboard
• Investigate a failed transaction by fetching its receipt and block details
• Archive event logs and asset transfers for compliance or forensic analysis
• Monitor gas price trends to optimize transaction submission timing