Polymarket 命令中心

实时获取 OpenClaw 的预测市场数据 —— 无需 API 密钥。

命令

trending

获取 Polymarket 上按交易量排名前 10 的活跃市场。

trending
trending [类别]

示例：

• trending — 所有市场
• trending politics — 政治类预测市场
• trending crypto — 加密货币市场
• trending sports — 体育博彩市场

输出内容：

• 市场问题（截断至 65 个字符）
• 主要结果概率（Yes/No 分割）
• 近 24 小时交易额
• 市场关闭剩余天数
• 市场标识符（用于详细查询）

支持类别： Gamma API 支持 Polymarket 任意标签。常见类别包括：politics、crypto、sports、elections、entertainment、economics。

odds [slug]

通过标识符或关键词获取特定市场的详细赔率。

odds [slug]
odds [搜索词]

示例：

• odds will-trump-win-2024 — 精确匹配标识符
• odds bitcoin — 搜索包含“bitcoin”的市场
• odds fed rate cut march — 多关键词搜索

输出内容：

• 完整的市场问题
• 各结果的概率，附带可视化条形图（█ 表示填充，░ 表示空）
• 近 24 小时交易额
• 市场流动性
• 关闭日期（绝对时间 + 剩余天数）
• 市场描述（截断至 200 字符）
• 实时 CLOB 中点价（如有）
• 直接跳转至 Polymarket 官方页面的链接

搜索行为： 若精确标识符未找到，将在客户端对市场问题、标识符和描述进行文本搜索。

search [查询]

在 100 个活跃市场中按文本搜索。客户端本地过滤，实现即时响应。

search [查询]
search [关键词1] [关键词2] [关键词3]

示例：

• search bitcoin — 单关键词搜索
• search bitcoin 100k — 所有关键词必须同时匹配
• search fed interest rate — 多词组合搜索
• search election 2024 — 词组搜索

输出内容：

• 最多 8 个匹配的市场
• 每个市场的标题、Yes 概率、交易额、标识符

搜索逻辑： 查询中的所有关键词必须出现在市场问题、标识符或描述中（不区分大小写）。搜索结果缓存 2 分钟。

watchlist

查看已配置关注列表中的市场赔率。

watchlist

输出内容：

• 关注列表中每个市场的当前赔率
• 各市场的交易额与关闭日期

配置方式： 将市场标识符添加至 ~/.openclaw/state/polymarket_watchlist.json：

{
  "slugs": [
    "will-trump-win-2024",
    "bitcoin-above-100k",
    "fed-rate-cut-march-2026"
  ]
}

或通过 ~/.openclaw/config.yaml 配置：

polymarket:
  watchlist:
    - will-trump-win-2024
    - bitcoin-above-100k
    - fed-rate-cut-march-2026

数据源与架构

无需 API 密钥

Polymarket 命令中心仅使用公开接口：

