Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: the Relayer is the gas-station layer that sponsors every on-chain user action so traders never pay gas. This guide walks developers and curious users through the Relayer's responsibilities, the developer-facing SDKs, typical transaction flows (wallet deployment, ERC-20 approvals, CTF split/merge/redeem, transfers, and order placement), and operational limits you need to build robust tooling.

主な要点

• Relayer はガスステーション層で、Polygon PoS 上のトランザクションをスポンサーすることで、ユーザーがガスを支払うことなく pUSD で取引できるようにします。
• Relayer がカバーする一般的なフロー：Proxy ウォレットのデプロイ、ERC‑20 承認、CTF の split/merge/redeem、トークン転送、および CLOB での注文配置。
• 利用すべき API と SDK：Relayer Client SDK（TypeScript / Python）と、市場・データ読み取り用の 3 つの公開 REST API。
• Builder は注文を Polymarket 経由でルーティングし、アトリビューションを付与してビルダーフィーを得られます。階層ごとの制限が適用されます。
• 実行が決定論的でない事態に備えて設計してください：UMA の解決に関する紛争、スリッページ、部分約定、清算のタイミングは運用上のリスクとして残ります。

なぜ Relayer が存在するのか

Polymarket は Polygon PoS（chain ID 137）上で動作し、決済資産に pUSD（Polymarket のラップされた USDC）を使用します。Relayer はガスをスポンサーするため、エンドユーザーは POL を保持したりオンチェーン操作のガスを支払ったりする必要がありません。これによりユーザー体験の摩擦が減り、MetaMask、Phantom、Rabby、Bitget、OKX、Coinbase、ならびに EIP-6963 対応ウォレットのようなウォレットでネイティブな取引体験が可能になります。

ハイレベルなアーキテクチャ

Relayer は Gas Station Network（GSN）として機能します — オフチェーンで署名されたユーザーインテントを受け取り、それをスポンサー付きのトランザクションにラップして Polygon に送信します。開発者の観点では、主に二つのインターフェース群とやり取りします：

• マーケットとブックデータ向けの公開読み取り用 API と WebSocket（Gamma、Data、CLOB、Market WS）。以下に正確なベース URL を示します。
• ウォレットデプロイ、承認、CTF 操作、注文配置をスポンサー付きフローで処理する Relayer Client SDK（TypeScript と Python）。

重要な公開エンドポイントとサーフェス

• Gamma API（markets、events、tags）： https://gamma-api.polymarket.com
• Data API（positions、trades、holders、open interest）： https://data-api.polymarket.com
• CLOB API（オーダーブックとトレーディング）： https://clob.polymarket.com — 注：ビルダーの取引には API key + HMAC が必要；読み取りは公開
• Market WebSocket（リアルタイムブック）： wss://ws-subscriptions-clob.polymarket.com/ws/market

正確な API の利用法とレートリミットは Polymarket のドキュメントを参照してください。市場一覧には Gamma の /markets エンドポイントを使用します（limit 最大 1000、ページネーションには after_cursor を使用）。

開発者視点での一般的なスポンサー付きフロー

1. ウォレットのデプロイ

Polymarket は Gnosis Safe（事前デプロイ）と Proxy ウォレット（初回トランザクションで自動デプロイ）をサポートします。Relayer は最初のスポンサー付きアクション時に Proxy デプロイのガス費用を負担します。SDK からは通常自動で処理されます：SDK がウォレット未検出を察知すると、ユーザー署名を受けたデプロイ tx を Relayer に提出する仕組みです。

2. ERC-20 承認

ユーザーは pUSD のみで取引します。Relayer がスポンサーする承認フローは、ユーザーに代わって ERC-20 承認（および関連するアローワンス）を提出し、ユーザーが 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 支援のトランザクションで実行されるため、ユーザーはガスを支払うことなく資金を移動できます。保留中のリレードトランザクションに対して UX 上のシグナルを出すようにしてください — これらはオンチェーンですが、Data API で後から観測される場合があります。

5. CLOB での注文配置

注文配置（指値またはマーケット/FAK 注文）は CLOB を経由してルーティングされます。注文をルーティングするビルダーは、アトリビューションヘッダ付きで認証された取引のために API key + HMAC を使用します。Relayer Client SDK は注文作成を統合し、適宜 マーケット注文の FAK セマンティクスを処理します。Maker 手数料はゼロ、Taker 手数料はカテゴリによって異なります。

