A comprehensive CLI tool for querying multi-chain DeFi portfolios, NFT valuations, and transaction histories via the Zapper GraphQL API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install zapper-api
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 zapper-api 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 Zapper API?
The Zapper API skill provides a high-performance interface for interacting with on-chain data across more than 50 blockchain networks, including Ethereum, Base, Solana, and various Layer 2 solutions. This integration allows users to retrieve real-time data on token holdings, liquidity pool positions, lending protocols, and NFT collections with a single command. By utilizing this within the Openclaw Skills framework, developers can build sophisticated financial agents that monitor wallet health and market movements.
Beyond simple balance checks, the skill offers deep insights into DeFi 'apps' or positions, such as staked assets and unclaimed rewards. It simplifies the complexity of multi-chain accounting by aggregating data into a unified format, making it an essential tool for anyone needing programmatic access to the decentralized finance landscape.
Zapper API Use Cases
- Tracking total net worth across multiple hardware and software wallets.
- Auditing recent transaction history for tax or reconciliation purposes across 50+ chains.
- Monitoring NFT portfolio value based on real-time floor price data.
- Checking for claimable rewards or airdrops across various DeFi protocols.
- Automating daily portfolio performance reports with 24-hour price change metrics.
How Zapper API Works
- The user initiates a query using the zapper.py script, providing either a raw wallet address or a pre-defined label.
- The skill retrieves the required API credentials from environment variables or a local configuration file.
- A GraphQL request is sent to Zapper's endpoints to fetch specific data modules like tokens, apps, or transactions.
- The raw API response is processed to calculate totals, format prices, and handle multi-chain aggregation.
- The finalized data is presented in a human-readable table or exported as JSON for integration with other Openclaw Skills.
Zapper API Setup
First, obtain an API key from the Zapper Dashboard at zapper.xyz/developers. You can then configure the skill using an environment variable:
export ZAPPER_API_KEY="your-api-key"
Alternatively, create a configuration file at ~/.config/zapper/addresses.json to manage multiple wallets:
{
"apiKey": "your-api-key",
"wallets": [
{"label": "Main", "address": "0x..."}
]
}
Zapper API Data Schema & Taxonomy
The skill organizes blockchain data into logical categories for easy parsing. Below is the primary data structure mapping:
| Category | Description | Key Attributes |
|---|---|---|
| Portfolio | Unified balance summary | Total Value, 24h Change, Chain Breakdown |
| Tokens | Individual asset holdings | Symbol, Balance, Price (USD), Value |
| Apps | DeFi protocol positions | Protocol Name, Type (Staking/LP), Claimable Rewards |
| NFTs | Digital collectable data | Collection, Floor Price, Estimated Value |
| Transactions | Activity log (30 days) | Hash, Chain, Interaction Type, Timestamp |
Zapper API Advanced Features
- Multi-wallet support: Use the --per-wallet flag to aggregate data from all configured addresses simultaneously.
- Performance Tracking: Enable --24h to see price fluctuations and portfolio delta over the last day.
- Automation Friendly: The --json flag enables seamless data piping into other Openclaw Skills or custom data pipelines.
- Short Mode: Use --short to extract only the final valuation, ideal for quick status checks or minimalist dashboards.
- Broad Network Coverage: Native support for Ethereum, L2s like Arbitrum and Optimism, and non-EVM chains like Solana.
SKILL.md
Loading
Related Openclaw Skills
Zapper API
A powerful tool for querying DeFi portfolios, NFT holdings, and cross-chain transactions through the Zapper GraphQL API.
Academic Writing Refiner
A specialized AI tool designed to transform rough research drafts into publication-ready manuscripts for top-tier computer science conferences.
Crypto Research Framework
A comprehensive AI-driven investment research framework for generating professional crypto market reports and real-time monitoring.
LinkedIn Automator
An automated LinkedIn growth tool for content creation, scheduling, and performance tracking using browser-based workflows.
NEWMAN_SUPREME: Strategic Leadership Skill
A high-IQ strategic leadership engine designed for moral guidance, logical dominance, and Moltbook social integration.
Feishu File Sender
A specialized tool that enables AI agents to upload and send local files directly to Feishu chats using the Feishu OpenAPI.
METADATA
Featured*
