{/* 本页面由 website/scripts/generate-skill-docs.py 从技能 SKILL.md 自动生成。请编辑源 SKILL.md 而非本页面。 */}
Polymarket
查询 Polymarket：市场、价格、订单簿、历史。
技能元数据
| 来源 | 内置（默认安装） |
| 路径 | skills/research/polymarket |
| 版本 | 1.0.0 |
| 作者 | Hermes Agent + Teknium |
| 平台 | linux, macos, windows |
参考：完整 SKILL.md
:::info 以下是此技能被触发时 Hermes 加载的完整技能定义。这是技能激活时代理所看到的指令。 :::
Polymarket — 预测市场数据
使用 Polymarket 的公共 REST API 查询预测市场数据。所有端点均为只读，无需任何认证。
参见 references/api-endpoints.md 获取包含 curl 示例的完整端点参考。
使用时机
- 用户询问预测市场、投注赔率或事件概率
- 用户想知道”X 发生的概率是多少？”
- 用户特别询问 Polymarket
- 用户想要市场价格、订单簿数据或价格历史
- 用户要求监控或跟踪预测市场变动
关键概念
- 事件（Events） 包含一个或多个市场（Markets）（一对多关系）
- 市场（Markets） 是二元结果，Yes/No 价格在 0.00 到 1.00 之间
- 价格即概率：价格 0.65 意味着市场认为 65% 的可能性
outcomePrices字段：JSON 编码数组，如["0.80", "0.20"]clobTokenIds字段：两个令牌 ID [Yes, No] 的 JSON 编码数组，用于价格/订单簿查询conditionId字段：用于价格历史查询的十六进制字符串- 交易量以 USDC（美元）计
三个公共 API
- Gamma API 位于
gamma-api.polymarket.com— 发现、搜索、浏览 - CLOB API 位于
clob.polymarket.com— 实时价格、订单簿、历史 - Data API 位于
data-api.polymarket.com— 交易、未平仓量
典型工作流程
当用户询问预测市场赔率时：
- 搜索 — 使用 Gamma API 的 public-search 端点，使用他们的查询词
- 解析 — 提取事件及其嵌套的市场
- 展示 — 市场问题、当前价格（百分比形式）和交易量
- 深入探究 — 如果被问到，使用 clobTokenIds 获取订单簿，使用 conditionId 获取历史
展示结果
将价格格式化为百分比以提高可读性：
- outcomePrices
["0.652", "0.348"]变为 “Yes: 65.2%, No: 34.8%” - 始终显示市场问题和概率
- 可用时包含交易量
示例："X 会发生吗？" — 65.2% Yes（$1.2M 交易量）
解析双重编码字段
Gamma API 将 outcomePrices、outcomes 和 clobTokenIds 作为 JSON 字符串返回在 JSON 响应内（双重编码）。使用 Python 处理时，使用 json.loads(market['outcomePrices']) 解析以获取实际数组。
速率限制
较为宽松——正常使用不太可能达到：
- Gamma：每 10 秒 4,000 请求（通用）
- CLOB：每 10 秒 9,000 请求（通用）
- Data：每 10 秒 1,000 请求（通用）
限制
- 此技能为只读——不支持下单交易
- 交易需要基于钱包的加密认证（EIP-712 签名）
- 某些新市场可能有空价格历史
- 交易受地理限制，但只读数据在全球范围内可访问