Wallet Metrics Skill

目的

为单个 Polymarket 钱包地址快速计算 8 个核心交易指标，无需运行完整的数据管道或数据库存储。

适用场景：

用户提供钱包地址（0x... 格式）
用户询问该地址的交易表现、指标或统计数据
需要快速获取最新指标（10-20 秒内完成）

不适用场景：

策略分类分析（使用 polymarket-analyst 技能）
排行榜扫描或多账户比较
批量处理或数据库存储（使用根目录 Python 脚本）

快速工作流程

当用户请求钱包指标时：

解析钱包地址
- 从用户输入中提取 0x 开头的以太坊地址
- 验证地址格式（42 字符，0x 前缀）

运行指标计算脚本

python .trae/skills/wallet-metrics/scripts/compute_wallet_metrics.py \
  --address <用户提供的地址> \
  --output /tmp/wallet_metrics.json

读取并展示结果
- 读取 /tmp/wallet_metrics.json
- 向用户展示结构化的指标数据
- 如果有警告（如交易数量少），向用户说明

计算的指标

脚本输出 8 个核心指标：

1. ROI (投资回报率)

定义： 总盈亏 / 成本基础
计算： Total PnL / Sum(BUY USD_Spent)
解读： 投资资本的百分比回报

2. Sharpe Ratio (夏普比率)

定义： 风险调整后收益
计算： Avg(daily PnL) / StdDev(daily PnL) × √365
解读： 每单位风险的收益，> 1.0 为良好

3. Profit Factor (获利因子)

定义： 总盈利 / 总亏损
计算： Gross Profit / Gross Loss（按市场聚合 PnL）
解读： 每亏损 1 美元赚取的美元数，> 2.0 为优秀

4. Max Drawdown (最大回撤)

定义： 权益曲线的峰谷跌幅
计算： (Peak - Trough) / Peak
解读： 最坏连续亏损期，< 0.2 为良好

5. Win Rate (胜率)

定义： 盈利交易占比
计算： Winning Trades / Total Trades
解读： 交易成功率，> 0.55 为良好

6. Position Size CV (仓位规模变异系数)

定义： 下注金额的一致性
计算： StdDev(BUY amounts) / Mean(BUY amounts)
解读： 仓位管理纪律性，< 1.0 为一致

7. HHI (市场集中度指数)

定义： 赫芬达尔-赫希曼指数
计算： Σ(market_share²)
解读： 市场分散度，< 0.25 为分散，> 0.5 为集中

8. Current Position Value (当前持仓价值)

定义： 所有开仓持仓的 USD 价值
计算： 从 Polymarket API 获取
解读： 当前风险敞口

输出格式

脚本输出纯 JSON 格式：

{
  "address": "0x...",
  "snapshot_date": "2026-03-02T12:34:56.789Z",
  "metrics": {
    "roi": 0.45,
    "sharpe_ratio": 1.23,
    "profit_factor": 2.15,
    "max_drawdown": 0.18,
    "win_rate": 0.62,
    "position_size_cv": 0.85,
    "hhi": 0.32,
    "current_position_value_usd": 3200.00
  },
  "summary": {
    "total_pnl": 12500.50,
    "total_trades": 145,
    "winning_trades": 90,
    "losing_trades": 55
  },
  "data_quality": {
    "trades_analyzed": 145,
    "date_range": "2024-01-15 to 2026-03-02",
    "warning": null
  }
}

字段说明：

metrics — 8 个核心指标（可能为 null 如果数据不足）
summary — 汇总统计（总盈亏、交易数、胜负场次）
data_quality — 数据质量信息（分析的交易数、日期范围、警告）

错误处理

地址未找到

如果钱包地址没有交易历史：

data_quality.warning 字段显示 "未找到交易历史"
metrics 和 summary 为空对象
向用户说明该地址可能未在 Polymarket 交易过

交易数量少

如果交易数 < 20：

data_quality.warning 字段显示警告信息
指标仍会计算，但向用户说明统计显著性可能不足

API 速率限制

脚本复用根目录 polymarket_metrics.py 的速率限制器：

Gamma API: 20 QPS
Data API: 15 QPS
CLOB API: 30 QPS
User PnL API: 8 QPS

如果遇到速率限制，脚本会自动重试（指数退避）。

部分指标缺失

某些指标可能为 null：

Sharpe Ratio / Max Drawdown — 如果 PnL 时间序列不可用
Position Size CV — 如果 BUY 交易 < 2 笔
HHI — 如果没有开仓持仓

向用户说明哪些指标不可用及原因。

执行时间

典型执行时间：10-20 秒

时间分布：

获取持仓数据：3-5 秒
获取 PnL 时间序列：2-4 秒
计算指标：1-2 秒
获取当前持仓价值：1-2 秒

与其他工具的区别

工具	用途	输出	执行时间
wallet-metrics (本技能)	单地址快速指标	8 个核心指标（JSON）	10-20 秒
polymarket-analyst	深度策略分析	25+ 指标 + 策略分类	30-60 秒
根目录 Python 脚本	批量处理 + 数据库	SQLite + Supabase	分钟级

示例对话

用户： "Get metrics for wallet 0x1234567890abcdef1234567890abcdef12345678"

Claude 工作流程：

识别钱包地址
运行 compute_wallet_metrics.py --address 0x... --output /tmp/metrics.json
读取 JSON 输出
向用户展示：
- ROI: 45%
- Sharpe Ratio: 1.23
- Profit Factor: 2.15
- Max Drawdown: 18%
- Win Rate: 62%
- Position Size CV: 0.85
- HHI: 0.32 (分散)
- Current Position Value: $3,200
- 总盈亏: $12,500.50
- 交易数: 145 笔（90 胜 / 55 负）

数据来源

所有数据来自 Polymarket 公开 API：

Gamma API — 持仓数据
Data API — 已平仓持仓
User PnL API — PnL 时间序列
CLOB API — 当前持仓价值

无需 API 密钥，所有端点均为公开访问。

限制

单地址查询 — 不支持批量或多账户比较
无策略分析 — 不进行策略分类或归因
无排行榜 — 不扫描或排名顶级交易者
无缓存 — 每次查询都获取最新数据（保证实时性）
JSON 输出 — 无人类可读的叙述性报告

如需上述功能，使用 polymarket-analyst 技能或根目录 Python 脚本。