الرئيسية · تعلّم · برنامج مطوري PredictAsiaX

برنامج مطوري PredictAsiaX

تاريخ النشر 2026-09-079 دقيقةالمطوّر
ملخص سريع
يضم برنامج مطوري PredictAsiaX ثلاثة مستويات — Verified (افتراضي عند الموافقة)، Genesis (أول 20 مقعداً، يُمنح حسب الجدارة، حدود معدل 10×)، وPartner (يُتفاوض عليه فردياً، حتى 20×). تُدفع المنح بـ PAX مع نضج (Vesting) خطي بعد فترة انتظار (Cliff) عبر ثلاثة مسارات (Hackathon 500–2,000، Builder 5,000–50,000، Partner 100,000–500,000) بحد أقصى 2M / 5M / 15M PAX شهرياً / ربع سنوياً / سنوياً. سطح API يتكون من 38 مسار REST عبر 14 مجموعة وسوم بالإضافة إلى بث WebSocket بـ 48 نوع حدث بالإضافة إلى خادم MCP بأدوات 44. بيئة الاختبار (Sandbox) مجهولة الهوية، ذاتية الخدمة، على مضيف الإنتاج مع حدود $10 / $100 ومفتاح لمدة 30 يوماً.

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. 44 tools exposed on mcp.predictasiax.com, 17 public (no auth) and 27 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 PAX_ACCESS_KEY / PAX_TIMESTAMP / PAX_PASSPHRASE / PAX_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, which identifies the builder whose interface routed the specific trade and, where applicable, the builder that first attributed the trading user. Attributed trades earn the builder a share of the trading fee. 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

  1. Open builders.predictasiax.com and submit a builder application — product description, target users, expected volume.
  2. Get approved to Verified and receive a tier-flagged sk_live_* API key.
  3. Build against the sandbox tier ($10 max per order, $100 daily notional, mid-price simulated fills).
  4. 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.
  5. Apply for Genesis (first 20 slots, merit-awarded) or Partner (negotiated) after demonstrating shipped product and traction.

خصم التخرج لحاملي PAX

يرتقي حاملو PAX على المدى الطويل في مستويات Builder عبر وديعة تخرّج مخفَّضة، ويزداد حجم هذا الخصم وفقًا لمستواك كحامل لـ PAX.

عرض سلّم مستويات PAX

الأسئلة الشائعة

ما هو برنامج مطوري PredictAsiaX؟

برنامج المطوّر هو الطريقة التي يبني بها المطوّرون من أطراف ثالثة، والوكلاء، وشركاء التكامل على منصة PredictAsiaX. يوفر البرنامج واجهة API (38 مسار REST عبر 14 مجموعة وسوم بالإضافة إلى تدفق WebSocket يحتوي على 48 نوع حدث)، ونسبة إرجاع (attribution) للصفقات المُوجَّهة عبر واجهتك، وبرنامج منح مقوّم بـ PAX، وهيكل تجاري من ثلاث طبقات (Verified / Genesis / Partner) مع مزايا متدرّجة.

ما هي طبقات المطوّر الثلاث؟

تُعد طبقة Verified هي الطبقة الافتراضية التي يبدأ بها كل مطوّر معتمد، مع حدود معدل أساسية ووصول قياسي إلى الـ API. أما طبقة Genesis فهي طبقة تُمنح بناءً على الجدارة، وتقتصر على أول 20 مقعداً، وتتميز بحدود معدل أعلى بـ 10 أضعاف، وموضع مميز في دليل /builders، ووصول مبكر إلى واجهات API غير الصادرة بعد، ونطاق منح موسّع. بينما تُتفاوض طبقة Partner فردياً للتكاملات عالية التدفق، والبورصات، وصنّاع السوق، وتوفر حدود معدل تصل إلى 20 ضعفاً، وقنوات حساب مخصصة، وتسويق مشترك، وأكبر نطاق منح. تفاصيل الطبقات الكاملة متاحة على builders.predictasiax.com و docs.predictasiax.com/builders.

كيف يعمل برنامج منح PAX؟

تُدفع المنح بعملة PAX، وهي العملة الأصلية للمنصة، مع نظام استحقاق يجمع بين فترة انتظار (cliff) واستحقاق خطي. هناك ثلاثة مسارات: هاكاثون (500–2,000 PAX، بدون فترة انتظار، استحقاق خطي لمدة 6 أشهر تقريباً، قرار خلال 48 ساعة، يتطلب مستودع GitHub عام وعرضاً توضيحياً)، ومطوّر (5,000–50,000 PAX، فترة انتظار 3 أشهر واستحقاق خطي لمدة 12 شهراً، مجموعة أسبوعية، يتطلب رابطاً نشطاً مع وقت تشغيل يتجاوز 30 يوماً وإما ≥100 مستخدم أو حجم تداول مُوجَّه بقيمة $10,000)، وشريك (100,000–500,000 PAX، فترة انتظار 6 أشهر واستحقاق خطي لمدة 24 شهراً، أربعة بوابات مراحل بنسبة 25% لكل منها، مجموعة شهرية). السقوف الميزانية هي 2M PAX شهرياً، و5M كل ربع سنة، و15M سنوياً — الطلبات التي تتجاوز السقف تعيد GRANT_BUDGET_EXCEEDED.