Builder プログラムとアトリビューション

サードパーティは注文を CLOB にルーティングしてビルダーフィー（ベーシスポイントで付与）を得ることができます。階層は Unverified（デイリー Relayer 制限 100）、Verified（デイリー制限 10,000 と週次 USDC 報酬）、Partner（無制限）です。ビルダーの資格情報は https://polymarket.com/settings で管理され、Relayer Client SDK は参加に必要な認証とアトリビューションヘッダを実装します。

実務上の開発者向け注意点

• 冪等性とリトライ：Relayer がオンチェーントランザクションを代行して送信するため、冪等性を保つフローと堅牢なリトライロジックを設計してください。SDK が支援しますが、バックエンド側で署名インテントの重複排除を行うべきです。
• 保留状態の UX：保留／キャンセル済み／確定の状態を明確に表示してください。リレードトランザクションは実際のブロックチェーントランザクションです。最終確定は 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 を送信し、1 接続あたり最大 500 インストゥルメントをサポートする点に留意してください。

運用上の制限とエッジケース

• ティックサイズの変更：価格が極端な水準に近づくとティックサイズは $0.01 から $0.001 に細かくなります。WebSocket は tick_size_change イベントを発行します。マッチングと価格表示ロジックはこれに対応する必要があります。
• UMA の紛争と解決遅延：Relayer にもオラクルや解決リスクを除去する力はありません。UMA の紛争は清算を一時停止する可能性があるため、リデンプションの遅延に対する UX を用意してください。
• 手数料と経済性：Maker は手数料ゼロ、Taker はカテゴリにより変動（0%–1.8%）。Relayer が市場の手数料体系を変更するわけではありません。

ツールやボットへの影響

Polymarket 上で動作するツールを構築する場合、ユーザーフローには Relayer Client SDK を利用し、サーバー側では署名、冪等性、ビルダー向けのアトリビューションヘッダ管理を担当させてください。マーケットデータには公開 API を、低レイテンシなブック更新には Market WS を使用します。スリッページ、部分約定、解決の遅延などの非決定論的な結果を考慮し、UI 上で明示してください。

まとめ

Polymarket relayer explained: Relayer は Polymarket をガスレスに感じさせる運用層です。開発者にとってはウォレットデプロイ、承認、CTF 操作、転送、注文送信を SDK とスポンサー付きトランザクションフローの背後に集約します。公開 API と Relayer Client SDK を使って、レート制限と地理的制約を尊重しつつ予測可能でユーザーフレンドリーな取引体験を構築してください。

参考資料

• 開発者向けガイド: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• アービトラージ参照: /guides/polymarket-arbitrage-complete-guide

よくある質問

Polymarket Relayer は具体的に何をスポンサーするのですか？

Relayer は Polygon PoS 上でのユーザー向けオンチェーン操作のガスをスポンサーします。対象は Proxy ウォレットのデプロイ、pUSD の ERC‑20 承認、CTF の split/merge/redeem、トークン転送、CLOB 上の注文配置を含みます。Relayer はユーザー署名済みインテントをスポンサー付きトランザクションにラップして Polygon に提出します。

ガスがスポンサーされていても取引に pUSD は必要ですか？

必要です。Polymarket は決済通貨として pUSD（Polymarket のラップされた USDC）を使用します。Relayer はガスのみをスポンサーするため、マーケットとやり取りするための十分な pUSD 残高と必要な承認はユーザーが用意する必要があります。

ビルダーは Relayer 経由で注文をルーティングして報酬を得られますか？

はい。Builder Program はサードパーティが CLOB を経由して注文をルーティングし、アトリビューションヘッダを付与してビルダーフィー（ベーシスポイント）を獲得できる仕組みです。階層（Unverified、Verified、Partner）ごとに日次の Relayer 制限と報酬が定められています。ビルダー資格情報は 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 があっても残る運用リスクは何ですか？

ガスのスポンサーにより POL を保持する必要はなくなりますが、以下のリスクは残ります：UMA の解決に関する紛争による清算遅延、CLOB 上のスリッページと部分約定、Polymarket による手数料体系の変更、スマートコントラクトリスク、IP によるジオ制限。