Polymarket Builder Program: Tổng quan cho Nhà phát triển

Polymarket Builder Program là một kênh để các bên thứ ba định tuyến lệnh qua CLOB của Polymarket kèm attribution, kiếm builder fees tính theo basis point, và truy cập các lợi ích chương trình như giới hạn relayer cao hơn và phần thưởng. Hướng dẫn này giải thích cách chương trình hoạt động, ba cấp độ, nguyên tắc phân chia doanh thu, và các ghi chú tích hợp thực tiễn cho đội ngũ kỹ thuật dùng Polymarket Relayer Client.

Các điểm chính

• Builder Program cho phép bên thứ ba định tuyến lệnh qua CLOB kèm attribution và kiếm builder fees tính theo basis point.
• Có ba cấp độ (Unverified, Verified, Partner) với giới hạn relayer hàng ngày và phần thưởng tăng dần.
• Tích hợp builder thực hiện qua attribution headers và Polymarket Relayer Client SDK (TypeScript và Python) xử lý việc triển khai ví, approvals, thao tác CTF, và đặt lệnh.
• Maker fees trên Polymarket bằng zero; builder fees được trả cho builders khi thực thi và biểu diễn bằng basis point.
• Cấp quyền và cài đặt builder được quản lý tại polymarket.com/settings; chi tiết doanh thu và mức phí chính xác do Polymarket kiểm soát và có thể thay đổi.

Tại sao có Builder Program

Polymarket vận hành một Central Limit Order Book (CLOB) và tài trợ gas qua một Relayer. Builder Program cung cấp một cách chính thức để bên thứ ba thêm luồng lệnh vào CLOB đó trong khi nhận attribution và chia sẻ doanh thu (builder fees). Đối với các nhà phát triển xây dựng logic định tuyến, giao diện market-making, hoặc hạ tầng giao dịch, chương trình tạo ra một đường dẫn trực tiếp và được hỗ trợ để gửi flow vào sàn giao dịch của Polymarket.

Program tiers và ý nghĩa của chúng

H2: Ba cấp độ

• Unverified
  • Giới hạn relayer hàng ngày: 100 lệnh mỗi ngày.
  • Lợi ích: Chỉ có giao dịch gasless và attribution.
• Verified
  • Giới hạn relayer hàng ngày: 10,000 lệnh mỗi ngày.
  • Lợi ích: Phần thưởng USDC hàng tuần dựa trên khối lượng cộng với builder fees kiếm được theo basis point.
• Partner
  • Giới hạn relayer hàng ngày: Không giới hạn.
  • Lợi ích: Giới hạn tốc độ cao nhất và hỗ trợ nâng cao; truy cập các bậc phần thưởng cao nhất.

Đây là quy tắc cấp độ do Polymarket công bố. Cấp độ ảnh hưởng đến giới hạn rate limit của chương trình, điều kiện đủ nhận phần thưởng và mức hỗ trợ; chúng không thay đổi cơ chế cơ bản về cách áp dụng builder fees khi giao dịch được thực thi.

Cách builder fees và attribution hoạt động

Builder fees được cấu hình dưới dạng basis point trên các lệnh được định tuyến và được trả cho builder khi lệnh đó thực thi. Attribution được thực hiện qua các header xác định builder định tuyến; Relayer dùng các header này để ghi có cho builder tương ứng khi thực thi.

Các cơ chế quan trọng cần nhớ:

• Phí được biểu diễn bằng basis point và áp dụng khi thực thi; maker fees trên Polymarket vẫn bằng zero.
• Attribution headers là bắt buộc để giao dịch được ghi có cho một builder. Relayer và CLOB mong đợi các header này trong yêu cầu.
• Phần thưởng cho builders Verified bao gồm các khoản thanh toán USDC hàng tuần dựa trên khối lượng cộng với builder fees tích lũy; tier Partner có phần thưởng và hỗ trợ nâng cao.

Polymarket kiểm soát mức phí chính xác và công thức phần thưởng. Các builder không nên giả định mức cố định; kiểm tra polymarket.com/settings để biết thông tin cấp quyền và cấu hình builder hiện tại.

Tích hợp với Polymarket Relayer Client

H2: Polymarket Relayer Client (TypeScript & Python)

Polymarket cung cấp SDK Relayer Client chính thức bằng TypeScript và Python để đơn giản hóa việc tích hợp. Client xử lý các tác vụ phổ biến cho end-user để tích hợp của bạn có thể tập trung vào logic định tuyến và chiến lược lệnh.

Những việc client quản lý cho bạn:

• Triển khai ví và xử lý Proxy hoặc Gnosis Safe
• ERC-20 approvals cho pUSD
• Thao tác CTF (split/merge/redeem) cho token outcome
• Tạo và hủy lệnh, bao gồm lệnh thị trường được hiển thị như FAK
• Ký yêu cầu với attribution headers của builder khi được yêu cầu

Sử dụng Relayer Client giảm ma sát kỹ thuật và đảm bảo yêu cầu phù hợp với kỳ vọng của Relayer Polymarket (giới hạn rate, headers và ngữ nghĩa CLOB).

Checklist tích hợp thực tế

H2: Checklist triển khai cho builders

1. Lấy chứng chỉ
   • Nhận builder credentials và đặt tier của bạn tại polymarket.com/settings. Điều này điều khiển giới hạn relayer và điều kiện đủ nhận phần thưởng.
