跳到主要内容

Polymarket

查询 Polymarket：市场、价格、订单簿、历史。

技能元数据​

来源内置（默认安装）
路径skills/research/polymarket
版本1.0.0
作者Hermes Agent + Teknium

参考：完整 SKILL.md​

信息

以下是该技能被触发时 Hermes 加载的完整技能定义。这是 Agent 在技能激活时看到的指令。

Polymarket — 预测市场数据

使用 Polymarket 的公共 REST API 查询其预测市场数据。 所有端点均为只读，无需任何身份验证。

请参阅 references/api-endpoints.md 获取包含 curl 示例的完整端点参考。

何时使用​

  • 用户询问关于预测市场、投注赔率或事件概率的问题
  • 用户想知道“X 发生的概率是多少？”
  • 用户特别询问 Polymarket
  • 用户需要市场价格、订单簿数据或价格历史
  • 用户要求监控或跟踪预测市场动态

关键概念​

  • 事件 包含一个或多个 市场（一对多关系）
  • 市场 是二元结果，Yes/No 价格在 0.00 到 1.00 之间
  • 价格即概率：价格 0.65 意味着市场认为有 65% 的可能性
  • outcomePrices 字段：JSON 编码的数组，例如 ["0.80", "0.20"]
  • clobTokenIds 字段：JSON 编码的两个代币 ID 数组 [Yes, No]，用于价格/订单簿查询
  • conditionId 字段：十六进制字符串，用于价格历史查询
  • 交易量以 USDC（美元）计价

三个公共 API​

  1. Gamma API 位于 gamma-api.polymarket.com — 发现、搜索、浏览
  2. CLOB API 位于 clob.polymarket.com — 实时价格、订单簿、历史
  3. Data API 位于 data-api.polymarket.com — 交易、未平仓合约

典型工作流程​

当用户询问预测市场赔率时：

  1. 搜索 — 使用 Gamma API 的 public-search 端点，根据用户的查询进行搜索
  2. 解析 — 解析响应，提取事件及其嵌套的市场
  3. 展示 — 展示市场问题、当前价格（以百分比形式）以及交易量
  4. 深入 — 如果用户要求，使用 clobTokenIds 获取订单簿，使用 conditionId 获取历史数据

结果展示​

将价格格式化为百分比以提高可读性：

  • outcomePrices ["0.652", "0.348"] 变为“Yes: 65.2%, No: 34.8%”
  • 始终显示市场问题和概率
  • 如果交易量可用，则一并展示

示例：“X 会发生吗？” — 65.2% Yes（120 万美元交易量）

解析双重编码字段​

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 签名）
  • 部分新市场可能没有价格历史记录
  • 地理限制适用于交易，但只读数据全球可访问