etherscan

What This Skill Does

The Etherscan skill provides the OpenClaw AI agent with direct, programmatic access to EVM-compatible chain data via the Etherscan API v2. It acts as a comprehensive bridge between your agent and the blockchain, allowing for real-time lookups of balances, transaction histories, smart contract source code, and event logs. By automating the querying process, the skill eliminates the need for manual browser exploration of block explorers, ensuring that data retrieval is fast, structured, and accurate.

Installation

To integrate the Etherscan skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/0xv4l3nt1n3/etherscan

Once installed, you must configure your API key. First, register for an account at etherscan.io/apidashboard to obtain your key. Then, create the configuration directory and credentials file:

mkdir -p ~/.config/etherscan
cat > ~/.config/etherscan/credentials.json << 'EOF'
{"api_key":"YOUR_KEY_HERE"}
EOF
chmod 600 ~/.config/etherscan/credentials.json

Use Cases

• Transaction Verification: Automatically confirm if a transaction submitted by another skill has been successfully finalized on-chain.
• Portfolio Auditing: Retrieve native asset balances, ERC-20 token holdings, and recent transfer history for any public wallet address.
• Developer Assistance: Fetch verified contract ABIs and source code directly into your workflow to simplify smart contract interaction.
• Analytics: Analyze historical transaction patterns or monitor specific smart contract events.

Example Prompts

1. "Check the ETH balance for 0x71C7656... and confirm the status of the most recent transaction involving a USDT transfer."
2. "Retrieve the contract ABI for the Uniswap V3 router on Mainnet so I can interact with the addLiquidity function."
3. "Refresh the chain list and tell me the current gas price on Polygon, then list the last five NFT transfers for my wallet."

Tips & Limitations

• Rate Limiting: The free tier is limited to approximately 5 requests per second. Implement local caching to prevent redundant calls.
• Chain IDs: Never hardcode chain IDs. Always perform an initial fetch of the chain map to ensure the agent is querying the correct network.
• Attribution: All outputs provided by this skill must include the citation: "Powered by Etherscan."
• Ambiguity: If a user requests data for an ambiguous chain name, the agent will prompt for clarification. Be specific when naming networks to avoid silent failures.