Polymarket Builder Program：開發者概覽

Polymarket Builder Program 提供第三方營運者一條通道，讓他們能夠將訂單透過 Polymarket 的 CLOB 路由，並獲得歸屬（attribution）與以基點（basis points）計算的 builder fee，同時能存取更高的 relayer 配額與其他獎勵。本指南說明計畫運作方式、三個等級、收益分配的原則，以及使用 Polymarket Relayer Client 的工程整合要點。

重點摘要

• Builder Program 讓第三方能夠帶入訂單流到 CLOB、取得歸屬，並以基點賺取 builder fee。
• 計畫分為三個等級（Unverified、Verified、Partner），搭配遞增的每日 relayer 限額與獎勵。
• Builder 的整合透過歸屬標頭（attribution headers）；Polymarket Relayer Client SDK（TypeScript 與 Python）負責錢包部署、授權、CTF 操作與下單等流程。
• Polymarket 的 maker fee 為零；builder fee 在成交時支付，且以基點表示。
• 認證與 builder 設定在 polymarket.com/settings 管理；實際的收益細節與費率由 Polymarket 控制，可能會變動。

為何要有 Builder Program

Polymarket 採用 Central Limit Order Book（CLOB），並透過 Relayer 贊助交易的 gas。Builder Program 為第三方提供一個正式管道，把訂單流導入 CLOB，同時獲得歸屬與收益分成（builder fees）。對於建立路由邏輯、市場製造前端或交易基礎設施的開發者，這個計畫提供一條受支持的、直接把流量送入 Polymarket 交易所的途徑。

計畫等級與其意義

H2: 三個等級

• Unverified
  • 每日 relayer 限額：每天 100 筆訂單。
  • 權益：僅提供免 gas 交易與歸屬。
• Verified
  • 每日 relayer 限額：每天 10,000 筆訂單。
  • 權益：根據成交量的每週 USDC 獎勵，外加以基點計算的 builder fee。
• Partner
  • 每日 relayer 限額：不限。
  • 權益：最高的速率限制與升級支援；可進入最高等級的獎勵方案。

以上為 Polymarket 公布的等級規則。等級會影響計畫的速率限制、獲獎資格與支援等級；但不改變 builder fee 在成交時計算的基本機制。

builder fee 與歸屬的運作方式

Builder fee 在路由訂單上以基點設定，並在訂單成交時支付給該 builder。歸屬透過標頭來實作，這些標頭標示路由的 builder；Relayer 會使用這些標頭在成交時將費用記給對應的 builder。

重要機制提醒：

• 費用以基點表示並在成交時計入；Polymarket 的 maker fee 仍為零。
• 交易要被記入某個 builder，必須包含歸屬標頭。Relayer 與 CLOB 在請求中都會期待這些標頭。
• Verified 的 builder 會收到基於成交量的每週 USDC 獎勵，加上所累積的 builder fee；Partner 等級則有更高的獎勵與支援。

Polymarket 控制實際的費率與獎勵公式。建議 builder 不要假定固定費率；請到 polymarket.com/settings 檢查當前的認證與 builder 設定。

與 Polymarket Relayer Client 的整合

H2: Polymarket Relayer Client（TypeScript 與 Python）

Polymarket 提供官方的 Relayer Client SDK（TypeScript 與 Python）來簡化整合。該 client 負責常見的 end-user 任務，讓你的整合可以專注於路由邏輯與訂單策略。

Client 為你處理的項目：

• 錢包部署與 Proxy 或 Gnosis Safe 的處理
• pUSD 的 ERC-20 授權
• 用於 outcome token 的 CTF 操作（split/merge/redeem）
• 訂單建立與取消，包括作為 FAK 暴露的市價單
• 在需要時以 builder 歸屬標頭為請求簽名

使用 Relayer Client 可以降低工程摩擦，並確保請求符合 Polymarket 的 relayer 預期（速率限制、標頭與 CLOB 語意）。

實務整合檢查清單

H2: builders 的實作檢查清單

1. 取得認證
   • 在 polymarket.com/settings 取得你的 builder 認證並設定等級。這會控制你的 relayer 限額與獲獎資格。
2. 選擇 SDK
   • 使用 TypeScript 或 Python 的 Relayer Client 來加速整合並避免低階誤配置。
