背景说明在 Polymarket 的 快速入门 - 获取市场数据(Fetching Market Data)部分,官方通过 Gamma API(无需任何认证、无需 API Key、无需钱包)来让开发者轻松发现和浏览当前活跃的市场。示例使用以下 curl 命令获取当前活跃且未关闭的事件(前 5 个):

bash

curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=5"
  • active=true:只返回正在进行中的事件(live/tradable)
  • closed=false:排除已决议/结束的事件
  • limit=5:限制返回数量(可根据需要调整)

这个端点返回的是事件(Event)列表,每个事件下嵌套一个或多个可交易市场(Market)。这是 Polymarket 数据模型的核心:

  • Event:顶层话题/问题(如“比特币 2025 年底前会达到 10 万美元吗?”)
  • Market:该事件下的具体二元交易市场(通常是 Yes/No 结果)

示例响应(Example Response)完整 JSON官方文档中给出的示例响应结构如下(这是一个简化但典型的真实格式示例):

json

[
  {
    "id": "123456",
    "slug": "will-bitcoin-reach-100k-by-2025",
    "title": "Will Bitcoin reach $100k by 2025?",
    "active": true,
    "closed": false,
    "tags": [
      {
        "id": "21",
        "label": "Crypto",
        "slug": "crypto"
      }
    ],
    "markets": [
      {
        "id": "789",
        "question": "Will Bitcoin reach $100k by 2025?",
        "clobTokenIds": [
          "TOKEN_YES_ID",
          "TOKEN_NO_ID"
        ],
        "outcomes": "[\"Yes\", \"No\"]",
        "outcomePrices": "[\"0.65\", \"0.35\"]"
      }
    ]
  }
]

关键字段详解事件(Event)层级字段

  • id:事件的唯一数字 ID(字符串格式)
  • slug:URL 友好的标识符,常用于构建链接或查询具体市场
  • title:事件的标题/问题描述(人类可读)
  • active:是否活跃(true 表示当前可交易)
  • closed:是否已关闭/决议(false 表示未结束)
  • tags:标签数组,用于分类(如 Crypto、政治、体育等)
    • 每个 tag 有 id、label(显示名称)、slug

市场(Market)层级字段(嵌套在 markets 数组中)

  • id:该市场的唯一 ID
  • question:市场的具体问题文本(通常与事件 title 相同或略有细化)
  • clobTokenIds:非常重要!这是 Yes/No 两个结果代币的 Token ID 数组,后续用于:
    • 查询实时价格(CLOB /price 端点)
    • 查询订单簿(CLOB /book 端点)
    • 下单交易等
  • outcomes:结果选项的 JSON 字符串数组,例如 "[\"Yes\", \"No\"]"(注意是字符串化的)
  • outcomePrices:对应结果的隐含概率(implied probabilities),也是字符串化的数组,例如 "[\"0.65\", \"0.35\"]"
    • 含义:Yes 的当前市场概率 = 65%(价格 ≈ 0.65 USDC)
    • No 的当前市场概率 = 35%(价格 ≈ 0.35 USDC)
    • Yes + No 价格之和接近 1.00(市场动态可能有轻微偏差)

索引对应:outcomes[0] 对应 outcomePrices[0],以此类推。通常第一个是 Yes,第二个是 No。实际意义与使用建议这个示例响应展示了 Polymarket 如何用零门槛的方式公开市场数据:

  • 你可以直接用浏览器或任何 HTTP 客户端访问该 URL 获取实时活跃市场列表。
  • 通过 clobTokenIds 进一步调用 CLOB API(如 https://clob.polymarket.com/price?token_id=...&side=buy)获取买/卖单价。
  • 适合场景:构建市场浏览器、警报工具、数据分析脚本、交易机器人等。

一句话总结:
这个 JSON 示例是 Gamma API 的核心输出格式,完美展示了“事件 → 市场 → Yes/No 概率”的层级结构,是所有 Polymarket 数据抓取和集成工作的起点。想自己试试?直接在浏览器打开这个链接:
https://gamma-api.polymarket.com/events?active=true&closed=false&limit=5更多过滤方式(如按体育联赛、标签、排序)请参考完整页面:https://docs.polymarket.com/quickstart/fetching-data