定義
Gamma API
Polymarket 的公開 REST API，提供 markets、events、tags 與 series 的資料。
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 是拿取市場元資料的第一站。使用文件中記載的參數並尊重速率限制，以避免請求被拒。