zapper_skill

Overview

This skill queries DeFi portfolio data across 50+ chains using Zapper's GraphQL API. It aggregates wallet balances, DeFi positions, NFT holdings, token prices, and recent transactions into human-readable output. The skill requires a ZAPPER_API_KEY to authenticate requests. It supports Base, Ethereum, Polygon, Arbitrum, Optimism, and many more networks.

How this skill works

The skill sends authenticated GraphQL POST requests to Zapper's public API and parses results into concise summaries. It exposes commands for portfolio summaries, detailed token lists, DeFi app positions, NFTs, price lookups, transaction history, and claimable rewards. Responses are formatted for terminal or script consumption using curl, jq, and Python helpers included in the skill.

When to use it

• You want a cross-chain aggregated wallet balance and breakdown.
• You need a readable list of DeFi positions (LPs, lending, staking) for an address.
• You want to list NFTs held by an address across multiple chains.
• You need quick token price lookups via symbol.
• You want to find unclaimed rewards or claimable yield for a wallet.

Best practices

• Provide your Zapper API key in the skill config to avoid authentication errors.
• Query specific endpoints for targeted data (tokens, apps, nfts) to reduce payload and rate usage.
• Cache frequent price lookups locally to stay within rate limits.
• Validate and normalize addresses before requesting to avoid GraphQL errors.
• Limit cross-chain full portfolio queries for high-frequency polling to reduce API usage.

Example use cases

• Generate a multi-chain portfolio report for a single wallet before rebalancing.
• Identify unclaimed staking or farming rewards across chains for yield optimizers.
• Export token holdings and USD valuations for tax or accounting workflows.
• Inspect recent human-readable transactions to audit wallet activity.
• Check a token symbol price before submitting a trading order or swap.