Polymarket AI 交易工具集（中文版）

基于 Claude Code Skill 构建的 Polymarket 预测市场全链路 AI 工具，覆盖从市场扫描到自动交易的完整工作流。已适配 OpenClaw / ClawHub 运行时环境。

版本日期：2026-05-10

工具总览

市场扫描 → 组合审查 → 下单交易 → 持仓监控 → 结算追踪 → 回测复盘
   ①          ⑤        ⑥⑦⑧        ④           ③           ②

#1-#8 的每个中文 skill 均有对应英文版（polymarket-market-pulse、back-testing-predmarket、poly-resolution-tracking、poly-position-monitor、portfolio-review-polymarket），功能相同。polymarket-trader（#9）为 OpenClaw 专项 Skill，SKILL.md 以中文编写。

各 Skill 详细介绍

1. polymarket-market-pulse-zh — 市场扫描与推荐

做什么： 从 Polymarket 扫描 800+ 活跃市场，AI 独立估算概率并与市场赔率对比，找出定价偏差最大的 Top 3 市场，给出具体的买入方向和仓位建议。

核心能力：

• 通过 Gamma API 拉取活跃市场（按交易量、流动性、上线时间、竞争度四维分页）
• 自动过滤垃圾市场（加密涨跌赌盘、即将到期、coin flip）
• 通过 scrape-market.ts 获取完整结算规则和 annotations（回退 WebFetch）
• 基于证据的结构化概率估算（证据登记表 + 交叉检查）
• Longshot Bias 扫描（专门寻找 Yes < 20% 的 No 侧 edge）
• 多结果市场 Top-N 偏差扫描
• 评论区校验（通过 scrape-market.ts 获取持仓者评论，回退 polymarket CLI）
• 订单簿深度分析（通过 polymarket CLI 获取数据）+ 1/4 凯利仓位管理
• 月化收益估算（EMR）
• 生成完整 Markdown 报告 + 追加推荐历史

脚本： fetch_markets.py（Gamma API 直连） fetch_orderbook.py（通过 polymarket CLI）

依赖： polymarket CLI (Rust)、scrape-market.ts（来自 api-trade-polymarket）

2. back-testing-predmarket-zh — 推荐回测

做什么： 评估所有历史推荐的表现。获取实时市价，计算每笔仓位盈亏，按类别和方向分析收益，生成策略反思报告。

核心能力：

• 解析 recommendation-history.md（全部历史推荐）
• 从 pulse 报告中提取事件 slug，通过 API 获取最新价格
• 计算已实现和未实现盈亏
• 分类分析（加密、地缘政治、体育、科技、政治）
• 方向分析（Buy Yes vs Buy No 对比）
• Edge 校准（AI 预估 edge vs 实际回报）
• AI 生成改进建议

脚本： backtest.py

3. poly-resolution-tracking-zh — 结算追踪

做什么： 追踪特定市场的结算数据源。获取结算条件，评估可追踪性，直接抓取数据源当前状态，持续终端监控。

核心能力：

• 解析结算规则，提取官方数据源 URL
• 评估数据源可追踪性（是否有公开 API/页面）
• 抓取数据源页面获取当前数值
• 颜色编码终端告警：分数变化、领先者变化、市场定价与数据偏差
• 支持持续监控或单次运行

脚本： fetch_event.py scrape_source.py monitor.py

4. poly-position-monitor-zh — 持仓监控

做什么： 实时监控钱包持仓，检测 5 类异常（价格波动、成交量异动、大额流入、巨鲸活动、挂单变化），通过终端、Telegram、邮件推送告警。

核心能力：

• 多钱包地址同时监控
• 5/15/60/240 分钟价格窗口监测
• 成交量暴涨暴跌检测
• 巨鲸地址活动追踪
• 挂单状态变化追踪（需 CLOB 认证）
• 四级告警（INFO / WARNING / ALERT / CRITICAL）
• Telegram Bot + 邮件通知
• 支持 cron 定时或持续运行

脚本： fetch_positions.py fetch_orders.py fetch_price_history.py fetch_market_activity.py alerters.py monitor.py

5. portfolio-review-polymarket-zh — 组合审查

做什么： 使用 EV 最大化框架审查当前持仓。获取实时仓位数据，通过网络搜索更新概率判断，对每个仓位给出 hold / sell / rotate 决策建议。

核心能力：

• 从 Data API 获取当前全部持仓
• 对每个持仓市场执行 Web 搜索更新概率
• 计算当前 edge 和预期收益
• Hold：edge 仍在 → 继续持有
• Sell：edge 消失或反转 → 建议卖出
• Rotate：发现更优机会 → 建议换仓

脚本： fetch_portfolio.py

6. polymarket-paper-trading — 纸上交易

做什么： 读取 market-pulse 报告推荐，交互式询问下单方式（市价/智能限价/自定义限价/跳过），执行资金管理与仓位计算，自动追踪持仓损益。

核心能力：

• 自动解析最新 pulse 报告中的推荐
• 交互式下单确认（不会自动执行）
• 资金管理和凯利仓位计算
• 持仓损益追踪
• 支持纸上交易（模拟）和实盘两种模式

