Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: Relayer là lớp gas-station giúp bảo trợ mọi hành động on-chain của người dùng để trader không bao giờ phải trả gas. Hướng dẫn này dẫn dắt nhà phát triển và người dùng tò mò qua các trách nhiệm của Relayer, các SDK dành cho nhà phát triển, các luồng giao dịch phổ biến (triển khai ví, ERC-20 approvals, thao tác CTF split/merge/redeem, chuyển token và đặt lệnh), và các giới hạn vận hành bạn cần biết để xây dựng công cụ bền vững.

Key takeaways

• Relayer là lớp mạng Gas Station Network (GSN) bảo trợ các giao dịch trên Polygon PoS để người dùng giao dịch không tốn gas bằng pUSD.
• Các luồng phổ biến do Relayer xử lý: triển khai Proxy wallet, ERC‑20 approvals, thao tác CTF (split/merge/redeem), chuyển tiền và đặt lệnh trên CLOB.
• Có các bề mặt API và SDK bạn nên dùng: Relayer Client SDK (TypeScript/Python) và ba REST API công khai cho đọc dữ liệu thị trường.
• Builders có thể chuyển lệnh qua Polymarket với attribution và kiếm builder fees; có giới hạn theo cấp độ.
• Luôn thiết kế cho trạng thái thực thi không xác định: tranh chấp UMA, trượt giá, khớp một phần, và độ trễ thanh toán vẫn là rủi ro vận hành.

Why the Relayer exists

