Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained：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。
• Builder 可以通过 CLOB 路由订单以获得归因并赚取 builder 费用；不同等级有不同限额。
• 始终为非确定性执行做设计：UMA 的争议、滑点、部分成交与结算时序仍然是运行风险。

Relayer 存在的原因

Polymarket 在 Polygon PoS（chain ID 137）上运行，并使用 pUSD（Polymarket 的封装 USDC）作为结算资产。Relayer 赞助 gas，终端用户不需要持有 POL 或为链上操作支付 gas。这样去除了用户摩擦，使 MetaMask、Phantom、Rabby、Bitget、OKX、Coinbase 以及任何兼容 EIP-6963 的钱包的交易体验显得原生。

高层架构

Relayer 的作用类似 Gas Station Network（GSN）——它接收链下的用户签名意图，将其封装为被赞助的交易，并在 Polygon 上提交这些交易。对开发者而言，你将与两类接口交互：

• 用于行情和订单簿数据的公开只读 API 与 WebSocket（Gamma、Data、CLOB 以及 Market WS）。确切的基址见下文。
• Relayer Client SDK（TypeScript 和 Python），负责钱包部署、授权、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 端点（limit 可达 1000，分页请使用 after_cursor）。

常见的被赞助流程（开发者视角）

1. 钱包部署

Polymarket 支持预部署的 Gnosis Safe 与在首次交易时自动部署的 Proxy 钱包。当你进行首个被赞助操作时，Relayer 会支付 proxy 部署的 gas 费用。从 SDK 层面通常是自动的：SDK 检测到无钱包后，会请求 Relayer 提交由用户签名的部署交易。

2. ERC-20 授权

用户仅使用 pUSD 交易。Relayer 赞助的授权流程代表用户提交 ERC-20 的 approve（及相关 allowance），使用户无需持有 POL 即可与 CTF 与 Exchange 合约交互。SDK 常会对授权进行批量化管理以降低摩擦。

3. CTF 操作：split / merge / redeem

结果份额是通过 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 会有所帮助，但你的后端应对签名意图去重。
• 待处理状态的 UX：展示清晰的 pending/cancelled/confirmed 状态。被中继的交易是真实的链上交易；使用 Data API 与 Market WS 来反映最终性。
• 速率限制：Gamma 的 /markets 端点有速率限制（/markets 为 300 req / 10 s；/markets + /events 联合上限为 900 req / 10 s）。总体 API 上限为 4000 req / 10 s。在轮询或索引任务中请尊重这些限制。
• 安全性：Relayer 使用其基础设施来签名并提交交易。不要假定它持有你的私钥；你的应用仍应要求用户对意图进行签名。
• 地理限制：Polymarket 按 IP 对下单做地理限制。你的应用必须遵守这些限制；不要建议使用 VPN 绕过。

测试与本地开发

Polymarket 提供 TypeScript 与 Python 的客户端 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 explained：它是让 Polymarket 体验看起来无 gas 的运行层。对开发者而言，它将钱包部署、授权、CTF 操作、转账与下单集中在 SDK 与被赞助交易流程之下。使用公开 API 与 Relayer Client SDK 来构建可预测且用户友好的交易体验，同时遵守速率限制与地理限制。

Further reading

• Developer-focused guides: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Arbitrage reference: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

Relayer 赞助用户在 Polygon PoS 的链上 gas，用于面向用户的操作，包括 Proxy 钱包部署、pUSD 的 ERC‑20 授权、CTF 的 split/merge/redeem、代币转账以及在 CLOB 上下单。Relayer 实际上是将用户签名的意图封装为被赞助的交易并提交到 Polygon。

Do I still need pUSD to trade if gas is sponsored?

需要。Polymarket 使用 pUSD（Polymarket 的封装 USDC）作为结算货币。Relayer 仅赞助 gas；你仍需拥有足够的 pUSD 余额以及任何必要的授权来与市场交互。

Can builders route orders through the Relayer and earn fees?

可以。Builder Program 允许第三方通过 CLOB 路由订单，带上归因头并以基点获得 builder 费用。等级（Unverified、Verified、Partner）对每日 relayer 限额与奖励有不同约束。Builder 凭据在 https://polymarket.com/settings 管理。

Where do I get market data and real-time book updates?

使用公开的 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）获取实时订单簿事件。

What operational risks remain even with the Relayer?

被赞助的 gas 消除了对 POL 的持有需求，但其他风险依然存在：UMA 的结算争议会延迟结算、CLOB 上的滑点与部分成交、Polymarket 的费率结构变动、智能合约风险，以及按 IP 的地理限制会阻止下单。