Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: Relayer adalah lapisan gas-station yang mensponsori setiap aksi on-chain pengguna sehingga trader tidak pernah membayar gas. Panduan ini membimbing pengembang dan pengguna yang ingin tahu melalui tanggung jawab Relayer, SDK untuk pengembang, alur transaksi umum (deployment wallet, ERC-20 approvals, CTF split/merge/redeem, transfer, dan penempatan order), serta batas operasional yang perlu Anda pertimbangkan untuk membangun alat yang andal.

Key takeaways

• Relayer adalah lapisan Gas Station Network yang mensponsori transaksi di Polygon PoS sehingga pengguna bertransaksi tanpa gas menggunakan pUSD.
• Alur umum yang ditangani Relayer: deployment Proxy wallet, ERC‑20 approvals, CTF split/merge/redeem, transfer, dan penempatan order CLOB.
• Ada permukaan API dan SDK yang harus Anda gunakan: Relayer Client SDK (TypeScript/Python) dan tiga REST API publik untuk pembacaan market dan data.
• Builders dapat merutekan order melalui Polymarket dengan atribusi dan mendapatkan builder fees; berlaku batas berbasis tier.
• Selalu rancang untuk eksekusi non-deterministik: dispute resolusi UMA, slippage, partial fills, dan timing settlement tetap merupakan risiko operasional.

Why the Relayer exists

Polymarket berjalan di Polygon PoS (chain ID 137) dan menggunakan pUSD (Polymarket's wrapped USDC) sebagai aset settlement. Relayer mensponsori gas sehingga pengguna akhir tidak pernah memegang POL atau membayar gas untuk operasi on-chain. Ini menghilangkan lapisan friksi pengguna dan membuat trading terasa native untuk wallet seperti MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase dan wallet yang kompatibel EIP-6963.

High-level architecture

Relayer berperan sebagai Gas Station Network (GSN) — ia menerima user intents yang ditandatangani secara off-chain, membungkusnya menjadi transaksi bersponsor, dan mengirimkan transaksi tersebut ke Polygon. Dari perspektif pengembang, Anda berinteraksi dengan dua kelas antarmuka:

• Public read APIs dan WebSocket untuk data market dan buku order (Gamma, Data, CLOB, dan Market WS). Lihat base URL tepatnya di bawah.
• Relayer Client SDK (TypeScript dan Python) yang menangani deployment wallet, approvals, operasi CTF, dan penempatan order dengan alur sponsor.

Important public endpoints and surfaces

• 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 and trading): https://clob.polymarket.com — catatan: trading membutuhkan API key + HMAC untuk builders; pembacaan bersifat publik
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

Penggunaan API dan rate limit yang tepat didokumentasikan oleh Polymarket; gunakan endpoint Gamma /markets untuk daftar market (limit hingga 1000, gunakan after_cursor untuk pagination).

Common sponsored flows (developer view)

1. Wallet deployment

Polymarket mendukung Gnosis Safe (pre-deployed) dan Proxy wallets (auto-deployed pada transaksi pertama). Relayer membayar biaya gas untuk deployment proxy ketika Anda melakukan aksi bersponsor pertama. Dari SDK ini biasanya otomatis: SDK mendeteksi tidak ada wallet dan meminta Relayer mengirimkan transaksi deployment yang ditandatangani oleh pengguna.

2. ERC-20 approvals

Pengguna berdagang secara eksklusif dengan pUSD. Alur approval yang disponsori Relayer mengirimkan ERC-20 approvals (dan allowance terkait) atas nama pengguna sehingga mereka dapat berinteraksi dengan kontrak CTF dan Exchange tanpa memegang POL. SDK biasanya melakukan batching dan mengelola approvals untuk mengurangi friksi.

3. CTF operations: split / merge / redeem

Outcome shares adalah token ERC-1155 yang dimintakan melalui Gnosis Conditional Token Framework (CTF). Operasi CTF yang umum — split (mint satu set lengkap dari $1.00 pUSD), merge (burn set kembali ke pUSD), dan redeem (burn token pemenang untuk $1.00 setelah resolusi) — semuanya didukung melalui Relayer. Interaksi on-chain ini dikirim sebagai transaksi bersponsor oleh Relayer.

4. Transfers and withdrawals

Transfer token outcome dan pUSD, serta langkah penarikan eksplisit, dieksekusi melalui transaksi yang didukung Relayer sehingga pengguna dapat memindahkan dana tanpa membayar gas. Jaga sinyal UX untuk transaksi yang sedang dipending oleh relayer — transaksi tersebut bersifat on-chain tetapi mungkin terlihat kemudian melalui Data API.

5. Order placement on the CLOB

Penempatan order (limit atau market/FAK) dirutekan melalui CLOB. Builders yang merutekan order menggunakan API keys + HMAC untuk trading terautentikasi dengan header atribusi. Relayer Client SDK mengintegrasikan pembuatan order dan, bila sesuai, menangani semantik FAK untuk market order. Maker fee adalah nol; taker fee bervariasi menurut kategori.

Builder program and attribution

