核心用法
Polymarket Wallet X-Ray 是一款面向预测市场研究者的 forensic 分析工具，通过调用 Polymarket 公开 CLOB API 对任意钱包地址进行深度交易行为解剖。用户只需提供钱包地址，即可获取涵盖盈利能力、入场质量、机器人检测、套利边缘、风险画像五大维度的综合评估报告。
关键操作路径：
- 单钱包深度分析：
python wallet_xray.py 0x1234...abcd - 特定市场过滤：追加市场名称参数如
"Bitcoin" - 钱包对比模式：
--compare双钱包 head-to-head 对比 - JSON 输出：
--json便于程序化集成 - 采样加速：
--limit 100仅分析最近 100 笔交易
核心指标解析：
- Time Profitable（时间盈利占比）：衡量持仓期间处于盈利状态的时间比例，>80% 体现狙击手级纪律性
- Entry Quality（入场质量）：以基点衡量滑点，<20bps 为专家级限价单执行力
- Bot Detection（机器人检测）：通过交易间隔判定，<5秒高度疑似自动化程序
- Hedge Check（对冲检验）：YES+NO 持仓均价合计值，<$0.95 暗示潜在结构性套利边缘
显著优点
1. 零门槛数据获取：直接查询 Polymarket 公开 API，无需钱包授权或 API 密钥，降低隐私泄露风险
2. 权威方法论背书：完整实现 @thejayden 的鲸鱼解剖框架，指标设计经过实战验证
3. 多维度行为刻画：不仅看盈亏结果，更解析交易心理学（FOMO vs 纪律性）、执行模式（限价单质量）、资本效率（套利结构）
4. 教育导向设计：大量免责声明与场景限定，明确区分"学习模式"与"跟单风险"
5. 程序化友好：JSON 输出支持与量化策略的模块化集成
潜在缺点与局限性
1. 历史数据滞后性：依赖链上已确认交易，无法捕捉实时意图或未成交订单
2. 市场条件依赖：高 Time Profitable 可能源于特定事件周期（如大选行情），策略外推存在时变性
3. 幸存者偏差：工具默认分析"有交易记录的钱包"，零交易或已退出市场的失败者未被纳入分布
4. 套利边缘的伪信号：Hedge Check <$0.95 仅暗示理论边缘，实际利润受制于流动性、Gas 费用、结算延迟
5. 机器人误判风险：高频人类交易者（如手动套利者）可能被误分类，<5秒阈值过于绝对
适合人群
- 预测市场研究者：需要系统性理解链上交易行为模式的学术或行业分析师
- 策略开发者：希望从成熟交易者行为中提取特征工程输入的量化研究员
- 风控与合规：需识别异常交易模式（机器人集群、操纵嫌疑）的平台或监管关联方
- 进阶散户：具备独立判断能力、将分析结果作为决策参考而非直接信号的自营交易者
不适合： 寻求一键跟单、期望复制收益、缺乏概率思维与风险管理意识的投机新手
常规风险
| 风险类别 | 具体表现 | 缓释建议 |
|---------|---------|---------|
| 复制交易风险 | 过去 75% Time Profitable 不保证未来表现 | 仅用作为策略输入，独立回测验证 |
| 边缘衰减风险 | 公开识别的套利结构被多人复制后利润归零 | 快速迭代、小资金试错、不公开暴露头寸 |
| 数据解读风险 | JSON 指标脱离上下文导致误判 | 结合原始交易明细交叉验证 |
| API 依赖风险 | Polymarket 服务中断或速率限制 | 本地缓存、限流控制、备选数据源 |
| 合规边界风险 | 部分司法辖区可能将钱包分析视为未授权投资建议 | 明确标注教育研究用途、避免具体交易建议 |
> 重要原则：本工具输出的 recommendation 字段明确标注 "Not advice to copytrade"，用户需建立"分析→学习→独立决策"的认知链条，而非"分析→跟随"的捷径思维。