Zapper Skill
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API.
Quick Start
Setup
Get your API key from Zapper Dashboard (free tier available):
mkdir -p ~/.clawdbot/skills/zapper
cat > ~/.clawdbot/skills/zapper/config.json << 'EOF'
{
"apiKey": "YOUR_ZAPPER_API_KEY"
}
EOF
Basic Usage
# Portfolio summary
scripts/zapper.sh portfolio 0x...
# Token holdings
scripts/zapper.sh tokens 0x...
# DeFi positions
scripts/zapper.sh apps 0x...
# NFT holdings
scripts/zapper.sh nfts 0x...
# Token price
scripts/zapper.sh price ETH
# Recent transactions
scripts/zapper.sh tx 0x...
# Unclaimed rewards
scripts/zapper.sh claimables 0x...
Commands
| Command | Description | Example |
|---|---|---|
portfolio <address> | Token balances + totals across all chains | zapper.sh portfolio 0x123... |
tokens <address> | Detailed token holdings | zapper.sh tokens 0x123... |
apps <address> | DeFi positions (LPs, lending, staking) | zapper.sh apps 0x123... |
nfts <address> | NFT holdings | zapper.sh nfts 0x123... |
price <symbol> | Token price lookup | zapper.sh price ETH |
tx <address> | Recent transactions (human-readable) | zapper.sh tx 0x123... |
claimables <address> | Unclaimed rewards | zapper.sh claimables 0x123... |
Supported Networks
Zapper supports 50+ chains including:
- Ethereum
- Base
- Polygon
- Arbitrum
- Optimism
- Avalanche
- BNB Chain
- zkSync
- Linea
- Scroll
- And more...
Use Cases
- Portfolio tracking: Aggregate all DeFi positions across chains
- Yield hunting: Check claimables and unclaimed rewards
- NFT portfolio: Track NFT holdings across marketplaces
- Transaction history: Human-readable on-chain activity
- Token prices: Quick price lookups
API Reference
All endpoints use POST https://public.zapper.xyz/graphql with GraphQL queries.
See references/api.md for full API documentation.
Requirements
curl- HTTP requestsjq- JSON parsingpython3- Formatting output- Zapper API key (free tier available)
Notes
- API key is required for all endpoints
- Rate limits apply based on your Zapper plan
- GraphQL queries allow flexible data selection