جميع واجهات API

احتمالات Polymarket عبر Polymarket API من Narwhal

اقرأ احتمالات Polymarket وKalshi لقرارات البنوك المركزية ومؤشر أسعار المستهلك والوظائف والناتج المحلي الإجمالي والمعادن والطاقة في مخطط Narwhal واحد. Narwhal للقراءة فقط.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
متاح100.00% uptime, last 30 أيام288 ms زمن الاستجابة المعتاد

الطلب الأول

احصل على احتمالات الحدث

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/scalar/usa-fed-2026-10" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
مثال على استجابة قرار الاحتياطي الفيدرالي في أكتوبر 2026، مختصرة إلى نتيجتين
{
  "event_id": "usa-fed-2026-10",
  "topic_id": "usa-fed",
  "question": "Federal Reserve rate decision, 28 October 2026",
  "status": "trading",
  "closes_at": "2026-10-28T17:59:00Z",
  "resolves_at": "2026-10-28T18:00:00Z",
  "release_id": "ae2a77cc-3b5b-4541-a060-3bc2ea1145d9",
  "resolution": "Change in the Federal Reserve policy rate announced at the meeting, in basis points",
  "resolves_with": "/v1/economics/USA/central-bank/policy-rate",
  "unit": "bps",
  "venues": [
    {
      "venue": "kalshi",
      "weight": "0.3353",
      "volume_24h_usd": "15376.51"
    },
    {
      "venue": "polymarket",
      "weight": "0.6647",
      "volume_24h_usd": "531149.67"
    }
  ],
  "outcomes": [
    {
      "key": "cut_25",
      "label": "Cut of 25 bps",
      "lower": "-37.5",
      "upper": "-12.5",
      "probability": "0.0059",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0049",
          "market_ids": [
            "KXFEDDECISION-26OCT-C25"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0064",
          "market_ids": [
            "3326851035…5947"
          ]
        }
      ]
    },
    {
      "key": "cut_50_plus",
      "label": "Cut of 50 bps or more",
      "lower": null,
      "upper": "-37.5",
      "probability": "0.0026",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0050",
          "market_ids": [
            "KXFEDDECISION-26OCT-C26"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0015",
          "market_ids": [
            "1701037799…5586"
          ]
        }
      ]
    }
  ]
}

نقاط النهاية

GETاعرض مواضيع التنبؤ/v1/predictions/topics

كل موضوع تغطيه Narwhal، مع شكله ووحدته وأسواقه. استخدمه للعثور على معرّف موضوع.

المعلمات

  • groupاختياري

    central_banks أو us_prices أو us_jobs أو us_activity أو global_activity أو global_prices أو metals أو energy.

كل موضوع في القائمة

  • topic_idحقل

    معرّف الموضوع، مثل usa-cpi-yoy.

  • groupحقل

    المجموعة التي ينتمي إليها الموضوع، مثل central_banks أو metals.

  • titleحقل

    اسم الموضوع.

  • shapeحقل

    كيفية تنظيم الاحتمالات، مثل scalar أو binary.

  • unitحقل

    وحدة القيمة، مثل usd_per_barrel. تُحذف عند عدم وجودها.

  • venuesحقل

    المنصات التي تسعّره: kalshi أو polymarket أو كلتاهما.

  • resolution_kindحقل

    release أو price_fix أو price_window أو occurrence.

  • calendarحقل

    عائلة إصدارات التقويم التي يتبعها الموضوع، مع الدولة والعائلة. تُحذف إذا لم يتبع أيًّا منها.

  • next_event_idحقل

    أول حدث مفتوح في الموضوع. يُحذف عند عدم وجوده.

المرجع الكامل ‏←
GETاعرض الأحداث المؤرخة/v1/predictions/events

أحداث مؤرخة عبر المواضيع، مع حالتها وأوقاتها. صفّها بحسب الموضوع أو الشكل أو الحالة أو وقت الحسم.

المعلمات

  • topicاختياري

    أحداث معرّف الموضوع هذا فقط.

  • shapeاختياري

    أحداث هذا الشكل فقط.

  • statusاختياري

    upcoming أو trading أو closed أو settled أو void.

  • release_idاختياري

    الأحداث التي تُحسم على إصدار التقويم هذا فقط.

  • from, toاختياري

    أوقات UTC تصفّي resolves_at. يجب أن يسبق from قيمة to.

  • limitاختياري

    من 1 إلى 100. القيمة الافتراضية 50.

  • cursorاختياري

    مرّر next_cursor من الصفحة السابقة لقراءة الصفحة التالية.