Pihak ketiga dapat merutekan order melalui CLOB dan mendapatkan builder fees yang dikreditkan dalam basis poin. Tier mencakup Unverified (batas harian relayer 100), Verified (batas harian 10.000 dan reward USDC mingguan), dan Partner (tanpa batas). Kredensial builder diperoleh di https://polymarket.com/settings dan Relayer Client SDK mengimplementasikan autentikasi serta header atribusi yang diperlukan untuk berpartisipasi.

Practical developer concerns

• Idempotency and retries: Karena Relayer mengirimkan transaksi on-chain untuk Anda, rancang alur idempotent dan logika retry yang tangguh. SDK membantu tetapi backend Anda harus de-dupe signed intents.
• UX for pending state: Tampilkan status pending/cancelled/confirmed yang jelas. Transaksi yang direlay adalah transaksi blockchain nyata; gunakan Data API dan Market WS untuk mencerminkan finalitas.
• Rate limits: Endpoint Gamma /markets dibatasi (300 req / 10 s untuk /markets; gabungan listing /markets + /events limit 900 req / 10 s). Batas keseluruhan API adalah 4000 req / 10 s. Hormati ini dalam pekerjaan polling atau indexing.
• Security: Relayer menandatangani dan mengirimkan transaksi menggunakan infrastrukturnya. Jangan menganggap custody private-key; aplikasi Anda tetap harus meminta signature pengguna untuk intents.
• Geo restrictions: Polymarket memblokir order berdasarkan IP. Aplikasi Anda harus menghormati pembatasan ini; jangan menyarankan solusi VPN.

Testing and local development

Polymarket menyediakan client SDK dalam TypeScript dan Python. Gunakan SDK untuk memmock alur bersponsor selama pengembangan. Untuk pembacaan market gunakan endpoint publik Gamma, Data, dan CLOB serta Market WS untuk feed real-time. Ingat WebSocket mengirim PING setiap 10 detik dan mendukung hingga 500 instrument per koneksi.

Operational limits and edge cases

• Tick size changes: Ukuran tick mengencang dari $0.01 ke $0.001 saat harga mendekati ekstrem; WebSocket mengirim event tick_size_change. Logika pencocokan dan tampilan harga Anda harus mendukung ini.
• UMA disputes and resolution delays: Relayer tidak bisa menghilangkan risiko oracle atau resolusi. Dispute UMA dapat menunda settlement; rencanakan UX untuk redeem yang tertunda.
• Fees and economics: Maker bebas biaya; taker fees bervariasi menurut kategori (0%–1.8%). Relayer tidak mengubah ekonomi fee pasar.

How this affects your trading tools and bots

Jika Anda membangun alat yang mengeksekusi di Polymarket, andalkan Relayer Client SDK untuk alur pengguna dan sediakan proses sisi-server untuk signing, idempotency, dan manajemen header atribusi untuk builders. Gunakan API publik untuk data market dan Market WS untuk pembaruan buku dengan latensi rendah. Perhitungkan hasil non-deterministik (slippage, partial fills, penundaan resolusi) dan tampilkan dengan jelas di UI Anda.

Closing

Polymarket relayer explained: ini adalah lapisan operasional yang membuat Polymarket terasa tanpa-gas. Bagi pengembang, ia memusatkan deployment wallet, approvals, operasi CTF, transfer, dan pengiriman order di balik SDK dan alur transaksi bersponsor. Gunakan API publik dan Relayer Client SDK untuk membangun pengalaman trading yang dapat diprediksi dan ramah pengguna sambil menghormati rate limit dan pembatasan geo.

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 mensponsori gas on-chain untuk operasi di Polygon PoS yang berorientasi pengguna, termasuk deployment Proxy wallet, ERC‑20 approvals untuk pUSD, CTF split/merge/redeem, transfer token, dan penempatan order di CLOB. Relayer pada dasarnya membungkus user-signed intents menjadi transaksi bersponsor yang dikirim ke Polygon.

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

Ya. Polymarket menggunakan pUSD (Polymarket's wrapped USDC) sebagai mata uang settlement. Relayer hanya mensponsori gas; Anda tetap membutuhkan saldo pUSD yang cukup dan approvals yang diperlukan untuk berinteraksi dengan market.

Can builders route orders through the Relayer and earn fees?

Ya. Builder Program memungkinkan pihak ketiga merutekan order melalui CLOB dengan header atribusi dan memperoleh builder fees dalam basis poin. Tier (Unverified, Verified, Partner) mengenakan batas harian relayer dan reward yang berbeda. Kredensial builder dikelola di https://polymarket.com/settings.

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

Gunakan REST API publik dan WebSocket: Gamma (https://gamma-api.polymarket.com) untuk markets, Data (https://data-api.polymarket.com) untuk positions dan trades, CLOB (https://clob.polymarket.com) untuk pembacaan order-book, dan Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) untuk event buku real-time.

What operational risks remain even with the Relayer?

Gas yang disponsori menghilangkan kebutuhan memegang POL, tapi risiko lain tetap ada: dispute resolusi UMA yang menunda settlement, slippage dan partial fills di CLOB, perubahan struktur fee oleh Polymarket, risiko smart-contract, dan geo-restrictions yang memblokir order berdasarkan IP.