Polymarket chạy trên Polygon PoS (chain ID 137) và dùng pUSD (Polymarket's wrapped USDC) làm tài sản thanh toán. Relayer bảo trợ gas để người dùng cuối không cần nắm giữ POL hay trả gas cho các thao tác on-chain. Việc này loại bỏ ma sát cho người dùng và giúp trải nghiệm giao dịch mượt mà trên các ví như MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase và bất kỳ ví tương thích EIP-6963 nào.

High-level architecture

Relayer hoạt động như một Gas Station Network (GSN) — nó nhận các intent đã ký của người dùng ngoài chuỗi, đóng gói chúng thành các giao dịch được bảo trợ và gửi các giao dịch đó lên Polygon. Từ góc nhìn nhà phát triển, bạn tương tác với hai lớp giao diện:

• Các API đọc công khai và một WebSocket cho dữ liệu thị trường và sổ lệnh (Gamma, Data, CLOB, và Market WS). Xem các base URL chính xác bên dưới.
• Relayer Client SDK (TypeScript và Python) xử lý triển khai ví, approvals, thao tác CTF và đặt lệnh theo luồng được bảo trợ.

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 — note trading requires API key + HMAC for builders; reads are public
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

Exact API usage and rate limits are documented by Polymarket; use the Gamma /markets endpoint for market listings (limit up to 1000, use after_cursor for pagination).

Common sponsored flows (developer view)

1. Wallet deployment

Polymarket hỗ trợ Gnosis Safe (pre-deployed) và Proxy wallets (auto-deployed khi thực hiện giao dịch đầu tiên). Relayer trả phí gas cho việc triển khai proxy khi bạn thực hiện hành động được bảo trợ đầu tiên. Từ SDK điều này thường là tự động: SDK phát hiện không có ví và yêu cầu Relayer gửi một tx triển khai đã được người dùng ký.

2. ERC-20 approvals

Người dùng giao dịch hoàn toàn bằng pUSD. Luồng approval do Relayer bảo trợ nộp các ERC-20 approvals (và allowances liên quan) thay cho người dùng để họ có thể tương tác với hợp đồng CTF và Exchange mà không cần nắm POL. SDK thường gom và quản lý approvals để giảm ma sát.

3. CTF operations: split / merge / redeem

Các cổ phần kết quả là token ERC-1155 được mint thông qua Gnosis Conditional Token Framework (CTF). Các thao tác CTF điển hình — split (mint một bộ đầy đủ từ $1.00 pUSD), merge (thiêu hủy bộ token để lấy lại pUSD), và redeem (đốt token thắng để nhận $1.00 sau khi resolution) — đều được hỗ trợ thông qua Relayer. Các tương tác on-chain này được Relayer gửi như các giao dịch được bảo trợ.

4. Transfers and withdrawals

Việc chuyển outcome token và pUSD, cũng như bất kỳ bước rút tiền rõ ràng nào, được thực hiện qua các giao dịch do Relayer hỗ trợ để người dùng có thể chuyển tiền mà không phải trả gas. Giữ tín hiệu UX cho các giao dịch đang chờ được relayed — chúng là giao dịch on-chain nhưng có thể quan sát được muộn hơn qua Data API.

5. Order placement on the CLOB

Đặt lệnh (limit hoặc market/FAK) được chuyển qua CLOB. Các Builder chuyển lệnh sử dụng API key + HMAC để giao dịch có xác thực kèm attribution headers. Relayer Client SDK tích hợp tạo lệnh và, khi phù hợp, xử lý ngữ nghĩa FAK cho lệnh market. Maker fees là zero; taker fees thay đổi theo category.

Builder program and attribution

Các bên thứ ba có thể chuyển lệnh qua CLOB và kiếm builder fees tính bằng basis points. Các tier gồm Unverified (giới hạn relayer hàng ngày 100), Verified (giới hạn hàng ngày 10,000 và rewards USDC hàng tuần) và Partner (không giới hạn). Builder credentials được cấp tại https://polymarket.com/settings và Relayer Client SDK triển khai xác thực và attribution headers cần thiết để tham gia.

Practical developer concerns

• Idempotency and retries: Vì Relayer gửi giao dịch on-chain thay bạn, hãy thiết kế luồng idempotent và logic retry vững chắc. SDK trợ giúp nhưng backend của bạn nên de-dupe các signed intents.
• UX for pending state: Hiển thị rõ các trạng thái pending/cancelled/confirmed. Các giao dịch được relayed là giao dịch blockchain thực; dùng Data API và Market WS để phản ánh tính cuối cùng.
• Rate limits: Endpoint /markets của Gamma có giới hạn (300 req / 10 s cho /markets; kết hợp /markets + /events là 900 req / 10 s). Tổng giới hạn API là 4000 req / 10 s. Tôn trọng các giới hạn này trong các job polling hoặc indexing.
• Security: Relayer ký và gửi giao dịch bằng cơ sở hạ tầng của nó. Đừng giả định custody private-key; ứng dụng của bạn vẫn nên yêu cầu chữ ký người dùng cho intents.
• Geo restrictions: Polymarket geo-blocks orders theo IP. Ứng dụng của bạn phải tuân thủ các giới hạn này; không khuyến nghị giải pháp VPN.

Testing and local development

Polymarket cung cấp client SDK bằng TypeScript và Python. Dùng SDK để mô phỏng các luồng được bảo trợ trong giai đoạn phát triển. Đối với đọc thị trường, dùng các endpoint công khai Gamma, Data và CLOB cùng Market WS cho dữ liệu thời gian thực. Nhớ rằng WebSocket phát PING mỗi 10 giây và hỗ trợ tối đa 500 instruments mỗi kết nối.

Operational limits and edge cases

• Tick size changes: Kích thước tick thắt chặt từ $0.01 xuống $0.001 khi giá ở vùng cực; WebSocket phát sự kiện tick_size_change. Logic khớp lệnh và hiển thị giá của bạn phải xử lý điều này.
• UMA disputes and resolution delays: Relayer không thể loại bỏ rủi ro oracle hoặc rủi ro resolution. Tranh chấp UMA có thể tạm dừng thanh toán; lên kế hoạch UX cho việc delay redeem.
• Fees and economics: Maker là zero-fee; taker fees thay đổi theo category (0%–1.8%). Relayer không thay đổi cơ chế phí thị trường.

How this affects your trading tools and bots

Nếu bạn xây dựng công cụ thực thi trên Polymarket, dựa vào Relayer Client SDK cho luồng người dùng và để các quá trình server-side chịu trách nhiệm ký, idempotency và quản lý attribution headers cho builders. Dùng public APIs cho dữ liệu thị trường và Market WS cho cập nhật sổ lệnh độ trễ thấp. Tính toán các kết quả không xác định (trượt giá, khớp một phần, delay resolution) và hiển thị chúng rõ ràng trong UI.

Closing

Polymarket relayer explained: đó là lớp vận hành giúp Polymarket có trải nghiệm không tốn gas. Đối với nhà phát triển, nó tập trung hóa triển khai ví, approvals, thao tác CTF, chuyển tiền và gửi lệnh sau một SDK và luồng giao dịch được bảo trợ. Dùng public APIs và Relayer Client SDK để xây dựng trải nghiệm giao dịch dễ đoán và thân thiện với người dùng trong khi tuân thủ rate limits và geo restrictions.

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 bảo trợ gas on-chain cho các thao tác hướng tới người dùng trên Polygon PoS, bao gồm triển khai Proxy wallet, ERC‑20 approvals cho pUSD, thao tác CTF split/merge/redeem, chuyển token và đặt lệnh trên CLOB. Relayer về cơ bản đóng gói các intent đã ký của người dùng thành các giao dịch được bảo trợ rồi gửi lên Polygon.

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

Có. Polymarket dùng pUSD (Polymarket's wrapped USDC) làm tiền tệ thanh toán. Relayer chỉ bảo trợ gas; bạn vẫn cần số dư pUSD đủ và các approvals cần thiết để tương tác với các thị trường.

Can builders route orders through the Relayer and earn fees?

Có. Builder Program cho phép bên thứ ba chuyển lệnh qua CLOB kèm attribution headers và kiếm builder fees tính bằng basis points. Các tier (Unverified, Verified, Partner) áp giới hạn relayer hàng ngày và phần thưởng khác nhau. Builder credentials được quản lý tại https://polymarket.com/settings.

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

Dùng public REST APIs và WebSocket: Gamma (https://gamma-api.polymarket.com) cho markets, Data (https://data-api.polymarket.com) cho positions và trades, CLOB (https://clob.polymarket.com) cho đọc order-book, và Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) cho sự kiện sổ lệnh thời gian thực.

What operational risks remain even with the Relayer?

Việc bảo trợ gas loại bỏ nhu cầu nắm giữ POL, nhưng các rủi ro khác vẫn tồn tại: tranh chấp UMA có thể làm chậm thanh toán, trượt giá và khớp một phần trên CLOB, thay đổi cấu trúc phí bởi Polymarket, rủi ro smart-contract, và geo-restrictions chặn lệnh theo IP.