جميع واجهات API

Polymarket API وKalshi: احتمالات | Narwhal API

API واحد لاحتمالات Kalshi وPolymarket بشأن الإصدارات الاقتصادية وقرارات البنوك المركزية وأسعار المعادن والطاقة، في مخطط واحد مع سجل تاريخي. تستخدم نقاط نهاية REST وأدوات MCP المدخلات نفسها.

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

الطلب الأول

احصل على تفاصيل الموضوع

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/topics/usa-cpi-yoy" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "topic_id": "usa-cpi-yoy",
  "group": "us_prices",
  "title": "US CPI, 12-month change",
  "shape": "scalar",
  "unit": "percent",
  "venues": [
    "kalshi",
    "polymarket"
  ],
  "resolution_kind": "release",
  "events": [
    {
      "event_id": "usa-cpi-yoy-2026-09",
      "question": "US CPI, 12-month change, September 2026",
      "status": "trading",
      "closes_at": "2026-10-14T12:29:00Z",
      "resolves_at": "2026-10-14T12:30:00Z"
    }
  ]
}

نقاط النهاية

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/topics/{topic_id}

موضوع واحد مع أحداثه القادمة وأحداثه الجارية وأحدث 5 أحداث أخرى.

المعلمات

  • topic_idمطلوب

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

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

  • 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حقل

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

  • eventsحقل

    لكل حدث event_id وquestion وstatus وcloses_at وresolves_at وrelease_id وresult.

المرجع الكامل ‏←
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 في الصفحة الأخيرة.

المرجع الكامل ‏←
GETاحصل على مسارات سياسة البنوك المركزية/v1/predictions/policy-paths/{authority}

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

المعلمات

  • authorityمطلوب

    federal-reserve أو european-central-bank أو bank-of-england أو bank-of-japan أو bank-of-canada أو reserve-bank-of-australia أو bank-indonesia.

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

  • as_ofحقل

    وقت أخذ الاحتمالات.

  • meetingsحقل

    صف واحد لكل اجتماع قادم، مع event_id وresolves_at.

  • p_cut, p_hold, p_hikeحقل

    احتمال الخفض وعدم التغيير والرفع.

  • expected_change_bpsحقل

    التغير المرجّح بالاحتمالات في الاجتماع، بالنقاط الأساسية.

  • cumulative_change_bpsحقل

    التغيرات المتوقعة مجمّعة عبر الاجتماعات.

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

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

المعلمات

  • actionمطلوب

    subscribe.

  • topicsمصفوفة

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

  • event_idsمصفوفة

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

الرسائل

  • snapshotالرسالة

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

  • updateالرسالة

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

  • statusالرسالة

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

  • heartbeatالرسالة

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

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

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

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

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

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

Polymarket مقابل Kalshi

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

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

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

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

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

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

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

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

التغطية

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

المصادر

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

واجهة API للبيانات الاقتصادية

مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والمعدلات.

استكشف API ‏←

واجهة API للتقويم الاقتصادي

جداول الإصدارات وحالتها ونسخ النشر.

استكشف API ‏←

واجهة API للسلع

أسعار المعادن الفورية والسلع الفعلية بوحداتها الأصلية وتعريفات سلاسلها.

استكشف API ‏←

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

هل الاحتمالات متأخرة؟

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

بماذا يُحسم الحدث؟

يحدد كل حدث مصدر الحسم الرسمي الخاص به. وترتبط الأحداث الاقتصادية أيضًا بنقطة نهاية الاقتصاد في Narwhal التي تنشر القيمة الفعلية.

ما السجل التاريخي المتاح؟

لكل حدث سجل احتمالات بفواصل دقيقة و5 دقائق وساعة ويوم، عبر مسار السجل وأداة MCP المكافئة. يقتصر السجل بفاصل دقيقة و5 دقائق على آخر 30 يومًا.

ما المواضيع المغطاة؟

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

ماذا يتضمن الحدث؟

سؤال، وأوقات الإغلاق والحسم، ومصدر حسم رسمي، وحالة: upcoming أو trading أو closed أو settled أو void.

ما أشكال الأحداث المتاحة؟

توزيعات قياسية، واحتمالات ثنائية، وأعلى وأدنى مستويات متطرفة، وأسواق التوقيت، إضافة إلى مسارات سياسة البنوك المركزية.

ماذا تغطي المواضيع؟

تشمل التغطية سبعة بنوك مركزية، ومستويات أسعار الذهب والفضة والنحاس وأعلى وأدنى مستوياتها الأسبوعية أو الشهرية، وخام WTI وBrent والغاز الطبيعي. الاحتمالات أسعار سوق وليست ضمانات للنتائج.