3. 加入歸屬
   • 確保每筆路由的訂單都包含必要的歸屬標頭，讓 Relayer 能將成交記到你的 builder 帳戶。
4. 處理授權與錢包
   • 使用 client 來管理 pUSD 授權與錢包部署；Relayer 贊助 gas，終端使用者因此維持免 gas 體驗。
5. 監控限制
   • 在系統中實作配額以避免超過你的等級每日 relayer 限額。Unverified 限 100/天，Verified 為 10,000/天，Partner 則不限。
6. 考慮費用與結算
   • 以基點追蹤 builder fee 的累積，並在你是 Verified 或 Partner 時與每週獎勵對帳。

會計與收益分配注意事項

H2: 款項流向說明

• Builder fee 在成交時計入，並以交易金額的基點計算。
• Verified 的 builder 除了 builder fee 外，還會根據成交量獲得每週的 USDC 獎勵；Partner 等級依 Polymarket 計畫則可獲得加強的獎勵。
• Polymarket 管理實際的支付與每週獎勵公式；builder 應使用 polymarket.com/settings 的儀表板查詢報表與付款細節。

營運與風險備註

• Relayer 的速率限制很重要：在本端強制實作節流機制，以避免被拒絕的請求與意外行為。
• 經由 Relayer 路由的交易仍受 Polymarket 的 CLOB 規則約束：tick size 的行為、以 FAK 表示的市價單語意，以及 maker/taker 費率規則（maker 的費用為零）。
• Builder 並不能移除預測市場所固有的其他風險：例如 resolution risk（UMA 的爭議可能會延遲結算）、滑價與部分成交、以及智慧合約風險。務必向你的使用者揭露這些風險。

此方案對你的交易基礎設施的影響

H2: 對系統的實務影響

如果你經營路由層或聚合器，Builder Program 會改變兩件事：你可以為你所路由的訂單直接獲得收入，且你必須管理歸屬與 relayer 限額。使用 Relayer Client 來處理錢包與 token 操作，以免重寫 CTF 與免 gas 邏輯。設計系統時應為每筆訂單記錄歸屬、追蹤累積的基點費用，並與 Polymarket 的每週付款進行對帳。

結語摘要

Polymarket Builder Program 是一條以開發者為主的通道，可以把訂單流加入 Polymarket 的 CLOB、獲得歸屬並分享收益。對 builder 而言，主要的營運任務包括取得認證、整合歸屬標頭、使用 Polymarket Relayer Client（TypeScript 或 Python），並遵守等級化的 relayer 限額。Builder fee 在成交時以基點支付，Verified/Partner builder 會收到由 Polymarket 管理的額外獎勵機制。

欲了解更多關於 CLOB 與市場語意的技術細節，請參閱 /guides/polymarket-clob-explained；欲了解 Polymarket 的費率結構，請參閱 /guides/polymarket-fees-explained。

常見問題

Polymarket Builder Program 的等級與限制是什麼？

共有三個等級：Unverified（每日 relayer 限額 100）、Verified（每日 relayer 限額 10,000，另享每週 USDC 獎勵與 builder fee）、以及 Partner（不限 relayer 限額且有升級支援）。這些等級會控制速率限制與獲獎資格。

Polymarket 的 builder fee 如何支付？

Builder fee 以基點設定，並在訂單成交時支付給被記錄的 builder。Verified 的 builder 還會依成交量獲得每週 USDC 獎勵；具體的支付機制由 Polymarket 管理。

我需要管理 gas 或錢包部署嗎？

不需要。Polymarket Relayer 贊助終端使用者的 gas。Relayer Client SDK（TypeScript 與 Python）會處理錢包部署（Proxy 或 Gnosis Safe）、pUSD 授權與 CTF 操作，讓你能專注於路由邏輯。

我怎麼確保我的交易會被記到我的 builder 帳戶？

在路由請求中包含必要的歸屬標頭。Relayer 會使用那些標頭將成交記給你的 builder。使用官方 Relayer Client 可確保標頭與簽名正確。

我在哪裡取得 builder 認證與設定？

Builder 認證與等級設定在 polymarket.com/settings 管理。該儀表板控制認證發放、等級分配與報表。