كل حدث في القائمة

  • event_idحقل

    معرّف الحدث.

  • questionحقل

    السؤال الذي يطرحه الحدث.

  • statusحقل

    upcoming أو trading أو closed أو settled أو void.

  • closes_at, resolves_atحقل

    أوقات الإغلاق والحسم، بتوقيت UTC.

  • topic_id, shapeحقل

    الموضوع وشكل احتمالاته.

  • release_idحقل

    إصدار التقويم الذي يُحسم عليه الحدث. يُحذف عند عدم وجوده.

  • resultحقل

    في الأحداث المحسومة والملغاة: هل النتيجة نهائية ومتى حُسمت.

  • next_cursorحقل

    المؤشر للصفحة التالية. يكون Null في الصفحة الأخيرة.

المرجع الكامل ‏←
GETاحصل على احتمالات الحدث مع أسعار كل منصة/v1/predictions/{shape}/{event_id}

أحدث احتمالات حدث واحد، مع سعر كل منصة والاحتمال المدمج.

المعلمات

  • shapeمطلوب

    scalar أو extreme أو timing أو binary.

  • event_idمطلوب

    معرّف حدث، مثل usa-cpi-yoy-2026-09.

  • atاختياري

    لحظة سابقة تم التقاطها، بتوقيت UTC.

حقول الاستجابة

  • event_idحقل

    معرّف الحدث.

  • topic_idحقل

    الموضوع الذي ينتمي إليه الحدث.

  • questionحقل

    السؤال الذي يطرحه الحدث.

  • statusحقل

    upcoming أو trading أو closed أو settled أو void.

  • closes_atحقل

    وقت الإغلاق، بتوقيت UTC.

  • resolves_atحقل

    وقت الحسم، بتوقيت UTC.

  • as_ofحقل

    وقت آخر فحص للمنصات.

  • staleحقل

    تكون true عندما يكون آخر فحص للمنصات قبل أكثر من 3 دقائق.

  • resolutionحقل

    وصف نصي لكيفية حسم الحدث.

  • resolves_withحقل

    نقطة نهاية Narwhal التي تنشر القيمة الرسمية. تُحذف عند عدم وجودها.

  • venuesحقل

    سجل واحد لكل سوق في منصة: الرابط والقواعد ومصدر الحسم والوزن وحجم التداول والفوائد المفتوحة.

  • resultحقل

    نتيجة كل منصة، بمجرد تسوية الحدث أو إلغائه.

  • outcomesعددي

    لكل نتيجة key وlabel وlower وupper وprobability وquotes.

  • up, downالقيم القصوى

    احتمال بلوغ كل مستوى مرتفع أو منخفض ضمن النافذة.

  • stepsالتوقيت

    احتمال حدوثه بحلول كل تاريخ أو اجتماع.

  • probabilityثنائي

    احتمال نعم، مع الأسعار الكامنة وراءه.

  • quotesحقل

    احتمال كل سوق مع رموز Kalshi أو معرّفات أسواق Polymarket الكامنة وراءه.

المرجع الكامل ‏←
GETاحصل على الاحتمالات التاريخية لحدث/v1/predictions/{shape}/{event_id}/history

الاحتمالات عبر الزمن لحدث واحد، على شكل أشرطة.

المعلمات

  • shapeمطلوب

    scalar أو extreme أو timing أو binary.

  • event_idمطلوب

    معرّف حدث، مثل usa-cpi-yoy-2026-09.

  • intervalاختياري

    1m أو 5m أو 1h (الافتراضي) أو 1d. تُحفظ أشرطة 1m و5m لمدة 30 يومًا.

  • startمطلوب

    البداية بتوقيت UTC.

  • endمطلوب

    النهاية بتوقيت UTC، بعد start. بحد أقصى يومان لـ 1m، و7 لـ 5m، و92 لـ 1h، و3,660 لـ 1d.

  • cursorاختياري

    مرّر next_cursor من الصفحة السابقة، مع start وend وinterval نفسها.

حقول الاستجابة

  • seriesحقل

    سلسلة واحدة لكل نتيجة، ولكل منها key وactive_from وbars.

  • barsحقل

    لكل شريط timestamp، وهو بداية الشريط، وclose. وتضيف الأشرطة المباشرة open وhigh وlow.

  • active_toحقل

    يُرسل عند انتهاء السلسلة.

  • next_cursorحقل

    المؤشر للصفحة التالية. يكون Null في الصفحة الأخيرة.

