جميع واجهات API

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

استعلم عن الاحتمالات الضمنية في السوق لإصدارات البيانات الاقتصادية وقرارات السياسة النقدية حسب الموضوع والحدث المؤرخ. احصل على آخر الاحتمالات، وتاريخ من الدقيقة إلى اليوم، وبث مباشر.

احصل على مفتاح 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حقل
التغيرات المتوقعة مجمّعة عبر الاجتماعات.