zapper-api · jiayaoqijia - Agent Skill

01 前言 Front Matter

name: zapper-api
homepage: https://zapper.xyz
metadata: { "openclaw": { "emoji": "?", "requires": { "bins": [ "python3" ] }, "primaryEnv": "ZAPPER_API_KEY" } }
description: Query DeFi portfolios, token holdings, NFTs, transactions, and prices via Zapper API. Supports 50+ chains. Use when user asks about wallet balances, DeFi positions, NFT collections, token prices, or transaction history.

02 资源文件 6

参考文档_meta.json129 B
参考文档references/API.md4.7 KB
脚本scripts/zapper.py25.6 KB
参考文档skill-card.md2.3 KB
参考文档SOURCE.md238 B
参考文档TRUST.auto.yaml2.1 KB

03 SKILL.md 正文

Zapper API

Query DeFi portfolios, NFTs, and transactions across 50+ chains using Zapper's GraphQL API.

Setup

Get API key from Zapper Dashboard (free tier available)

Configure in ~/.config/zapper/addresses.json:

{
  "apiKey": "your-api-key",
  "wallets": [
    {"label": "Main", "address": "0x..."},
    {"label": "DeFi", "address": "0x..."}
  ]
}

Or set environment variable: export ZAPPER_API_KEY="your-api-key"

Commands

Command	Description	Example
`portfolio <address>`	Token + DeFi totals	`zapper.py portfolio 0x123...`
`tokens <address>`	Detailed token holdings	`zapper.py tokens 0x123...`
`apps <address>`	DeFi positions (LPs, lending, staking)	`zapper.py apps 0x123...`
`nfts <address>`	NFT holdings by value	`zapper.py nfts 0x123...`
`tx <address>`	Recent transactions (30 days)	`zapper.py tx 0x123...`
`price <symbol>`	Token price lookup	`zapper.py price ETH`
`claimables <address>`	Unclaimed rewards	`zapper.py claimables 0x123...`
`config`	Show configuration	`zapper.py config`

Options

Flag	Commands	Description
`--24h`	portfolio, tokens	Show 24h price changes
`--short`	portfolio	Output only total value
`--per-wallet`	portfolio	Show each configured wallet separately
`--json`	all	Output raw JSON
`--limit N`	most	Max items to display

Usage

# Portfolio summary
python3 scripts/zapper.py portfolio 0xADDRESS

# With 24h price changes
python3 scripts/zapper.py portfolio 0xADDRESS --24h

# Just total value
python3 scripts/zapper.py portfolio 0xADDRESS --short

# Per-wallet breakdown
python3 scripts/zapper.py portfolio --per-wallet

# Token holdings with prices
python3 scripts/zapper.py tokens 0xADDRESS --24h

# DeFi positions
python3 scripts/zapper.py apps 0xADDRESS

# NFT holdings
python3 scripts/zapper.py nfts 0xADDRESS

# Recent transactions
python3 scripts/zapper.py tx 0xADDRESS

# Token price
python3 scripts/zapper.py price ETH

# Unclaimed rewards
python3 scripts/zapper.py claimables 0xADDRESS

# JSON output
python3 scripts/zapper.py portfolio 0xADDRESS --json

Wallet Labels

Use configured wallet labels instead of addresses:

python3 scripts/zapper.py portfolio "Main"
python3 scripts/zapper.py tokens "DeFi"

Supported Tokens (price command)

ETH, WETH, USDC, USDT, DAI, WBTC, LINK, UNI, AAVE, MKR

Supported Chains

Ethereum, Base, Arbitrum, Optimism, Polygon, Solana, BNB Chain, Avalanche, zkSync, Linea, Scroll, Blast, and 40+ more.

Notes

Free tier API key available at zapper.xyz/developers
Rate limits apply - avoid rapid repeated requests
NFT valuations based on floor prices
Transaction history limited to 30 days

References

API.md - GraphQL query examples
Zapper Docs - Official API documentation

04 同仓库更多 Skills

jiayaoqijia/cryptoskill

recipe-performance

Diagnose a specific MetaMask user flow's real-app performance and Sentry critical-user-flow telemetry with deterministic mm-harness recipes. Use for CUF boundaries, cold/warm/background-resume behavior, latency regressions, lifecycle tags, duplicate or blocking network requests, long tasks, layout/paint cost, screen redraws, React rerenders, or browser trace analysis where tests alone cannot prove the real app.

★ 80

jiayaoqijia/cryptoskill

mexc-spot-websocket

MEXC Spot WebSocket workflows for public streams, protobuf handling, depth maintenance, listen keys, and private streams without exposing API keys.

★ 80

jiayaoqijia/cryptoskill

mexc-spot-rest

MEXC Spot REST workflows for public data, signed account requests, orders, wallet/admin actions, and secure signing without exposing API keys.

★ 80

jiayaoqijia/cryptoskill

mexc-futures-websocket

MEXC Futures WebSocket workflows for public streams, private account/order/position streams, ping/pong, subscriptions, and depth maintenance.

★ 80

jiayaoqijia/cryptoskill

0xklen-version-and-refresh-sanctions-lists

暂无简介

★ 80

jiayaoqijia/cryptoskill

verify-tests-cover-changed-lines

Use when a PR adds code that the existing suite may not exercise. Measures patch coverage — the share of newly changed lines hit by tests — before approving.

★ 80