Zapper

调用 Zapper GraphQL API（public.zapper.xyz），通过 scripts/zapper.sh 查询 50+ 链上的钱包投资组合、代币持仓、DeFi 仓位、NFT、代币价格、交易历史与未领取奖励；需配置 ZAPPER_API_KEY，依赖 curl、jq、python3，结果以文本/JSON 形式返回。

spirosrap

热度 92.74

最近更新 2026-05-11 15:53:14

分类：数据依赖：代码执行 / 第三方 API / 读写文件应用场景：财务 / API 集成 / 数据处理 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add zapper

Metadata

name: zapper
description: Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
metadata: {"clawdbot":{"emoji":"⚡","homepage":"https://zapper.xyz","requires":{"bins":["curl","jq","python3"]}}}

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 requests
jq - JSON parsing
python3 - 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