2. Chọn SDK
   • Dùng Relayer Client TypeScript hoặc Python để tăng tốc tích hợp và tránh cấu hình sai ở mức thấp.
3. Thêm attribution
   • Đảm bảo mỗi lệnh định tuyến bao gồm các attribution headers bắt buộc để Relayer có thể ghi có cho tài khoản builder của bạn.
4. Xử lý approvals và ví
   • Dùng client để quản lý approvals pUSD và triển khai ví; Relayer tài trợ gas, nên end users vẫn không tốn gas.
5. Giám sát giới hạn
   • Thiết lập quota trong hệ thống của bạn để tránh vượt quá giới hạn relayer hàng ngày theo tier. Unverified giới hạn 100/ngày, Verified 10,000/ngày, Partner không giới hạn.
6. Tính toán phí và thanh toán
   • Theo dõi builder fee tích lũy bằng basis point và đối chiếu với các khoản phần thưởng hàng tuần nếu bạn là Verified hoặc Partner.

Cân nhắc kế toán và phân chia doanh thu

H2: Dòng chảy thanh toán

• Builder fees tích lũy khi lệnh được thực thi và được biểu diễn bằng basis point của giao dịch.
• Builders Verified nhận thanh toán USDC hàng tuần dựa trên khối lượng ngoài builder fees; tier Partner nhận phần thưởng tăng cường theo chương trình của Polymarket.
• Polymarket quản lý việc trả thực tế và công thức phía sau các phần thưởng hàng tuần; builders nên dùng dashboard tại polymarket.com/settings để báo cáo và chi tiết thanh toán.

Ghi chú vận hành và rủi ro

• Giới hạn rate của Relayer quan trọng: thực thi throttle cục bộ để tránh yêu cầu bị từ chối và hành vi bất ngờ.
• Các giao dịch định tuyến qua Relayer chịu các quy tắc của CLOB Polymarket: hành vi tick size, ngữ nghĩa FAK cho lệnh thị trường, và quy tắc maker/taker fees (maker không trả maker fees).
• Builders không loại bỏ các rủi ro vốn có của giao dịch trên thị trường dự đoán: rủi ro resolution (tranh chấp UMA có thể làm chậm việc thanh toán), trượt giá và khớp một phần, và rủi ro hợp đồng thông minh. Luôn hiển thị những rủi ro đó cho người dùng của bạn.

Ảnh hưởng tới hạ tầng giao dịch của bạn

H2: Tác động thực tế lên hệ thống của bạn

Nếu bạn vận hành một lớp định tuyến hoặc aggregator, Builder Program thay đổi hai điều: bạn có thể nhận doanh thu trực tiếp cho các lệnh bạn định tuyến, và bạn phải quản lý attribution cùng giới hạn relayer. Dùng Relayer Client cho các thao tác ví và token để tránh phải cài lại logic CTF và gasless. Thiết kế hệ thống để ghi nhận attribution cho mỗi lệnh, theo dõi phí basis-point tích lũy, và đối chiếu các khoản thanh toán hàng tuần từ Polymarket.

Tóm tắt kết thúc

Polymarket Builder Program là con đường dành cho nhà phát triển để thêm luồng lệnh vào CLOB của Polymarket kèm attribution và chia sẻ doanh thu. Với builders, các nhiệm vụ vận hành chính là lấy credentials, tích hợp attribution headers, sử dụng Polymarket Relayer Client (TypeScript hoặc Python), và tôn trọng giới hạn relayer theo tier. Builder fees được trả theo basis point khi thực thi, và builders Verified/Partner nhận cơ chế phần thưởng bổ sung do Polymarket quản lý.

Để biết chi tiết kỹ thuật hơn về CLOB và ngữ nghĩa thị trường, xem /guides/polymarket-clob-explained và để hiểu cấu trúc phí trên Polymarket xem /guides/polymarket-fees-explained.

Các câu hỏi thường gặp

Các cấp độ và giới hạn của Polymarket Builder Program là gì?

Có ba cấp độ: Unverified (giới hạn relayer hàng ngày 100), Verified (giới hạn relayer hàng ngày 10,000 cộng phần thưởng USDC hàng tuần và builder fees), và Partner (giới hạn relayer không giới hạn và hỗ trợ nâng cao). Các cấp độ này điều khiển giới hạn rate và điều kiện nhận phần thưởng.

Polymarket builder fees được trả như thế nào?

Builder fees được cấu hình theo basis point và trả cho builder được ghi có khi lệnh thực thi. Builders Verified cũng nhận phần thưởng USDC hàng tuần dựa trên khối lượng; cơ chế trả chính xác do Polymarket quản lý.

Tôi có cần quản lý gas hoặc triển khai ví không?

Không. Polymarket Relayer tài trợ gas cho end users. Relayer Client SDK (TypeScript và Python) xử lý triển khai ví (Proxy hoặc Gnosis Safe), approvals pUSD, và thao tác CTF để bạn có thể tập trung vào logic định tuyến.

Làm sao để đảm bảo giao dịch của tôi được ghi có cho tài khoản builder?

Bao gồm các attribution headers bắt buộc trong các yêu cầu định tuyến. Relayer dùng các header đó để ghi có cho builder của bạn. Dùng Relayer Client chính thức để đảm bảo headers và chữ ký đúng.

Tôi lấy credentials và cài đặt builder ở đâu?

Builder credentials và cài đặt tier được quản lý tại polymarket.com/settings. Dashboard đó điều khiển việc phát hành chứng chỉ, phân bổ tier, và báo cáo.