كيف أصادق على الـ API؟

يُدعم ثلاثة مخططات مصادقة. (1) مفتاح API — أنشئ مفتاحاً من الإعدادات → مفاتيح API أو من POST /v1/sandbox-keys، ثم أرسله في ترويسة X-Api-Key. جميع المفاتيح تبدأ ببادئة sk_live_*؛ ويتم تمييز بيئة الاختبار (sandbox) عبر tier=self_serve على المفتاح، وليس عبر البادئة. (2) HMAC — وقّع الطلبات بأربع ترويسات باسم PAX_ACCESS_KEY، PAX_TIMESTAMP، PAX_PASSPHRASE، و PAX_SIGNATURE، حيث التوقيع = base64(HMAC-SHA256(secret, timestamp + method + path + body)). (3) Bearer الجلسة للتطبيقات التفاعلية التي تحتفظ بجلسة مستخدم. التفاصيل الكاملة في دليل المصادقة في التوثيق.

كيف تعمل بيئة الاختبار (Sandbox)؟

سري، ذاتي الخدمة، ولا يتطلب بريدًا إلكترونيًا. أرسل طلب POST إلى /v1/sandbox-keys واستلم مفتاح sk_live_* بمستوى tier=self_serve. يعمل بيئة الاختبار (Sandbox) على نفس مضيف الإنتاج — بدون عنوان URL منفصل — مع محاكاة التنفيذ عند السعر المتوسط. حدود لكل مفتاح: 10$ كحد أقصى لكل أمر، و100$ كحد أقصى للقيمة الاسمية اليومية، وصلاحية المفتاح لمدة 30 يومًا. تستغرق جولة كاملة باستخدام curl (من إصدار المفتاح → عرض الأسواق → تقديم أمر بقيمة 1$ → قراءة تقسيم العمولة → الإلغاء) حوالي 5 دقائق.

ما هي واجهة API المتاحة؟

38 مسار REST و42 عملية عبر 14 مجموعة وسوم: Discovery، Builders، Apps، Attribution، Revenue، Connect، Subaccounts، Composer، Liquidity، Data، Webhooks، Marketplace، Oracle، وSandbox. بالإضافة إلى WebSocket API بتوصيلة واحدة متعددة الإرسال و48 نوع حدث عبر بيانات السوق، الجولة السريعة، الحساب، الأمان، والتشغيل. مبادئ التصميم: صيغة استجابة مغلفة (envelope)، تمثيل المبالغ كنص عشري (decimal string)، معرّفات أسواق حتمية (m_<sha256[0:16]>)، وترويسة X-PII-Redacted موجودة دائمًا.

ما هو تكامل MCP؟

يعرض mcp.predictasiax.com خادم بروتوكول سياق النموذج (Model Context Protocol) مع 44 أداة يمكن للمساعدات الذكية (Claude Desktop، Claude Code، وأي عميل متوافق مع MCP) استدعاؤها مباشرة — 17 منها عامة و27 تتطلب مفتاح API. تعمل الأدوات العامة دون مصادقة (مثل pax.market_search، pax.probability_movers، pax.resolution_evidence، pax.sandbox_agent_examples). تتطلب أدوات الحساب والتداول مفتاح API (مثل pax.portfolio_read، pax.place_order، pax.cancel_order). تتوفر مخططات الأدوات الكاملة على mcp.predictasiax.com/mcp/manifest.json.

كيف يتم كسب نسبة التداول (Attribution)؟

تُسجَّل نسبة التداول في نية الأمر الموقّعة، التي تحدد المطوّر الذي وجّه الصفقة. تمنح الصفقات المنسوبة المطوّر جزءاً من رسوم التداول، وتدخل النسبة المُسوّاة في سجل الأحداث المالية الذي يمكن للمطوّر الاطلاع عليه عبر بوابة المطورين (builders.predictasiax.com). تُحتجز المدفوعات لمراجعة مكافحة الإساءة ثم تُجمّع وتُرسل إلى عنوان USDT المسجّل لديك.

كيف أنتقل من بيئة الاختبار (Sandbox) إلى الإنتاج؟

قدّم طلبك عبر builders.predictasiax.com للوصول إلى فئة Verified. بمجرد الموافقة، ستحصل على مفتاح API إنتاجي من نوع sk_live_* يحمل علامة الفئة. تعمل نفس نقاط النهاية، ونفس المخططات، ونفس المصادقة — يتغير فقط علم الفئة على المفتاح. من فئة Verified يمكنك بناء الأهلية للوصول إلى فئة Genesis (أول 20 مقعداً، تُمنح بناءً على المنتج المُسلَّم والانتشار) أو فئة Partner (تُتفاوض عليها فردياً).