Zapper — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

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.

开发与 DevOps

作者：Spiros Raptis @spirosrap

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.0.0

统计：⭐ 1 · 1.8k · 8 current installs · 9 all-time installs

⭐ 1

安装量（当前） 9

🛡 VirusTotal ：良性 · OpenClaw ：可疑

Package：zapper

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：可疑

OpenClaw 评估

The skill largely does what it claims (calls Zapper's GraphQL API), but there are several mismatches and metadata omissions (API key handling, declared requirements) that warrant caution before installing.

目的

The script implements GraphQL calls to https://public.zapper.xyz and returns portfolio, tokens, NFTs, txs, prices, and claimables — which matches the skill description. However, the registry metadata lists no required credentials while SKILL.md and the script require a Zapper API key stored in ~/.clawdbot/skills/zapper/config.json. Also the declared required binaries include jq but the shipped script uses python3 for JSON parsing and does not …

说明范围

Runtime instructions and the shell script confine operations to: reading a config file under the user's home (~/.clawdbot/skills/zapper/config.json), making POST requests to public.zapper.xyz, and formatting output locally. The instructions do not direct the agent to read arbitrary system files, other environment variables, or send data to unexpected endpoints.

安装机制

There is no installer — this is instruction + a script bundled with the skill. That is low-risk compared with fetching and executing remote code. The included script is readable and uses standard tools (curl, python3).

证书

The skill needs a Zapper API key, but the registry metadata did not declare a primaryEnv or required env vars — the key is instead stored in a local config file. This mismatch is a transparency issue: the skill requires a secret but the platform metadata doesn't list it. No other unrelated credentials are requested.

持久

The skill is not marked always:true (so it won't be forced into every agent), but disable-model-invocation is not set — meaning the model may be allowed to invoke the skill autonomously. If you allow model-autonomy, the skill (and any stored API key) could be used without further prompts. The skill does not request elevated system privileges or unusual config paths.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Zapper」。简介：Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when …。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/spirosrap/zapper/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
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](https://dashboard.zapper.xyz/settings/api) (free tier available):

```bash
mkdir -p ~/.clawdbot/skills/zapper
cat > ~/.clawdbot/skills/zapper/config.json << 'EOF'
{
  "apiKey": "YOUR_ZAPPER_API_KEY"
}
EOF
```

### Basic Usage

```bash
# 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](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