حدود المعدل في Polymarket API: المرجع الكامل

إذا حاولت يومًا الإجابة عن سؤال بسيط — كم طلبًا في الثانية يمكنني إرساله إلى Polymarket؟ — فستكون قد اكتشفت أنه لا توجد إجابة بسيطة. الحدود موزعة على نظامين منفصلين، ومنشورة في صفحات مختلفة، ومعبَّر عنها بـنافذة 10 ثوانٍ بدلًا من الأرقام لكل ثانية أو لكل دقيقة التي تستخدمها معظم واجهات API.

لمعرفة الحد على مسار محدد، لكل نقطة نهاية أيضًا صفحتها الخاصة في مرجع Polymarket API.

تجمع هذه الصفحة كل حد موثق في مكان واحد، وتشرح النظامين، وتبيّن ما يحدث فعلًا حين تتجاوز الخط. جميع الأرقام مأخوذة من الوثائق الرسمية لـ Polymarket وهي محدّثة حتى سبتمبر 2026.

نظامان مختلفان لحدود المعدل

هذا الجزء الذي يوقع معظم المطورين. تشغّل Polymarket محدِّدَين مستقلين، والبقاء تحت أحدهما لا يحميك من الآخر.

حدود المعدل في Gamma API

عنوان URL الأساسي https://gamma-api.polymarket.com. تقدّم Gamma البيانات الوصفية للأسواق والأحداث — وهي نقاط النهاية التي يستدعيها معظم الناس أولًا عند استكشاف المنصة.

حدود المعدل في Data API

عنوان URL الأساسي https://data-api.polymarket.com. المراكز وسجل الصفقات وبيانات المحفظة. لاحظ كم هذه الواجهة أضيق من Gamma أو CLOB — فالحد العام 1,000 طلب / 10 ثوانٍ، أي ربع حد Gamma.

Data API v2

أُطلقت Data API v2 في 4 سبتمبر 2026 على https://data-api.polymarket.com/v2 بحدودها الخاصة. لا تزال v1 تعمل لكنها مجمّدة — نقاط النهاية والحقول الجديدة تُضاف إلى v2 فقط.

حدود المعدل في CLOB API

عنوان URL الأساسي https://clob.polymarket.com. دفتر الأوامر نفسه. تملك CLOB أعلى سماحية عامة بين واجهات Polymarket API (9,000 طلب / 10 ثوانٍ) لكنها تنقسم إلى أربع مجموعات متمايزة بحدود مختلفة جدًا.

عام

بيانات الأسواق

النمط الذي يجب ملاحظته هنا: نقاط النهاية المفردة تحصل على 1,500 طلب / 10 ثوانٍ، ونقاط النهاية الجمعية المجمّعة تحصل على 500 طلب / 10 ثوانٍ. يبدو ذلك تخفيضًا حتى تتذكر أن استدعاءً مجمّعًا واحدًا يغطي توكنات كثيرة. التجميع أرخص بـ 3× لكل طلب لكن كل استدعاء يؤدي عملًا أكبر بكثير — فضّل دائمًا /books على حلقة من /book.

السجل

المصادقة

التداول — الدفعات والمستدام

نقاط نهاية التداول هي الوحيدة التي لها حدّان في Cloudflare: حد دفعات للارتفاعات القصيرة وحد مستدام يُقاس على مدى 10 دقائق. يجب أن تبقى تحت كليهما.

يستحق DELETE /cancel-all عند 250 طلبًا / 10 ثوانٍ التنويه. صانعو السوق الذين ينفّذون cancel-all في كل دورة إعادة تسعير يستنفدونه بسرعة، والحد المستدام البالغ 6,000 كل 10 دقائق يعادل 10 استدعاءات cancel-all فقط في الثانية في المتوسط.

Bridge وRelayer وكل ما عدا ذلك

دلاء الرموز لكل موقّع (تداول CLOB)

بمعزل عن Cloudflare، تقيّم Polymarket طلبات الأوامر والإلغاء في CLOB مقابل دلاء رموز لكل موقّع. يحصل كل عنوان موقّع على دلو للأوامر ودلو للإلغاء؛ والإنفاق من أحدهما لا يؤثر في الآخر. وخلافًا لطبقة Cloudflare، يؤدي تجاوز هذه الحدود إلى 429 حقيقي.

تكلّف الطلبات رموزًا بدلًا من احتساب كل منها كوحدة واحدة:

مستويات الحجم

يعتمد حجم دلوك على الحجم التراكمي لمحفظة صانع السوق على مدى نافذة متجددة مدتها 30 يومًا. تُحدَّث تعيينات المستويات كل ثلاث ساعات.

احسب مدة الدفعة الكاملة باستخدام burst_seconds = burst / rate_per_sec. لموقّع Standard يساوي ذلك 60 / 40 — أي 1.5 ثانية من إرسال الأوامر بالسرعة الكاملة قبل أن تُقيَّد بمعدل إعادة الملء البالغ 40/ث.

