Zerion钱包数据查询

技能简介

Zerion API Skill 通过 MCP 连接器接入 Zerion 开发者平台，支持查询任意 EVM 地址的持仓组合、代币价格、NFT 资产、交易历史及盈亏统计。适用于加密资产管理、投资组合追踪、链上数据分析等场景。

能做什么

• 查询钱包总资产估值及分链分布
• 获取代币持仓明细（含 DeFi 质押、借贷、流动性挖矿）
• 检索完整交易历史并筛选操作类型
• 计算已实现/未实现盈亏（FIFO 法）
• 生成余额变化趋势图表
• 搜索代币实时价格与市场数据
• 汇总 NFT 持仓及估值

使用说明

1. 获取 API Key

访问 https://dashboard.zerion.io/ 注册并创建项目，复制生成的 API Key（格式如 zk_dev_xxx）。

2. 安装与配置

本技能为 MCP 远程服务，无需本地安装。在支持 MCP 的客户端中配置服务器地址：

mcp_servers: [
  { type: "url", url: "https://developers.zerion.io/mcp", name: "zerion-mcp" }
]

3. 认证流程

每次会话首次调用时，系统会提示输入 API Key。Key 仅保存在内存中，不会写入文件或日志。Zerion 采用 HTTP Basic Auth：用户名即 API Key，密码留空，需 Base64 编码后传入。

4. 典型调用示例

获取钱包组合概览：

GET /v1/wallets/{address}/portfolio?currency=usd&filter[positions]=no_filter

查询代币持仓（按价值降序）：

GET /v1/wallets/{address}/positions/?sort=-value&filter[trash]=only_non_trash

筛选交易记录：

GET /v1/wallets/{address}/transactions/?filter[operation_types]=trade&page[size]=50

获取 PnL 统计：

GET /v1/wallets/{address}/pnl

搜索代币价格：

GET /v1/fungibles/?filter[search_query]=ethereum&sort=-market_data.market_cap

输入与输出

见下方输入与输出表格。

项目	内容
输入	钱包地址（0x… 或 ENS）、Zerion API Key、查询类型、可选过滤参数
输出	资产估值、持仓明细、交易记录、PnL 统计、价格图表、代币市场数据
适用人群	加密货币持有者、DeFi 参与者、投资组合追踪工具开发者、链上数据分析师
不包含	私钥托管、交易执行、合约写入、跨链转账、实时告警推送

 

风险提示

• API Key 属于敏感凭证，切勿硬编码在代码或提交至版本仓库
• 每次会话需重新输入 Key，服务端不保留任何认证信息
• 免费额度有限，高频调用可能触发速率限制
• 链上数据存在延迟，大额交易建议二次核对
• NFT 估值依赖地板价估算，实际成交价格可能有偏差

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/vshamanov/zerion-api-skill-2/SKILL.md
来源类型：GitHub 开源技能仓库