Polymarket Relayer 說明：Polymarket 的無 gas 模式如何運作

Polymarket Relayer 說明：Relayer（中繼代付層）是贊助所有鏈上使用者操作的 gas-station 層，讓交易者永遠不需支付 gas。本指南帶領開發者與好奇的使用者，了解 Relayer 的責任、面向開發者的 SDK、常見交易流（錢包部署、ERC-20 授權、CTF split/merge/redeem、轉帳與下單），以及建立穩健工具時需注意的運行限額。

重點總結

• Relayer 是一個 gas-station network 層，贊助 Polygon PoS 的交易，讓使用者可以用 pUSD 無 gas 進行交易。
• Relayer 支援的常見流程：Proxy 錢包部署、ERC‑20 授權、CTF 的 split/merge/redeem、轉帳，與 CLOB 下單。
• 你應使用的 API 與 SDK：Relayer Client SDK（TypeScript / Python）以及三個用於市場與數據讀取的公開 REST API。
• Builders 可以透過 Polymarket 路由訂單並獲得歸屬（attribution）與 builder 費；不同階層有額外限制。
• 始終為非決定性執行設計：UMA 的仲裁爭議、滑點、部分成交與結算時序仍然是操作性風險。

為何需要 Relayer

Polymarket 在 Polygon PoS（chain ID 137）上運行，並以 pUSD（Polymarket 的 wrapped USDC）作為結算資產。Relayer 贊助 gas，讓終端使用者不需持有 POL 或支付鏈上操作的 gas。這消除了使用摩擦，讓像 MetaMask、Phantom、Rabby、Bitget、OKX、Coinbase 與任何 EIP-6963 相容的錢包看起來像原生支援交易。

高階架構

Relayer 的運作類似 Gas Station Network（GSN）——它接受離線簽名的使用者意向（signed intents），將它們封裝成被贊助的交易，然後在 Polygon 上提交。從開發者角度，你會與兩類介面互動：

• 用於市場與委託簿資料的公開讀取 API 與 WebSocket（Gamma、Data、CLOB，以及 Market WS）。請見下方的精確 base URLs。
• Relayer Client SDK（TypeScript 與 Python），該 SDK 處理錢包部署、授權、CTF 操作與透過贊助流程的下單。

重要的公開端點與介面

• Gamma API（markets、events、tags）：https://gamma-api.polymarket.com
• Data API（positions、trades、holders、open interest）：https://data-api.polymarket.com
• CLOB API（order book 與交易）：https://clob.polymarket.com — 注意 builders 的交易需要 API key + HMAC；讀取為公開
• Market WebSocket（即時委託簿）：wss://ws-subscriptions-clob.polymarket.com/ws/market

Polymarket 已記錄精確的 API 使用與速率限制；使用 Gamma 的 /markets 端點取得市場列表（上限可達 1000，分頁請使用 after_cursor）。

常見的贊助流程（開發者視角）

1. 錢包部署

Polymarket 支援 Gnosis Safe（預部署）與 Proxy 錢包（在首次交易時自動部署）。當你執行第一個被贊助的操作時，Relayer 會支付 proxy 部署的 gas 成本。從 SDK 角度通常是自動的：SDK 偵測找不到錢包，會要求 Relayer 幫忙提交由使用者簽名的部署交易。

2. ERC-20 授權

使用者僅以 pUSD 進行交易。Relayer 贊助的授權流程會代表使用者提交 ERC-20 授權（以及相關的 allowance），讓他們在不持有 POL 的情況下與 CTF 與 Exchange 合約互動。SDK 通常會批次化並管理授權以降低摩擦。

3. CTF 操作：split / merge / redeem

結果股（outcome shares）是透過 Gnosis Conditional Token Framework（CTF）鑄造的 ERC-1155 代幣。典型的 CTF 操作——split（以 $1.00 pUSD 鑄造完整組合）、merge（將組合燒毀換回 pUSD）、以及 redeem（在解析後燒毀贏方代幣以獲得 $1.00）——都由 Relayer 支援。這些鏈上互動由 Relayer 以被贊助交易的方式提交。

4. 轉帳與提款

結果代幣與 pUSD 的轉移，以及任何明確的提款步驟，都是透過 Relayer 支援的交易執行，讓使用者在不支付 gas 的情況下移動資金。在 UX 上請保留對待處於被轉發交易之待定狀態的提示——這些交易是鏈上交易，但可能稍後才會在 Data API 中可觀察到。

5. 在 CLOB 上下單

下單（限價或市價/FAK）經由 CLOB 路由。為訂單路由的 Builders 需要使用 API key + HMAC 才能進行帶有歸屬標頭的認證交易。Relayer Client SDK 整合了訂單建立，並在適用時處理市價訂單的 FAK 語義。Maker 手續費為零；taker 手續費依分類而異。

Builder 計畫與歸屬

