An advanced interface for querying multi-chain EVM data, including balances, transactions, and smart contract details via the Etherscan API v2.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install etherscan
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install etherscan using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Etherscan EVM Data Query?
This skill provides a robust bridge between AI agents and the Etherscan API v2, enabling seamless access to blockchain data across various EVM-compatible networks. By integrating this into Openclaw Skills, developers can automate tasks like monitoring wallet balances, retrieving contract ABIs, and tracking ERC-20, ERC-721, or ERC-1155 token transfers without manual lookups. It ensures high-fidelity data retrieval by dynamically fetching chain IDs and adhering to proper API modules for specific tasks like gas tracking or transaction verification.
The implementation focuses on accuracy and efficiency, requiring a session-based chain list fetch to ensure that chain names are correctly mapped to their respective IDs. Whether you are auditing a wallet or monitoring gas prices, this tool provides the necessary technical infrastructure to interact with the Ethereum ecosystem and its many Layer 2 solutions through the reliable Etherscan framework.
Etherscan EVM Data Query Use Cases
- Monitoring native ETH or token balances across multiple wallet addresses simultaneously.
- Verifying the success or failure of on-chain transactions using specific transaction hashes.
- Retrieving smart contract source code and ABIs for automated code analysis or interaction.
- Tracking gas prices in real-time to optimize transaction timing and cost efficiency.
- Auditing historical transaction lists and internal transfers for forensic or accounting purposes.
How Etherscan EVM Data Query Works
- The skill initializes by retrieving the Etherscan API key from local credentials or environment variables.
- It performs a mandatory fetch of the supported chain list to map user-provided network names to the correct numeric chain IDs.
- Based on the specific technical request, it selects the appropriate Etherscan module such as account, contract, or gastracker.
- It executes a GET request to the Etherscan v2 API endpoint with required parameters including pagination, sorting, and authentication.
- The skill processes the raw JSON response, performs decimal conversions for token balances, and returns a formatted summary to the agent.
Etherscan EVM Data Query Setup
First, obtain an API key from the Etherscan dashboard. You can configure the skill by saving your key to a local credentials file to be used with Openclaw Skills:
mkdir -p ~/.config/etherscan
cat > ~/.config/etherscan/credentials.json << 'EOF'
{
"api_key": "YOUR_ETHERSCAN_API_KEY"
}
EOF
chmod 600 ~/.config/etherscan/credentials.json
Alternatively, you can set the key as an environment variable in your terminal session:
export ETHERSCAN_API_KEY=your_api_key_here
Etherscan EVM Data Query Data Schema & Taxonomy
The skill organizes data based on the Etherscan v2 API structure. Results are typically returned in a standard format to ensure consistency across Openclaw Skills integrations:
| Field | Description |
|---|---|
| status | String '1' for success, '0' for failure or no results found |
| message | Status description such as OK or NOTOK for rate limit errors |
| result | The main payload containing requested balances, transaction arrays, or ABI strings |
| chainid | The unique identifier for the EVM chain targeted by the query |
Etherscan EVM Data Query Advanced Features
- Dynamic multi-chain support with automated chain list discovery to prevent hardcoding errors.
- Intelligent pagination handling for large transaction histories using offset and sort parameters to ensure complete data retrieval.
- Comprehensive token support for ERC-20, ERC-721, and ERC-1155 standards with built-in decimal division logic.
- Real-time gas oracle integration for predicting network congestion and optimal transaction costs.
- Transaction finality verification mechanisms to confirm on-chain status after external submissions via other tools.
SKILL.md
Loading
Related Openclaw Skills
Self Protocol Identity Verification
A privacy-preserving identity integration that uses zero-knowledge proofs to verify passports and ID cards without exposing personal data.
Web Skills Protocol (WSP)
A protocol-driven approach for AI agents to discover and execute structured skills directly from websites instead of relying on fragile web scraping.
Git Commit Helper
An AI-powered utility for generating standardized git commit messages following the Conventional Commits specification.
ClankerKit
A comprehensive suite for AI agents to manage autonomous smart contract wallets, execute trades, and enforce spending policies on the Monad blockchain.
Openclaw Stock Skill
A high-performance financial data skill for Openclaw agents to query A-share stock prices, intraday bars, and valuation factors.
Gold Price Query Skill
A specialized browser automation tool that retrieves real-time bid, ask, and high/low prices for over 20 types of precious metals.
Featured*