• Gamma API (https://gamma-api.polymarket.com) — 市场元数据、结果、定价
• CLOB API (https://clob.polymarket.com) — 实时买卖中间价

无需认证，无需凭证，纯 HTTP 请求。

线程安全缓存

内存缓存，自动过期管理：

• TTL（生存时间）： 默认 120 秒（trending 为 180 秒，search 为 120 秒）
• 最大缓存条目数： 100 条（超出时采用 LRU 策略淘汰最久未使用项）
• 线程安全： 使用可重入锁，支持并发请求
• 智能失效： 过期条目在下次访问时自动清理

CLOB 中点价

在赔率详情中显示的“实时中点价”来自 CLOB（中央限价订单簿）—— Polymarket 的链上订单簿。该值反映真实的实时买卖价差。若 CLOB 数据不可用，将优雅降级处理。

输出格式

趋势市场

🔮 Polymarket 趋势市场 (crypto)

1. Will Bitcoin reach $100K by end of 2026?
   Yes: 72% | Vol: $2.5M | Closes: 45d
   📎 bitcoin-above-100k

2. Ethereum price above $5K on March 31 2026?
   Yes: 48% | Vol: $1.2M | Closes: 22d
   📎 ethereum-5k-march

💡 Say 'odds [slug]' for detailed odds on any market

详细赔率

🔮 Will Trump win the 2024 US Presidential Election?

Yes: 68% ████████████░░░░░░░░
No:  32% ██████░░░░░░░░░░░░░░

📊 Volume: $18.5M | Liquidity: $4.2M
📅 Closes: 2026-11-05 (240 days)

📝 Prediction market for the outcome of the 2024 U.S. Presidential election...

💹 Live midpoint: 67.8%

🔗 polymarket.com/event/will-trump-win-2024

搜索结果

🔍 Polymarket 搜索: 'bitcoin 100k'

1. Will Bitcoin reach $100K before end of 2026?
   Yes: 72% | Vol: $2.5M
   📎 bitcoin-above-100k

2. Bitcoin price prediction: $100K to $110K range by March 2026?
   Yes: 58% | Vol: $850K
   📎 bitcoin-100k-110k-range

💡 Say 'odds [slug]' 查看任一市场的详细信息

关注列表

👀 Polymarket 关注列表

🔮 Will Trump win the 2024 US Presidential Election?
   Yes: 68% | Vol: $18.5M

🔮 Will Bitcoin reach $100K by end of 2026?
   Yes: 72% | Vol: $2.5M

🔮 Will Fed cut rates in March 2026?
   Yes: 64% | Vol: $3.1M

响应状态码

缓存行为

• 首次调用： 触发 Polymarket API 请求，结果存入缓存
• 重复调用（在 TTL 内）： 立即返回缓存数据
• 过期数据（超过 TTL）： 缓存失效，触发新 API 请求
• 内存限制： 最多 100 条缓存项；满时按最久未使用原则淘汰
• 线程安全： 支持并发请求（如早间简报 + 用户查询）

示例时间线：

14:30:00 - 用户: "trending"
           → API 请求 → 缓存设置（有效期至 14:32:00）
           → 返回 10 个市场数据

14:30:45 - 用户: "trending"
           → 缓存命中（已过期 28 秒）
           → 立即返回相同数据

14:32:15 - 用户: "trending"
           → 缓存未命中（已过期 15 秒）
           → 触发 API 请求 → 缓存更新（有效期至 14:34:15）
           → 返回最新数据

配置（可选）

Skill: Polymarket Command Center

Version: 1.1.0

Chunk: 2/2

所有命令无需任何配置即可使用。可选设置位于 ~/.openclaw/config.yaml 中：

polymarket:
  enabled: true
  watchlist:
    - will-trump-win-2024
    - bitcoin-above-100k
    - fed-rate-cut-march-2026
  categories:
    - politics
    - crypto
    - sports

无需配置 — 默认设置适用于所有命令。

支持的市场类别

Gamma API 返回的市场包含以下常见分类：

• politics — 选举、政治结果
• crypto — 比特币、以太坊、山寨币、区块链相关
• sports — NFL、NBA、英超联赛、奥运会赛事
• entertainment — 电影、颁奖典礼、名人新闻
• economics — 美联储利率、通货膨胀、就业数据
• weather — 极端天气事件
• science — 太空探索、重大科学突破
• business — 科技公司IPO、并购、财报表现

自定义标签也可能出现；Gamma API 会返回所有已配置的标签。

实现细节

HTTP 客户端

• User-Agent: OpenClaw-Polymarket/1.0
• 超时时间：每请求 10 秒
• Accept: application/json
• 不使用 Cookie；无状态请求

错误处理

• 网络超时 → 平滑提示“无法连接到 Polymarket”
• JSON 格式错误 → 忽略，回退至空结果
• Unicode 解码错误 → 静默处理

结果解析

Polymarket API 返回的结果为字符串化的数组格式。Command Center 会自动检测格式（字符串或数组），并正确解析两种形式。

二元市场：["Yes", "No"] 选项，对应价格为 [yes_price, no_price]

多分类市场：["Trump", "Harris", "RFK Jr"] 等选项，附带相应价格。

OpenClaw 生态系统集成

作为预测市场交易栈的只读 Polymarket 数据层。

安装完整套件：

clawhub install kalshalyst kalshi-command-center polymarket-command-center prediction-market-arbiter xpulse portfolio-drift-monitor market-morning-brief personality-engine

示例工作流

监控加密货币市场情绪

1. trending crypto        # 查看按成交量排名的顶级加密市场
2. odds bitcoin-above-100k  # 获取 BTC 价格突破 10 万美元的概率详情
3. search ethereum        # 搜索以太坊相关市场
4. watchlist             # 查看已配置的关注列表

跟踪选举预测

1. trending politics     # 查看最热门的政治类市场
2. odds will-trump-win-2024  # 查看详细概率及 CLOB 中点价
3. search harris         # 搜索相关市场
4. 添加至关注列表      # 监控概率变化

发现潜在机会

1. trending               # 所有市场趋势
2. search [小众关键词]   # 寻找被低估的市场
3. odds [slug]           # 检查交易量与流动性
4. 比较 CLOB 中点价与显示概率

限制与注意事项

• 只读模式：不支持交易，不支持账户创建
• 仅公开数据：无法获取私有市场信息
• Gamma API 限制：单次请求最多返回约 100 个市场（用于搜索）
• CLOB 中点价：部分市场可能不可用（提供平滑回退）
• 价格显示：始终以小数概率形式展示（如 0.68 = 68%）
• 已关闭市场：不会出现在趋势或搜索结果中；在 Polymarket 上归档

故障排查

版本历史

v1.0.0 (2026-03-09)

• 初始发布
• 支持命令：trending、odds、search、watchlist
• 线程安全缓存，TTL 120 秒
• 集成 CLOB 中点价
• 无需 API Key
• 100% 只读（无交易功能）

反馈与问题

发现 Bug？有功能建议？想分享使用成果？

• GitHub Issues: [github.com/kingmadellc/openclaw-prediction-stack/issues](https://github.com/kingmadellc/openclaw-prediction-stack/issues)
• X/Twitter: [@KingMadeLLC](https://x.com/KingMadeLLC)

属于 OpenClaw 预测市场套件 — ClawHub 上首个预测市场技能集合。