قراءة ترويسات حد المعدل

يُرجع المحدِّد لكل موقّع ترويسات في كل طلب يُقيَّم. وهي أرخص طريقة ممكنة لمراقبة ميزانيتك — دون الحاجة إلى استدعاءات API إضافية.

التعامل مع 429 بشكل صحيح

تختلف استراتيجية إعادة المحاولة الصحيحة بحسب المحدِّد الذي اصطدمت به، والخطأ فيها يزيد الأمور سوءًا. احترم Retry-After حين يكون موجودًا؛ وارجع إلى التراجع الأُسّي مع تذبذب عشوائي حين لا يكون. التذبذب مهم: فبدونه يعيد كل عمّالك المحاولة في اللحظة نفسها وتعيد إطلاق الحد فورًا.

const MAX_RETRIES = 5;

async function polyFetch(url: string, init?: RequestInit): Promise<Response> {
  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
    const res = await fetch(url, init);

    // Watch the budget even on success — this is your early warning.
    const remaining = res.headers.get("Poly-RateLimit-Remaining");
    if (remaining !== null && Number(remaining) < 10) {
      console.warn(`Low token budget: ${remaining} (tier ${res.headers.get("Poly-RateLimit-Tier")})`);
    }

    // Warning mode: not rejected yet, but it would have been.
    if (res.headers.get("Poly-RateLimit-Warning") === "true") {
      console.warn("Request would be rejected under live enforcement — slow down.");
    }

    if (res.status !== 429) return res;
    if (attempt === MAX_RETRIES) return res;

    // Prefer the server's own answer, else exponential backoff.
    const retryAfter = res.headers.get("Retry-After");
    const baseMs = retryAfter
      ? Number(retryAfter) * 1000
      : Math.min(2 ** attempt * 250, 8000);

    // Full jitter — spreads a fleet of workers out instead of resynchronising them.
    await new Promise((r) => setTimeout(r, Math.random() * baseMs));
  }

  throw new Error("unreachable");
}

البقاء تحت الحدود بالتصميم

• جمّع بدلًا من التكرار. استدعاء /books واحد بدلًا من خمسين استدعاء /book يكلّفك طلبًا واحدًا من ميزانية 500 طلب/10ث بدلًا من خمسين من ميزانية 1,500 طلب/10ث — تحسن بـ 17× في الهامش المتاح.
• خزّن البيانات الوصفية مؤقتًا. البيانات الوصفية للأسواق من /markets بالكاد تتغير خلال عمر السوق، لكن /markets تملك أضيق حد في Gamma عند 300 طلب/10ث. اجلبها مرة، وخزّنها، وتوقف عن طلبها مجددًا في حلقتك الساخنة.
• استخدم WebSockets للحالة المباشرة. استطلاع /book على مؤقت هو الطريقة الأكثر شيوعًا لاستنزاف ميزانية الطلبات. اشترك في التدفق بدلًا من ذلك ودع الخادم يدفع التغييرات.
• أضف تذبذبًا عشوائيًا إلى المهام المجدولة. إذا استيقظ كل عامل في الدقيقة نفسها بالضبط، فإنك تخلق ذروة متزامنة أعلى بكثير من معدلك المتوسط. اجعل إزاحات البدء عشوائية.
• راقب زمن الاستجابة، لا معدلات الأخطاء فقط. لأن Cloudflare تُبطئ بدلًا من الرفض، فارتفاع زمن الاستجابة عند p99 هو إشارتك الأولى إلى أنك تجاوزت حد IP — قبل وقت طويل من ظهور أي شيء كخطأ.
• تتبّع الترويسات. قراءة Poly-RateLimit-Remaining لا تكلف شيئًا وتخبرك بالضبط بكمية الميزانية المتبقية.

حدود المعدل ليست هي الوصول إلى البيانات

أمر أخير يستحق التصريح به، لأنه أكثر المفاهيم الخاطئة التي نراها شيوعًا: لا يمنحك أي مستوى من حدود المعدل عمقًا تاريخيًا لدفتر الأوامر. تقدّم API الخاصة بـ Polymarket الحالة الراهنة للدفتر. ولا تكشف أرشيفًا تاريخيًا لشكل الدفتر عند 14:03:17 يوم الثلاثاء الماضي، وبمجرد حسم السوق يُرجع دفتر أوامره 404.

هذه فجوة بنيوية لا مشكلة إبطاء، ولن يحلها أي قدر من منطق التراجع. إذا كنت تحاول إجراء اختبار رجعي لاستراتيجية، فأنت تحتاج إلى لقطات عند لحظات زمنية محددة سجّلها أحدهم في حينها — وهذا بالضبط ما وُجدت PolyTest لتوفيره: 240M+ لقطة تاريخية لأسواق Up/Down للعملات المشفرة على Polymarket مع العمق الكامل لدفتر الأوامر، ودقة أقل من الثانية، وبلا فجوات.