Polymarket API 文档：端点、速率限制与使用说明
如果你在搜索 “polymarket api docs”，说明你需要关于确切端点、认证模型以及构建或集成 Polymarket 时的实际限制。下面列出了三个公共 REST API 和你将使用的市场 WebSocket，以及关键参数和速率限制。我还说明了 CLOB 对交易的要求，以及 PolyArb 如何利用这些界面发现 Intra-market（市场内）套利机会。
官方 API 端点与服务概览
Polymarket 提供三个公共 REST 接口和一个市场 WebSocket。用于市场和事件的 Gamma API 位于 https://gamma-api.polymarket.com。用于头寸、交易和未平仓量的 Data API 位于 https://data-api.polymarket.com。用于订单簿与交易的 CLOB API 位于 https://clob.polymarket.com。实时市场套接字为 wss://ws-subscriptions-clob.polymarket.com/ws/market。 每个接口有其用途：Gamma 用于列表和筛选，Data 提供历史和链上派生的活动数据，CLOB 用于实时订单簿读取和下单（读取为公开；交易需要 API key + HMAC）。WebSocket 流式传输订单簿和价格变动事件，每个连接最多支持 500 个合约。
Gamma /markets 参数与限制
Gamma 的 /markets 端点使用 keyset 分页：请使用上一次调用返回的 after_cursor；offset 会被 HTTP 422 拒绝。常用查询参数包括 limit（最大 1000）、slug、id、condition_ids、clob_token_ids、question_ids、market_maker_address、closed、active、archived、order、ascending 和 tag_id。 速率限制：/markets 限制为每 10 秒 300 次请求；/markets 与 /events 的合并列举调用限制为每 10 秒 900 次请求。Gamma API 的整体额度为每 10 秒 4000 次请求。
CLOB 与交易机制
CLOB 暴露订单簿、midpoint、价格历史以及下单/撤单接口。交易需要 API key 加上 HMAC；读取为公开。Polymarket 的最小价格刻度（tick size）、best_bid_ask 事件与 FAK 市价单辅助函数都通过 CLOB 和市场 WebSocket 提供。 请记住 maker 手续费为零，taker 手续费按类别变化。如果你构建交易代理路由，请考虑加入 Polymarket 的 Builder Program 以获得归因与 builder-fee 奖励。
PolyArb 如何使用这些 API
PolyArb 会轮询 Gamma 和 CLOB 订单簿，并订阅市场 WebSocket，以检测 Σ bestAsk < $1.00 的市场内套利机会。我们的机器人运行在低延迟基础设施（40ms 方案），以击败免费机器人（约 800ms），订阅费为 $99/month，且每笔交易有 $7.62 的最低保证边际。 我们结合实时的 best_bid_ask 事件、CLOB midpoint 与 Data API 历史数据来确定下单规模并尽量避免部分成交。请注意常见的操作风险：通过 UMA 的决议争议、滑点、手续费变动、结算时序以及智能合约风险。
立刻使用 PolyArb 在 Polymarket 上套利
以 $99/month 订阅 PolyArb，可获得 40ms 延迟、Telegram 与 Discord 提醒、非托管执行，以及我们每笔交易 $7.62 的最低保证边际。
FAQ
- 官方 Polymarket API 的基础 URL 在哪里？
- Gamma：https://gamma-api.polymarket.com；Data：https://data-api.polymarket.com；CLOB：https://clob.polymarket.com；WebSocket：wss://ws-subscriptions-clob.polymarket.com/ws/market。
- 读取市场数据需要认证吗？
- 不需要。对 Gamma、Data 和公开的 CLOB 端点的读取是不需认证的。对 CLOB 下单需要 API key 加上 HMAC。
- /markets 的重要速率限制有哪些？
- /markets 限制为每 10 秒 300 次请求。/markets 与 /events 的合并列举调用限制为每 10 秒 900 次请求。Gamma API 的整体限制为每 10 秒 4000 次请求。
- 我可以用 WebSocket 获取实时订单簿更新吗？
- 可以。市场 WebSocket 提供实时的 book、price_change、best_bid_ask、last_trade_price 和 tick_size_change 事件。它每 10 秒发送一次 ping，并支持每连接最多 500 个合约。