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。即時市場 socket 為 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 做套利
訂閱 PolyArb，每月 $99，享有 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 個商品。