钱包投资组合分析
目标:为EVM钱包提供简洁的资产分布分析和风险评估。
输入
wallet_address(必填):EVM地址(0x...)
数据来源
主要:通过 zerion-portfolio.py 调用 Zerion API
# 获取所有资产
python3 zerion-portfolio.py <address>
# 仅获取 DeFi 头寸
python3 zerion-portfolio.py <address> --only-defi
环境变量:必须设置 ZERION_API_KEY。若未设置,请前往 https://www.zerion.io/api 获取 API 密钥。
执行流程
第一步:验证输入
1. 检查地址格式:0x + 40 位十六进制字符
2. 若格式无效:退出并提示错误信息
第二步:获取投资组合数据
# 执行 Zerion 投资组合脚本
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <address>
处理边界情况:
- 空钱包 → 报告“钱包为空”
- API 请求失败 → 退出并报错,无法继续
- 零值头寸 → 跳过
第三步:对资产进行分类
按类型分组:
原生代币:ETH、MATIC、BNB 等
稳定币:USDC、USDT、DAI、USDS
DeFi 头寸:具有 protocol 属性且 position_type != 'wallet'
其他代币:其余所有
按类别追踪总价值,计算分布百分比
第四步:识别 DeFi 协议
对于每个 DeFi 头寸:
1. 从 attributes.protocol 中提取协议名称
2. 识别头寸类型(借贷/质押/流动性提供等)
3. 记录头寸价值及其占组合的百分比
4. 为风险评估创建唯一协议列表
第五步:风险评估(仅限 DeFi 协议)
对于每个识别到的协议:
A. 获取协议数据(并行请求):
- DefiLlama API:curl "https://api.llama.fi/protocol/{slug}"
- 提取 TVL、支持的链、审计信息、分类
B. 检查近期安全事件:
- 在 rekt.news 上搜索协议名称
- 仅关注过去 90 天内的事件
- 记录任何安全事件
C. 计算风险评分:
风险评分 = 基础分 + 事件分 + 审计分 + TVL 趋势分
因子:
- 无审计:+5
- 近期安全事件(90 天内):+5
- TVL 跌幅 >50%(30 天):+3
- TVL 跌幅 20-50%:+2
- 新协议(上线 <6 个月):+2
- 单次审计:+1
- 多次审计:-2
- 经市场考验(运行 >1 年):-1
D. 分配风险等级:
- 评分 > 7:🔴 高风险
- 评分 4-7:🟡 中等风险
- 评分 < 4:🟢 低风险
E. 错误处理:
- DefiLlama 调用失败:将 TVL 标记为“N/A”,继续执行
- Rekt.news 不可用:将安全事件状态标记为“未知”
已知安全协议(自动 🟢):
- Aave V2/V3、Uniswap V2/V3、Compound V2/V3
- Lido、Curve、MakerDAO/Sky
第六步:生成报告
按照下方“输出格式”部分输出结构化的 Markdown 报告。
输出格式
1)摘要
钱包地址:0x...
总价值:$X,XXX USD
支持的链:Ethereum、Arbitrum、Base
2)资产分布
资产构成:
• 原生代币:$XXX(XX%)
• 稳定币:$XXX(XX%)
• DeFi 头寸:$XXX(XX%)
• 其他代币:$XXX(XX%)
3)主要头寸
按价值排序的所有头寸表格:
协议/钱包 | 头寸类型 | 价值 | 占组合比例
----------------|---------------|-------|------------
钱包资产 | 钱包 | $XXX | XX%
协议 A | 借贷 | $XXX | XX%
协议 B | 流动性提供(LP) | $XXX | XX%
4)主要持仓(占组合比例 >2%)
表格格式:
链 | 资产 | 类型 | 数量 | 价值 | 占组合比例
------|-------|------|--------|-------|------------
5)DeFi 敞口
仅显示 🟡 中等风险或 🔴 高风险的协议(跳过 🟢 低风险):
协议名称(链)
• 头寸价值:$XXX(占组合 XX%)
• 头寸类型:借贷/质押/流动性提供(LP)等
• 风险等级:🟡/🔴
• TVL:$XXX(来自 DefiLlama)
• 审计:是/否(审计方名称)
• 近期问题:无 / [描述]
若所有协议均为低风险,则输出:“所有 DeFi 头寸均位于低风险协议中(🟢)”
6)风险总结
高优先级:
- 列出所有 🔴 高风险头寸及建议措施
中优先级:
- 列出所有 🟡 中等风险头寸及注意事项
总体评估:
- 一段摘要
- 风险评分:低/中/高
7)数据来源
- Zerion API:投资组合数据(时间戳)
- DefiLlama:协议 TVL 和信息
- Rekt.news:安全事件
- [其他使用的来源]
质量标准
简洁性:
- 报告总字数:200-400 字(不含表格)
- 仅关注可操作洞察
- 无填充内容或泛泛而谈
准确性:
- 所有数据必须附带时间戳
- 所有价值必须来自真实 API 调用
- 风险评估必须引用具体证据
实用性:
- 突出显示占组合比例 >5% 的头寸
- 立即标记任何高风险敞口
- 必要时提供明确的下一步操作
更新频率
- 风险数据库:每月通过 rekt.news 更新
- 已知协议:随着新主流协议上线而更新
- 审计状态:每季度验证
最后更新:2026-02-05