Polymarket

查询 Polymarket 预测市场数据 — 搜索市场、获取价格、订单簿和价格历史。通过公共 REST API 进行只读访问，无需 API 密钥。

技能元数据


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

参考：完整 SKILL.md

信息

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

Polymarket — 预测市场数据

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

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

何时使用

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

关键概念

事件 (Events) 包含一个或多个 市场 (Markets)（1:多关系）
市场是具有二元结果的市场，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%"
始终显示市场问题和概率
如有可用，包含交易量

示例："Will X happen?" — 65.2% Yes ($1.2M volume)

解析双重编码字段

Gamma API 在 JSON 响应中将 outcomePrices、outcomes 和 clobTokenIds 作为 JSON 字符串返回（双重编码）。在使用 Python 处理时，请使用 json.loads(market['outcomePrices']) 进行解析以获取实际数组。

速率限制

宽松 — 正常使用不太可能触及限制：

Gamma：每 10 秒 4,000 次请求（常规）
CLOB：每 10 秒 9,000 次请求（常规）
Data：每 10 秒 1,000 次请求（常规）

局限性

此技能为只读 — 不支持下单交易
交易需要基于钱包的加密身份验证（EIP-712 签名）
某些新市场可能没有价格历史
交易存在地理限制，但只读数据全球可访问

技能元数据​

参考：完整 SKILL.md​

Polymarket — 预测市场数据

何时使用​

关键概念​

三个公共 API​

典型工作流程​

展示结果​

解析双重编码字段​

速率限制​

局限性​