المرجع الكامل ‏←
WSبث الاحتمالات المباشرة عبر WebSocket/v1/predictions/stream

احتمالات مباشرة عبر WebSocket. أرسل مفتاحك في ترويسة Authorization ثم اشترك. كل اتصال يكلّف استدعاءً واحدًا.

المعلمات

  • actionمطلوب

    subscribe.

  • topicsمصفوفة

    حتى 40 معرّف موضوع.

  • event_idsمصفوفة

    حتى 200 معرّف حدث.

الرسائل

  • snapshotالرسالة

    الحدث الكامل، مع شكله.

  • updateالرسالة

    الحدث مرة أخرى عندما يتغير، بحد أقصى مرة في الدقيقة.

  • statusالرسالة

    الحالة الجديدة للحدث.

  • heartbeatالرسالة

    يُرسل كل 30 ثانية.

المرجع الكامل ‏←

حالات الاستخدام

احتمالات قرار الفائدة للاحتياطي الفيدرالي

اقرأ احتمال الخفض وعدم التغيير والرفع في كل اجتماع قادم للاحتياطي الفيدرالي.

اقرأ الدليل ‏←

Polymarket مقابل Kalshi

قارن السوقين في سؤال واحد وشاهد الفجوة بينهما.

اقرأ الدليل ‏←

الاحتمالات كنسب احتمال

حوّل الأسعار إلى احتمالات ضمنية وأزل الهامش الزائد.

اقرأ الدليل ‏←

تنبيهات عند تحرك الاحتمالات

شغّل سكربت وفق جدول زمني واحصل على تنبيه عندما تتجاوز الاحتمالات عتبة معينة.

اقرأ الدليل ‏←

التغطية

عرض كل المواضيع (49)

المصادر

واجهات API ذات صلة

API لأسواق التنبؤ

احتمالات اقتصادية وسلعية من Kalshi وPolymarket في مخطط واحد.

استكشف API ‏←

مرجع predictions API لأسواق التنبؤ

نقاط النهاية والحقول وأدوار المنصات والسجل التاريخي وبث WebSocket.

اقرأ المرجع ‏←

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

هل هذا هو API الرسمي لـ Polymarket؟

لا. تقرأ Narwhal بيانات سوق Polymarket العامة وتعرضها بصيغتها الخاصة، إلى جانب Kalshi. استخدم API الخاص بـ Polymarket للتداول أو لقراءة أسواق لا تغطيها Narwhal.

هل يمكنني تنفيذ صفقات عبر Narwhal؟

لا. Narwhal للقراءة فقط. تعرض الاحتمالات وأسواق المنصات الكامنة وراءها، وليس الأوامر أو دفاتر الأوامر.

ما مدى حداثة احتمالات Polymarket؟

تُقرأ الاحتمالات كل 60 ثانية. يرى كل حساب احتمالات مباشرة ويمكنه استخدام البث وwebhooks.

لماذا أقرأ Polymarket عبر Narwhal؟

مخطط واحد لـ Polymarket وKalshi، واحتمال مدمج، وسجل بالدقيقة، وروابط إلى الإصدار الرسمي الذي يُحسم عليه كل سوق، وwebhooks وأدوات MCP.

ما معرّفات أسواق Polymarket التي أحصل عليها؟

تعرض كل نتيجة أسواق Polymarket الكامنة وراءها، إلى جانب رموز Kalshi للسؤال نفسه واحتمال مدمج.

هل تُطابق الأسواق الإصدارات الرسمية؟

يرتبط كل سوق بالإصدار الرسمي الذي يُحسم عليه.

ما السجل التاريخي والبث وwebhooks المتاحة؟

اقرأ سجل الدقائق الملتقط لآخر 30 يومًا. يحصل كل حساب أيضًا على احتمالات مباشرة وبث WebSocket وwebhooks عند إغلاق السوق أو تسويته.

ما أسواق Polymarket المغطاة؟

تستخدم Narwhal أسواق Polymarket للمواضيع الاقتصادية والسلعية المدرجة تحت التغطية. أسواق الرياضة والسياسة وأسعار العملات المشفرة وغيرها في Polymarket غير مشمولة.