核心用法
Zapper Skill 是一款命令行 DeFi 数据聚合工具，通过 Zapper 官方 GraphQL API 覆盖 50+ 主流公链（Ethereum、Base、Arbitrum、Optimism、Polygon 等）。用户仅需配置 ZAPPER_API_KEY 即可通过简洁的 shell 脚本查询多维度链上数据，包括：portfolio（总资产汇总）、tokens（代币持仓明细）、apps（DeFi 仓位如 LP/借贷/质押）、nfts（NFT 持仓）、price（代币实时价格）、tx（交易历史可读化）、claimables（待领取奖励）。
显著优点
- 跨链聚合能力：单地址一键聚合 50+ 链的资产数据，无需逐个链切换查询
- 数据维度全面：覆盖代币、DeFi 协议、NFT、交易历史、未认领收益五大核心场景
- 轻量易用：纯 shell 脚本实现，依赖仅 curl/jq/python3，零复杂环境配置
- 官方数据源：直接调用 Zapper 官方 API，数据时效性与准确性有保障
- 免费层级可用：支持免费 API 密钥，降低个人用户入门门槛
潜在缺点与局限性
- API 密钥依赖：所有功能强制要求 Zapper 账户与 API Key，存在服务商单点依赖
- 速率限制风险：免费层级存在调用频率限制，高频查询或批量分析场景受限
- 非自托管架构：数据流经 Zapper 中心化服务器，隐私敏感用户需谨慎
- GraphQL 学习成本：高级自定义查询需理解 GraphQL 语法，对纯新手不够友好
- 无实时推送：纯请求-响应模式，不支持链上事件实时订阅
适合人群
- DeFi 活跃用户：需定期监控多链资产分布与未认领收益
- 投资组合追踪者：希望非托管方式聚合跨链持仓，替代部分 CEX 记账功能
- 开发者/分析师：快速验证地址资产数据，辅助链上研究或脚本自动化
- NFT 收藏者：跨市场追踪 NFT 持仓与估值
常规风险
- API 密钥泄露风险：config.json 明文存储密钥，共享环境需严格权限管理
- 第三方服务可用性：Zapper API 故障或政策变更将直接影响工具可用性
- 地址隐私暴露：向 Zapper 服务端提交地址存在潜在链上关联分析风险
- 数据准确性依赖：Zapper 的协议解析覆盖率与价格源偏差可能影响资产估值
- 脚本注入风险：shell 脚本处理外部地址输入时需防范特殊字符注入（当前实现依赖 jq 过滤，风险可控）