zapper

What This Skill Does

The Zapper skill acts as a powerful gateway to the Zapper GraphQL API, allowing your OpenClaw agent to aggregate complex DeFi data from over 50 different blockchain networks. Instead of manually navigating block explorers or juggling multiple portfolio trackers, this skill enables direct queries for wallet balances, specific DeFi positions, NFT holdings, real-time token pricing, and historical transaction logs. It translates raw on-chain data into actionable insights, making it an essential component for any user looking to monitor assets across the fragmented multi-chain ecosystem including Ethereum, Base, Polygon, and Arbitrum.

Installation

Installation is streamlined via the OpenClaw hub. First, retrieve your API key from the Zapper Dashboard. Once you have the key, install the skill using the command: clawhub install openclaw/skills/skills/spirosrap/zapper. Following installation, initialize the configuration by creating the ~/.clawdbot/skills/zapper/config.json file and inserting your API key. Ensure that curl, jq, and python3 are installed on your system, as these dependencies are required to parse and format the data returned by the GraphQL endpoints.

Use Cases

This skill is highly effective for sophisticated users who manage complex portfolios. Use it to keep an eye on yield farming positions, track liquidity pool shares, and monitor lending protocols. It is particularly useful for users needing to identify unclaimed staking rewards across multiple chains at once. Furthermore, it serves as a robust tool for security-conscious users who want to verify their NFT holdings or review recent wallet transaction history to detect unauthorized activity.

Example Prompts

1. "Check my total portfolio value across all chains and list my top 3 largest DeFi positions."
2. "Do I have any unclaimed rewards currently sitting in any of my active liquidity pools on Base or Arbitrum?"
3. "Show me the last 5 transactions for this wallet address and confirm if I hold any NFTs from the Bored Ape collection."

Tips & Limitations

Be mindful that the Zapper API enforces rate limits based on your current tier. Frequent, automated polling of portfolio data should be managed to avoid interruptions. Because the skill relies on the Zapper GraphQL interface, the accuracy of the data is dependent on Zapper’s indexing speed. Always ensure your API key is kept secure and not hardcoded into scripts that might be shared publicly. If you experience unexpected null values, check that the requested chain is explicitly supported by Zapper's platform and that your API key is correctly authenticated in the configuration file.