Gamma API

Polymarket Gamma API 是公开的 REST 接口，公开市场级别的数据：markets、events、tags、series 和 profiles。开发者与交易者使用它来列出市场、获取事件元数据，并在无需身份验证的情况下构建索引页面或市场目录。

关键要点

• Gamma API 是公开的，读取无需身份验证。可用于列出 markets、events、tags、series 和 profiles。
• /markets 有速率限制：每 10 秒 300 次请求。分页使用基于游标的 after_cursor（offset 会被拒绝）。
• 有用的查询参数包括 limit（最大 1000）、after_cursor、像 slug 或 condition_ids 这样的过滤数组，以及诸如 closed 或 active 的布尔标志。
• 谨慎组合 /markets 与 /events：列表合并限额为每 10 秒 900 次请求；整个 API 的限额为每 10 秒 4000 次请求。

Gamma API 的使用场景

Gamma API 是获取面向展示的 Polymarket 市场数据的规范公共接口。前端、聚合器和研究工具会调用诸如 /markets 和 /events 的端点来填充市场列表、类别页面和标签筛选器。

重要参数和行为

• limit：控制页面大小。默认 20，最大 1000。
• after_cursor：基于游标的分页；offset 会返回 HTTP 422—不要使用 offset。
• 过滤：若干查询参数接受数组（例如 slug、id、condition_ids、clob_token_ids、question_ids、market_maker_address）。
• 标志：closed（默认 false）、active 和 archived 按市场状态过滤。
• 排序：order 参数接受以逗号分隔的字段列表（例如 volume24hr,volume,liquidity,endDate），并配合 ascending（布尔值）使用。

速率限制与实用建议

• /markets 的专属限制：每 10 秒 300 次请求。
• /markets + /events 的合并列表限制：每 10 秒 900 次请求。
• 整个 Gamma API 面：每 10 秒 4000 次请求。

如果计划高吞吐量索引，实现指数退避并遵守基于游标的分页模式。适当缓存列表；避免对同一资源进行激烈轮询。

示例请求（curl）

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

在 Polymarket 的使用语境中

Gamma 是公开的、无需认证的只读 API，当你需要用于 UI 列表、标签页面或不需要链上状态的集成的市场元数据时，会访问它（对于链上头寸和交易请使用 Data API；对于订单簿操作请使用 CLOB API）。由于 Gamma 为只读且公开，它是构建市场目录和探索性工具的合适之处。

另请参阅

• /glossary/data-api
• /glossary/clob-api

结语

Polymarket Gamma API 是获取市场元数据的首站。使用文档中列出的参数并尊重速率限制以避免请求被拒。