zapper-api

What This Skill Does

The zapper-api skill for OpenClaw integrates the robust Zapper GraphQL API into your local terminal environment. It allows you to query comprehensive data across 50+ blockchain networks, including Ethereum, Base, Arbitrum, Optimism, Solana, and more. This tool serves as a unified interface for tracking your entire Web3 financial footprint. Whether you need to monitor liquid token balances, analyze complex DeFi positions such as liquidity pools and lending protocols, track NFT collection floor values, or audit your recent transaction history, this skill provides instant, actionable insights. By supporting local configuration through a Zapper API key, it enables you to manage multiple wallet addresses under human-readable labels, streamlining your multi-chain portfolio management.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/zivhm/openclaw-zapper-api. Once installed, acquire a free API key from the Zapper Developer Dashboard. You can configure your environment by editing the configuration file located at ~/.config/zapper/addresses.json to include your API key and map your wallet addresses to friendly labels like "Main" or "DeFi". Alternatively, you may export your credentials as an environment variable by running export ZAPPER_API_KEY="your-api-key".

Use Cases

This skill is ideal for DeFi power users, developers, and crypto investors who need to maintain visibility over fragmented assets across different chains. It is particularly useful for portfolio rebalancing, tax preparation, performance tracking, and troubleshooting protocol interactions. Instead of switching between multiple block explorers or dashboard sites, you can pull consolidated reports directly into your CLI workflow.

Example Prompts

1. "What is the total valuation of my Main wallet, and how has it changed in the last 24 hours?"
2. "Show me all my active DeFi positions and liquidity pools on Arbitrum for my DeFi wallet."
3. "List my top 5 most valuable NFTs across all connected chains."

Tips & Limitations

• Rate Limits: The Zapper API imposes rate limits. Avoid running automated scripts in tight loops to prevent temporary IP bans.
• Data Freshness: Transaction history is currently limited to the last 30 days. For long-term archival, consider piping output to a local database.
• NFT Valuation: NFT values are calculated based on floor prices. Rare or unique items may not be reflected at their full market value.
• Security: Ensure your addresses.json file has appropriate filesystem permissions (e.g., chmod 600) as it contains your API key and address mappings.