Chương trình Builder PredictAsiaX có ba cấp bậc — Verified (mặc định khi được duyệt), Genesis (20 chỗ đầu tiên, dựa trên thành tích, giới hạn rate 10×), Partner (thương lượng cá nhân, lên đến 20×). Grant trả bằng PAX với vesting cliff + tuyến tính qua ba đường ray (Hackathon 500–2.000, Builder 5.000–50.000, Partner 100.000–500.000) giới hạn 2M / 5M / 15M PAX mỗi tháng / quý / năm. Bề mặt API là 38 đường REST qua 14 nhóm tag cộng stream WebSocket với 48 loại sự kiện cộng máy chủ MCP với 7 công cụ. Sandbox ẩn danh, tự phục vụ, trên host sản xuất với giới hạn $10 / $100 và khóa 30 ngày.
Who the Builder Program is for
The PredictAsiaX Builder Program serves developers, agents, market-making desks, and interface builders who want to route real prediction-market flow through their own product and be paid for it. If you are building a trading bot, an AI agent, a mobile front-end, an analytics dashboard, or an on-ramp that lets your users trade on PredictAsiaX, the Builder Program is where you get an API key, attribution, and a path to grants.
Three tiers, one promotion path
Every approved builder starts at Verified. Two higher tiers are earned or negotiated:
Verified— default on approval. Full API access, base rate limits, PAX grant eligible.
Genesis— first 20 slots, merit-awarded. 10× base rate limits (custom bursts negotiable), featured placement on the /builders directory with verified badge, early access to unreleased APIs, engineering direct channel with weekly office hours, expanded grant range.
Partner— individually negotiated for exchanges routing flow, market makers, and mainstream integrations. Up to 20× rate limits (fully negotiable per contract), dedicated account channel, co-marketing, fee-tier discount, and the largest grant range.
Tier promotion is based on shipped product and traction, not on payment. Genesis and Partner are earned by demonstrating live users and real volume through your integration.
The PAX grant program
Grants are paid in PAX, the platform's native token, with cliff-plus-linear vesting. Pull-claim semantics — vested tokens sit on the platform until you call claim() to move them into custody.
Hackathon — 500–2,000 PAX.Weekend hackathon winners, first integrations, small experiments. No cliff · roughly 6 months linear vest · 48-hour decision · public GitHub and demo required.
Builder — 5,000–50,000 PAX.Independent developers shipping a real product on PredictAsiaX. 3-month cliff · 12-month linear vest · weekly cohort · requires a live URL with more than 30 days of uptime and either ≥100 users or $10,000 in routed volume.
Partner — 100,000–500,000 PAX.Exchanges routing flow, market makers, and mainstream integrations. 6-month cliff · 24-month linear vest · four milestone gates at 25 % each · monthly cohort · co-marketing and dedicated channel.
Budget caps enforced: 2M PAX per month, 5M per quarter, 15M per year. Applications beyond the cap return GRANT_BUDGET_EXCEEDED immediately. Current usage is queryable through the admin grants budget endpoint.
The API surface, at a glance
REST.38 paths and 42 operations across 14 tag groups: Discovery, Builders, Apps, Attribution, Revenue, Connect, Subaccounts, Composer, Liquidity, Data, Webhooks, Marketplace, Oracle, Sandbox. Envelope response format, Money always a decimal string, deterministic market IDs of the form m_.
WebSocket.A single multiplexed connection carrying 48 event types across market data, fast round, account, security, and ops. Subscribe with method SUBSCRIBE and a list of channels.
MCP.Seven tools exposed on mcp.predictasiax.com, four read-only (no auth) and three that require an API key. See verifiable settlement for the audit endpoints and Merkle inclusion flow.
Auth.Three schemes: API Key (sk_live_* via X-Api-Key), HMAC (four headers POLY_ACCESS_KEY / POLY_TIMESTAMP / POLY_PASSPHRASE / POLY_SIGNATURE), Session Bearer.
Sandbox in 30 seconds
Anonymous, self-serve, no email:
{`curl -X POST https://api.predictasiax.com/v1/sandbox-keys
# → { "api_key": "sk_live_...", "tier": "self_serve",
# "limits": { "max_order_usdt": 10, "daily_notional_usdt": 100 },
# "expires_at": "…30 days from now…" }`}
Same production host, fills simulated at mid-price, capped at $10 per order and $100 daily notional, key valid for 30 days. Five-minute walkthrough: mint → list markets → place a $1 order → read the resulting fee split → cancel.
Attribution and payouts
Attribution is captured in the signed order intent — the execution_builder_id field identifies the builder whose interface routed the specific trade, and, where applicable, acquisition_builder_id identifies the builder that first attributed the trading user. Attributed trades participate in the fee split; the taker fee is 50 bps of notional. Payouts are held for anti-abuse review and then batched in USDT to the wallet address you register in the Builder Portal.
How to apply
Open builders.predictasiax.com and submit a builder application — product description, target users, expected volume.
Get approved to Verified and receive a tier-flagged sk_live_* API key.
Build against the sandbox tier ($10 max per order, $100 daily notional, mid-price simulated fills).
Ship to production. Every fill writes an attributed record to the shared ledger; payouts batch to your registered USDT address after the anti-abuse hold.
Apply for Genesis (first 20 slots, merit-awarded) or Partner (negotiated) after demonstrating shipped product and traction.
PAX Holder Graduation Discount
Long-term PAX holders climb Builder tiers with a discounted graduation deposit. The discount scales with your PAX Holder tier (30-day rolling USD × continuous-days-held).
Bronze ($100 for 7 days) — −10% off graduation threshold
Silver ($500 for 30 days) — −20% off
Gold ($5,000 for 90 days) — −30% off
Platinum ($50,000 for 180 days) — −50% off
Diamond ($500,000 for 365 days) — −70% off
The discount is applied automatically by the tier graduation cron. Track your progress at the Tier Center.
Câu hỏi thường gặp
Chương trình Builder PredictAsiaX là gì?
Chương trình Builder là cách các nhà phát triển bên thứ ba, đại lý, và đối tác tích hợp xây dựng trên nền PredictAsiaX. Nó cung cấp bề mặt API (38 đường REST qua 14 nhóm tag cộng stream WebSocket với 48 loại sự kiện), attribution cho các trade được định tuyến qua giao diện của bạn, chương trình grant tính bằng PAX, và cấu trúc thương mại ba cấp (Verified / Genesis / Partner) với lợi ích lũy tiến.
Ba cấp bậc Builder là gì?
Verified là cấp bậc mặc định mỗi Builder đã duyệt bắt đầu, với giới hạn rate cơ bản và quyền truy cập API tiêu chuẩn. Genesis là cấp bậc dựa trên thành tích với giới hạn 20 chỗ đầu tiên, với giới hạn rate 10×, hiển thị nổi bật trên thư mục /builders, quyền truy cập sớm vào các API chưa phát hành, và phạm vi grant mở rộng. Partner được thương lượng cá nhân cho tích hợp lưu lượng cao, sàn giao dịch, và market maker, với giới hạn rate lên đến 20×, kênh tài khoản chuyên dụng, đồng tiếp thị, và phạm vi grant lớn nhất. Chi tiết cấp bậc đầy đủ tại builders.predictasiax.com và docs.predictasiax.com/builders.
Chương trình grant PAX hoạt động như thế nào?
Grant được trả bằng PAX, token gốc của nền tảng, với vesting cliff + tuyến tính. Ba đường ray: Hackathon (500–2.000 PAX, không cliff, khoảng 6 tháng vest tuyến tính, quyết định 48 giờ, cần GitHub công khai và demo), Builder (5.000–50.000 PAX, cliff 3 tháng và vest tuyến tính 12 tháng, cohort hàng tuần, cần URL live với uptime >30 ngày và hoặc ≥100 người dùng hoặc $10.000 khối lượng định tuyến), và Partner (100.000–500.000 PAX, cliff 6 tháng và vest tuyến tính 24 tháng, bốn cổng milestone mỗi cổng 25 %, cohort hàng tháng). Giới hạn ngân sách là 2M PAX mỗi tháng, 5M mỗi quý, 15M mỗi năm — đơn vượt giới hạn trả về GRANT_BUDGET_EXCEEDED.
Tôi xác thực với API như thế nào?
Ba lược đồ xác thực được hỗ trợ. (1) API Key — đúc một khóa từ Settings → API Keys hoặc từ POST /v1/sandbox-keys, sau đó gửi trong header X-Api-Key. Tất cả khóa có tiền tố sk_live_*; sandbox được phân biệt bằng tier=self_serve trên khóa, không phải bằng tiền tố. (2) HMAC — ký request với bốn header có tên POLY_ACCESS_KEY, POLY_TIMESTAMP, POLY_PASSPHRASE, và POLY_SIGNATURE, trong đó signature = base64(HMAC-SHA256(secret, timestamp + method + path + body)). (3) Session Bearer cho các ứng dụng tương tác giữ phiên người dùng. Chi tiết đầy đủ trong hướng dẫn xác thực docs.
Sandbox hoạt động như thế nào?
Ẩn danh, tự phục vụ, không cần email. POST đến /v1/sandbox-keys và nhận khóa sk_live_* với tier=self_serve. Sandbox nằm trên cùng host sản xuất — không có URL riêng — với khớp lệnh mô phỏng theo giá trung bình. Giới hạn mỗi khóa: tối đa $10 mỗi lệnh, $100 danh nghĩa hàng ngày, khóa có hiệu lực 30 ngày. Hướng dẫn curl đầy đủ (đúc → liệt kê thị trường → đặt lệnh $1 → đọc phân chia phí → hủy) mất khoảng 5 phút.
Bề mặt API nào có sẵn?
38 đường REST và 42 hoạt động qua 14 nhóm tag: Discovery, Builders, Apps, Attribution, Revenue, Connect, Subaccounts, Composer, Liquidity, Data, Webhooks, Marketplace, Oracle, và Sandbox. Cộng với API WebSocket với một kết nối đa kênh và 48 loại sự kiện qua market data, fast round, account, security, và ops. Nguyên tắc thiết kế: định dạng phản hồi envelope, Money là chuỗi decimal, ID thị trường xác định (m_<sha256[0:16]>), và header X-PII-Redacted luôn có mặt.
Tích hợp MCP là gì?
mcp.predictasiax.com phơi bày máy chủ Model Context Protocol với 7 công cụ mà trợ lý AI (Claude Desktop, Claude Code, và bất kỳ client tương thích MCP nào) có thể gọi trực tiếp. Công cụ chỉ đọc hoạt động không cần xác thực: pax.market_search, pax.probability_movers, pax.resolution_evidence, pax.sandbox_agent_examples. Công cụ ghi và tài khoản cần API key: pax.portfolio_read, pax.place_order, pax.cancel_order. Schema công cụ đầy đủ tại mcp.predictasiax.com/mcp/manifest.json.
Attribution trade được kiếm như thế nào?
Attribution được ghi trong order intent đã ký — các trường execution_builder_id và (khi áp dụng) acquisition_builder_id xác định Builder nào định tuyến trade. Các trade được attribution tham gia phân chia phí, và attribution đã thanh toán chảy vào sổ cái financial event mà Builder có thể thấy qua Builder Portal (builders.predictasiax.com). Phí taker là 50 bps danh nghĩa. Thanh toán được giữ lại để xem xét chống lạm dụng và sau đó gộp đến địa chỉ USDT đã đăng ký của bạn.
Tôi chuyển từ sandbox sang sản xuất như thế nào?
Đăng ký qua builders.predictasiax.com để lên cấp Verified. Khi được duyệt bạn nhận khóa API sản xuất sk_live_* có cờ cấp bậc. Cùng endpoint, cùng schema, và cùng xác thực hoạt động — chỉ có cờ cấp bậc trên khóa thay đổi. Từ Verified bạn có thể tích lũy đủ điều kiện cho Genesis (20 chỗ đầu tiên, dựa trên thành tích với sản phẩm đã ship và traction) hoặc Partner (thương lượng cá nhân).
