背景说明在 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
