核心用法
Zapper API 技能通过 Python 脚本封装 Zapper 官方 GraphQL API，提供链上资产全景查询能力。主要功能覆盖四大维度：
1. 资产总览：portfolio 命令聚合代币+DeFi 头寸计算总净值，支持 --24h 查看日内涨跌、--per-wallet 多钱包分组；
2. 明细穿透：tokens 列持仓币种及金额，apps 展示 LP、借贷、质押等 DeFi 仓位，nfts 按地板价估算 NFT 持仓价值；
3. 动态追踪：tx 拉取近 30 天交易流水，claimables 扫描未领取的空投或奖励；
4. 快捷查询：price 支持 ETH/USDC 等主流币实时价格，config 管理本地钱包标签映射。
配置方式灵活，支持环境变量 ZAPPER_API_KEY 或 JSON 配置文件，可通过标签（如 "Main"）替代冗长地址。
显著优点
- 多链聚合：覆盖 Ethereum、Base、Arbitrum、Solana 等 50+ 链，无需逐链切换浏览器；
- DeFi 原生：深度解析 Uniswap、Aave、Lido 等协议仓位，自动识别 LP 代币与奖励；
- 开发友好：提供
--json原始数据输出，便于二次处理或接入自动化报表； - 成本可控：Zapper 官方提供免费 API 层级，个人用户可零成本起步。
局限与风险
- 数据时效：交易历史仅保留 30 天，长期回测需额外索引服务；NFT 估值依赖地板价，高稀有度单品存在偏差；
- 外部依赖：Zapper API rate limit 与稳定性直接影响技能可用性，高峰期可能受限；
- 隐私暴露：需提交钱包地址至第三方服务，敏感地址需谨慎；API Key 本地存储存在泄露风险；
- 功能边界：暂不支持模拟交易、签名操作或合约交互，纯只读查询工具。
适合人群
DeFi 活跃用户、投资组合追踪者、DAO 财库管理员、税务报告需求者，以及需要快速审计多链仓情的开发者。
常规风险
- API Key 泄露：建议配置最小权限，避免使用主钱包绑定的 Key；
- 价格波动误读：24h 涨跌幅为时点数据，不构成投资建议；
- 第三方中断：Zapper 服务策略调整可能导致功能失效，需关注官方公告。