name: polymarket description: “Query Polymarket: markets, prices, orderbooks, history.” version: 1.0.0 author: Hermes Agent + Teknium tags: [polymarket, prediction-markets, market-data, trading] platforms: [linux, macos, windows]
Polymarket — 预测市场数据
可通过 Polymarket 的公共 REST API 查询预测市场数据。 所有接口均为只读性质，无需任何身份验证。
如需包含 curl 示例的完整接口参考，请参阅 references/api-endpoints.md 文件。
适用场景
- 用户询问有关预测市场、投注赔率或事件概率的问题
- 用户想要了解“X 发生的概率是多少？”
- 用户专门咨询 Polymarket 相关内容
- 用户需要获取市场价格、订单簿数据或价格历史记录
- 用户希望监控或追踪预测市场的动态变化
核心概念
- 事件包含一个或多个市场（1:多关系）
- 市场具有二元结果，其“是/否”对应的概率价格介于 0.00 到 1.00 之间
- 这些价格即代表概率：价格 0.65 表示市场认为该事件发生的概率为 65%
outcomePrices字段：以 JSON 编码的数组形式存在，例如["0.80", "0.20"]clobTokenIds字段：用于查询价格和订单簿的 JSON 编码数组，包含两个代币 ID [是, 否]conditionId字段：用于查询价格历史记录的十六进制字符串- 所有交易量均以 USDC（美元）计价
三个公共 API
- Gamma API，地址为
gamma-api.polymarket.com—— 用于发现、搜索和浏览功能 - CLOB API，地址为
clob.polymarket.com—— 提供实时价格、订单簿及历史数据 - Data API，地址为
data-api.polymarket.com—— 提供交易记录和未平仓合约数据
典型工作流程
当用户询问预测市场赔率时：
- 使用 Gamma API 的公共搜索接口输入查询条件进行搜索
- 解析返回结果，提取相关事件及其嵌套的市场信息
- 显示市场问题、以百分比形式呈现的当前价格以及交易量
- 若用户进一步要求深入分析，可使用
clobTokenIds查询订单簿信息，或通过conditionId查看历史数据
结果展示方式
为便于理解，建议将价格以百分比形式呈现：
outcomePrices为["0.652", "0.348"]时，应显示为“是：65.2%，否：34.8%”- 必须同时展示市场问题及对应的概率值
- 如有交易量数据，也需一并显示
示例格式：“X 会发生吗？——65.2% 的概率会发生（交易量达 120 万美元）”
解析双重编码的字段
Gamma API 会在 JSON 响应中以双重编码的形式返回 outcomePrices、outcomes 和 clobTokenIds 等字段，即这些数据本身仍是 JSON 字符串。在使用 Python 处理时，需通过 json.loads(market['outcomePrices']) 的方式将其解析为真正的数组。
请求频率限制
限制较为宽松，正常使用情况下几乎不会达到上限：
- Gamma API：每 10 秒允许 4,000 次请求（普通用途）
- CLOB API：每 10 秒允许 9,000 次请求（普通用途）
- Data API：每 10 秒允许 1,000 次请求（普通用途）
局限性
- 该功能仅为只读模式，不支持执行交易操作
- 进行交易需要基于钱包的加密身份验证（EIP-712 签名）
- 部分新创建的市场可能暂无价格历史记录
- 虽然只读数据可全球访问，但实际交易仍受地域限制