速率限制

定義

API 速率限制是在特定時間窗口內，API 可接受請求數量的上限。超出該上限的用戶端會收到錯誤或在窗口重置前被暫時阻止。速率限制用以保護伺服器免於過載、確保各用戶端之間的公平使用，以及維持服務品質。

情境說明

在 Polymarket 上，Gamma 介面公開了像 /markets 這類的 REST 公共端點。該端點特別允許在 10 秒內發出 300 次請求。針對 /markets 與 /events 的綜合列表請求則有更高的合併上限（在 10 秒內共 900 次請求）。超過這些限制將導致 API 拒絕後續請求，直到相關時間窗口到期；因此請在分頁與輪詢間隔上做好規劃。

實務建議

• 使用鍵集分頁（after_cursor）而非 offset，以有效瀏覽 /markets 的分頁。
• 盡量合併請求並避免緊密的輪詢迴圈；在觸及限制後採取適當的退避策略。
• 若工作流程能容忍短時間的過時資料，則將重複回應快取於短時段內。

參見

• gamma-api