第三方可以透過 CLOB 路由訂單並以基點形式獲得 builder 費。階層包括 Unverified（每日 Relayer 次數上限 100）、Verified（每日上限 10,000 並享有每週 USDC 獎勵）與 Partner（不限）。Builder 憑證可在 https://polymarket.com/settings 取得，Relayer Client SDK 實作了參與所需的驗證與歸屬標頭。

實務開發者關注點

• 冪等性與重試：因為 Relayer 會替你提交鏈上交易，請設計冪等流程與穩健的重試邏輯。SDK 可協助，但你的後端應去重（de-dup）簽名意向。
• 待定狀態的 UX：顯示清楚的待定/已取消/已確認狀態。被轉發的交易是真實的區塊鏈交易；使用 Data API 與 Market WS 反映最終確定性。
• 速率限制：Gamma 的 /markets 端點受速率限制（/markets 為 300 req / 10 s；/markets + /events 合計為 900 req / 10 s）。整體 API 上限為 4000 req / 10 s。在輪詢或索引作業中請尊重這些限制。
• 安全性：Relayer 使用其基礎設施簽署並提交交易。不要假設私鑰由 Relayer 保管；你的應用仍應要求使用者對意向簽名。
• 地理限制：Polymarket 以 IP 來封鎖訂單。你的應用必須遵守這些限制；不要建議使用 VPN 規避。

測試與本地開發

Polymarket 提供 TypeScript 與 Python 的 client SDK。開發時使用 SDK 來模擬被贊助的流程。市場讀取請使用 Gamma、Data 與 CLOB 的公開端點，並用 Market WS 取得即時串流。請記得 WebSocket 每 10 秒會發出一次 PING，且每個連線最多支援 500 個商品。

運行限制與邊界情況

• Tick size 變更：tick size 在價格接近極端時由 $0.01 收窄到 $0.001；WebSocket 會發出 tick_size_change 事件。你的撮合與價格顯示邏輯必須處理此情況。
• UMA 爭議與解析延遲：Relayer 無法消除預言機或解析風險。UMA 的爭議可能會暫停結算；請為延遲的兌換設計 UX。
• 手續費與經濟模型：Maker 手續費為零；taker 手續費依分類而異（0%–1.8%）。Relayer 不會改變市場的手續費結構。

這如何影響你的交易工具與機器人

如果你建立會在 Polymarket 上執行的工具，請依賴 Relayer Client SDK 處理使用者流程，並在伺服端保留簽名、冪等性以及 builders 的歸屬標頭管理等流程。使用公開 API 取得市場資料，並用 Market WS 取得低延遲的委託簿更新。考量非決定性的結果（滑點、部分成交、解析延遲），並在 UI 中清楚呈現這些風險。

結語

Polymarket Relayer 說明：它是讓 Polymarket 呈現無 gas 使用體驗的運作層。對開發者而言，它把錢包部署、授權、CTF 操作、轉帳與訂單提交集中在 SDK 與被贊助的交易流程之後。使用公開 API 與 Relayer Client SDK 來建立可預期且友善的交易體驗，同時遵守速率限制與地理限制。

延伸閱讀

• 面向開發者的指南：/guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Arbitrage 參考：/guides/polymarket-arbitrage-complete-guide

常見問題

Polymarket Relayer 到底贊助哪些項目？

Relayer 贊助 Polygon PoS 上面向使用者的鏈上 gas，包括 Proxy 錢包部署、pUSD 的 ERC‑20 授權、CTF 的 split/merge/redeem、代幣轉移，以及在 CLOB 上的下單。Relayer 本質上會把使用者簽名的意向封裝成被贊助的交易，然後提交到 Polygon。

如果 gas 已被贊助，我還需要 pUSD 才能交易嗎？

需要。Polymarket 使用 pUSD（Polymarket 的 wrapped USDC）作為結算貨幣。Relayer 只贊助 gas；你仍需足夠的 pUSD 餘額以及必要的授權以與市場互動。

Builders 可以透過 Relayer 路由訂單並賺取費用嗎？

可以。Builder Program 允許第三方透過 CLOB 路由訂單並以歸屬標頭賺取以基點計算的 builder 費。階層（Unverified、Verified、Partner）會施加每日 Relayer 使用限制與不同的獎勵。Builder 憑證在 https://polymarket.com/settings 管理。

我可以從哪裡獲取市場資料與即時委託簿更新？

使用公開的 REST API 與 WebSocket：Gamma（https://gamma-api.polymarket.com）取得市場，Data（https://data-api.polymarket.com）取得持倉與成交，CLOB（https://clob.polymarket.com）取得委託簿讀取，並使用 Market WS（wss://ws-subscriptions-clob.polymarket.com/ws/market）取得即時委託簿事件。

即便有 Relayer，還有哪些運營風險？

被贊助 gas 消除了持有 POL 的需要，但其他風險仍存在：UMA 解析爭議可能延遲結算、CLOB 上的滑點與部分成交、Polymarket 變動手續費結構、智慧合約風險，以及以 IP 封鎖訂單的地理限制。