加密货币市场数据

# Polymarket — 预测市场数据

使用 Polymarket 的公开 REST API 查询预测市场数据。

所有端点均为只读，无需任何身份验证。

完整的端点参考及 curl 示例见 references/api-endpoints.md。

何时使用

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

核心概念

• 事件（Events）包含一个或多个市场（Markets）（一对多关系）
• 市场（Markets）是二元结果，Yes/No 价格在 0.00 到 1.00 之间
• 价格即概率：价格 0.65 表示市场认为有 65% 的可能性
• outcomePrices 字段：JSON 编码的数组，如 ["0.80", "0.20"]
• clobTokenIds 字段：JSON 编码的两个 token 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%」
• 始终展示市场问题与概率
• 有交易量时一并展示

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

解析双重编码字段

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 签名）
• 部分新市场的价格历史可能为空
• 交易有地域限制，但只读数据全球可访问