脚本： parse_pulse.py fetch_prices.py check_orders.py place_order.ts

7. api-trade-polymarket — 实盘交易执行

做什么： Polymarket CLOB API 交易执行层。非交互式、指令驱动，支持买入/卖出（市价/限价）、撤单、余额查询、持仓查询、订单簿读取与智能定价。

核心能力：

• 买入/卖出（市价单 + 限价单）
• 智能定价（基于订单簿深度自动计算最优限价）
• 撤单
• USDC 余额查询
• 持仓查询
• 订单簿读取
• 可被其他 skill 调用（如 danger-auto-trade）

脚本： trade.ts balance.ts cancel.ts orderbook.ts scrape-market.ts

8. danger-auto-trade-polymarket — 全自动交易

做什么： 全自动交易编排器。无需人工确认，AI 自主完成市场扫描、概率评估、仓位计算和实盘下单。一句话触发完整交易链路。

核心能力：

• 调用 market-pulse 扫描市场
• AI 自主决策买入方向和仓位
• 自动调用 api-trade 执行下单
• 内置风控规则（单笔上限、总仓位上限、最小 edge 阈值）

参考： risk-controls.md

9. polymarket-trader — OpenClaw 交易终端（新增）

做什么： 面向 OpenClaw 运行时的 Polymarket 一体化交易终端。支持在 OpenClaw 对话中搜索盘口、查看订单簿深度、查看价格趋势、执行买入/卖出交易。

核心能力：

• 关键词搜索 Polymarket 市场（4 维度并发扫描 + 客户端精准匹配）
• 订单簿深度查看（best bid/ask、价差、挂单分布、智能定价）
• 价格趋势分析（15m/60m/240m/1440m 多窗口涨跌幅 + 方向判断）
• slug → token_id 自动解析
• 市价买单/卖单（FOK）+ 限价挂单（GTC）
• USDC 余额查询 + 持仓盈亏查看
• ClawHub 规范兼容（AgentSkills 协议 + {baseDir} 路径引用）
• 单行 JSON metadata，通过 requires.env 门控

脚本： search_markets.py price_trends.py parse_token_id.py orderbook.ts trade.ts balance.ts positions.ts

安装位置： ~/.openclaw/skills/polymarket-trader/

依赖： Python 3、Node.js、@polymarket/clob-client、ethers

可发布至 ClawHub，通过 clawhub skill publish 或 clawhub sync 发布，openclaw skills install polymarket-trader 安装。

工作流组合示例

日常扫描 + 下单

/polymarket-market-pulse-zh    → 获取 Top 3 推荐
/polymarket-paper-trading       → 交互式确认下单

持仓管理

/poly-position-monitor-zh      → 持续监控持仓异动
/portfolio-review-polymarket-zh → 定期审查持仓 EV
/poly-resolution-tracking-zh   → 追踪关键市场结算进度

绩效评估

/back-testing-predmarket-zh    → 回测历史推荐表现

全自动（高风险）

/danger-auto-trade-polymarket  → AI 全自动扫描 + 下单

OpenClaw 交易终端

/polymarket-trader              → 搜索盘口 → 看深度 → 看趋势 → 下单
python3 search_markets.py "关键词"  → 命令行直接搜索

技术栈

• 运行环境： Claude Code CLI + OpenClaw / AgentSkills 协议
• 语言： Python 3 (scripts) + TypeScript (trading)
• CLI 工具： polymarket CLI (Rust, v0.1.4) — 用于订单簿获取和评论回退
• API： Polymarket Gamma API / CLOB API / Data API
• 交易 SDK： @polymarket/clob-client v5.0.0
• 依赖： 大部分脚本仅需 Python 标准库；交易脚本需 py-clob-client
• 通知： Telegram Bot API + SMTP 邮件
• Skill 注册中心： ClawHub — polymarket-trader Skill

本版更新（2026-05-10）

• 新增： polymarket-trader Skill — 面向 OpenClaw 运行时的一体化交易终端，支持搜索盘口、查看订单簿深度、价格趋势分析、买入/卖出交易
• 适配： SKILL.md 按 ClawHub / AgentSkills 规范重构（单行 JSON metadata + {baseDir} 路径引用 + requires.env 门控）
• 新增脚本： search_markets.py — 4 维度并发扫描 + 客户端精准关键词匹配
• 新增脚本： price_trends.py — 多窗口价格涨跌幅分析 + 趋势方向判断（15m/60m/240m/1440m）
• 新增脚本： parse_token_id.py — Polymarket event slug → CLOB token ID 解析
• 环境： 交易凭证改为 POLYMARKET_PRIVATE_KEY / POLYMARKET_FUNDER_ADDRESS 环境变量（兼容 OpenClaw skill 门控）
• 安装位置： ~/.openclaw/skills/polymarket-trader/，可通过 clawhub skill publish 发布至 ClawHub

由 /poly-skill-snapshot 更新于 2026-05-10 09:30:00