أدلة الخطوات العملية
إجابات قصيرة عن سؤال واحد في كل صفحة: أيام العمل وأوقات الإصدار وحسابات التضخم ووحدات السلع وأسعار الصرف والاحتمالات ومهام API، مع الطلب والأرقام.
العطل وأيام العمل
العطل الرسمية وعدد أيام العمل وتواريخ التسوية.
| دليل | ما الذي تغطيه |
|---|---|
| احسب أيام العمل بين تاريخين | احسب أيام العمل بين التواريخ باستخدام Python أو جدول بيانات. اشمل تاريخَي البداية والنهاية، واطرح الإجازات الرسمية، وراعِ التواريخ البديلة والتقاويم الإقليمية. |
| أضف أيام عمل إلى تاريخ | أضف أيام عمل إلى تاريخ باستخدام Python أو Excel أو Google Sheets. تجاوز عطلات نهاية الأسبوع والعطلات، وعالج تغيّر السنة، واتبع مثالًا مؤرخًا لعيد الشكر. |
| احسب تاريخ تسوية T+1 أو T+2 | احسب تواريخ التسوية T+1 وT+2 باستخدام Python أو جدول بيانات. تجاوز عطلات نهاية الأسبوع وعطلات الدول المعنية، مع مثال تطبيقي لسهم أمريكي وزوج USD/JPY. |
| تحقّق مما إذا كان تاريخ ما إجازة رسمية | تحقّق مما إذا كان تاريخ ما عطلة رسمية باستخدام Narwhal API أو جدول بيانات. عالج السجلات الإقليمية والأيام البديلة والنطاقات مع أمثلة لعيد الميلاد 2026. |
| اعرض الإجازات الرسمية لعدة دول | اعرض العطلات الرسمية في خمس دول لعام 2026 باستخدام برنامج Python أو صفحات التقويم. قارن التواريخ المشتركة، وعالج الصفوف الإقليمية، واستبعد أيام الإجازة. |
| أضف فحصًا للعطلات إلى شيفرتك | أضف فحصًا للعطلات يستخدم التخزين المؤقت في Python أو JavaScript، واستخدم صيغة في جدول بيانات، وتعامل مع التقاويم غير المنشورة بمثال لأسبوع عيد الشكر 2026. |
تواريخ الإصدار والبنوك المركزية
متى تصدر البيانات والقرارات، وكيف يتم إشعارك بها.
| دليل | ما الذي تغطيه |
|---|---|
| اعثر على تاريخ إصدار CPI التالي | اعثر على تاريخ إصدار CPI للولايات المتحدة باستخدام API للتقويم الاقتصادي أو صفحة الدولة. اقرأ الشهر المرجعي ووقت الإصدار المجدول بتوقيت UTC وتوقيت نيويورك. |
| حوّل وقت الإصدار إلى منطقتك الزمنية | حوّل أوقات الإصدارات الاقتصادية من UTC إلى توقيتك المحلي باستخدام Python أو جدول بيانات. عالج التوقيت الصيفي وتغيّر التاريخ بمثال CPI لشهر نوفمبر 2026. |
| ضبط تنبيه قبل صدور البيانات الاقتصادية | كيف تضبط تنبيهًا قبل صدور البيانات الاقتصادية بخلاصة تقويم أو نص Python يومي. ستجد مثال مؤشر أسعار المستهلك الأمريكي بأوقات التنبيه بتوقيت UTC ونيويورك وجاكرتا. |
| أنشئ تقويمًا اقتصاديًا عبر API التقويم الاقتصادي | ابنِ تقويمًا اقتصاديًا عبر API التقويم الاقتصادي بأوقات إصدار بالتوقيت العالمي UTC للدول والتواريخ التي تختارها، بـ Python أو تقويم الموقع أو تدفق التقويم. |
| ابحث عن تواريخ اجتماعات FOMC ومحاضرها | ابحث عن قرارات الفائدة المجدولة لـ FOMC ومحاضرها باستخدام API للتقويم الاقتصادي، واستخدم موجز تقويم، واقرأ أوقات الإصدارات بتوقيت UTC ونيويورك وجاكرتا. |
| اعرض كل اجتماعات البنوك المركزية بقائمة واحدة | اعرض تواريخ قرارات البنوك المركزية مرتبة زمنيًا ببرنامج Python، واعثر على دليل اجتماعات بلا برمجة، واعرف متى تستخدم التقويم الاقتصادي للأوقات الدقيقة. |
| تتبّع تغيرات أسعار فائدة البنوك المركزية | تتبّع تغيّر فائدة البنوك المركزية عبر Python: اقرأ سجل الفائدة الرئيسية، وقارن القيم المفردة والنطاقات، واستخدم تواريخ المصدر وافحص يوميًا عبر Narwhal API. |
الاقتصاد
التضخم والنمو والعوائد من الإحصاءات الرسمية.
| دليل | ما الذي تغطيه |
|---|---|
| حساب التضخم السنوي والشهري من مؤشر أسعار المستهلك | حساب التضخم السنوي والشهري لمؤشر CPI من API أو من مستويات المؤشر بواسطة Python أو جدول بيانات، مع مثال من أمريكا وإرشادات عند غياب بعض البيانات الشهرية. |
| استخدم حاسبة التضخم لتعديل سعر بحسب التضخم | حاسبة التضخم بمؤشرات الأسعار CPI أو سكربت Python أو صيغة جدول بيانات: اعرف كيف تتغير قيمة 100 دولار من نوفمبر 2025 إلى سبتمبر 2026 مع مثال محسوب بالخطوات. |
| مقارنة التضخم بين الدول وترتيب المعدلات | مقارنة التضخم بين الدول بـ Python أو جدول بيانات: رتّب المعدلات المنشورة، واحتفظ بتواريخ الإصدار، وتعامل مع اختلاف فترات الإبلاغ بين الدول عند المقارنة. |
| احسب سعر الفائدة الحقيقي | احسب سعر الفائدة الحقيقي من العائد الاسمي والتضخم بمعادلة فيشر، مع شيفرة Python وصيغة جدول بيانات ومثال أمريكي مؤرَّخ يوضح المدخلات وتواريخها. |
| هل ظهر منحنى العائد المقلوب؟ تحقق بالأرقام | قارن عوائد السندات الأمريكية لتعرف هل ظهر منحنى العائد المقلوب. ستجد شيفرة Python وصيغة جدول بيانات ومثالًا مؤرخًا بالفوارق بنقاط الأساس، لتقرأ النتيجة. |
| الناتج المحلي الإجمالي في حساب معدل النمو الاقتصادي من مستويات | حساب معدل النمو الاقتصادي من مستويات الناتج المحلي الفصلية بواسطة Python أو جدول بيانات، مع تحويله إلى معدل سنوي ومقارنة النمو الاسمي بالنمو الحقيقي الأمريكي. |
| احصل على بيانات البنك الدولي باستخدام Python | تعلّم كيفية الحصول على بيانات البنك الدولي في Python باستخدام Narwhal API: ابحث عن المؤشرات، واقرأ الرصدات السنوية، وأنشئ DataFrame، وتحقق من حد الجلب اليومي. |
| احصل على جدول لهيئة الإحصاء الكندية باستخدام معرّفه | استخدم معرّف جدول هيئة الإحصاء الكندية للعثور عليه، وانسخ رقم المتجه واقرأ سجل CPI أو أحدث القيم دفعة واحدة عبر Narwhal API باستخدام requests في Python. |
| كيفية مقارنة أسعار الفائدة الرئيسية بين البلدان | قارن أسعار الفائدة الرئيسية بين البلدان عبر Python، وتعامل مع القيم المفردة والنطاقات المستهدفة، وأنشئ جدولًا مرتبًا بالعملات والأدوات وتواريخ المصدر. |
السلع
النفط والذهب والفضة والنحاس بالوحدات والعملات التي تستخدمها.
| دليل | ما الذي تغطيه |
|---|---|
| حساب سعر النفط باللتر والغالون من سعر البرميل | كيف تحسب سعر النفط باللتر والغالون من سعر برميل برنت أو WTI بالدولار. استخدم Python أو صيغ جداول البيانات أو محوّل السلع لحساب السعر لكل لتر وغالون. |
| احصل على سعر الذهب بالريال السعودي أو بعملتك | احصل على سعر الذهب بالريال السعودي أو بعملتك مباشرة، وحوّل أسعار السلع الأخرى بسعر الصرف، واحسب سعر الروبية لكل أونصة تروي ولكل غرام مع مثال محسوب لكل خطوة. |
| طريقة حساب Gold Silver Ratio بين الذهب والفضة | احسب Gold Silver Ratio بـ Python أو جدول بيانات: احصل على أسعار الذهب والفضة بالدولار للأوقية تروي، ثم اقسم سعر الذهب على سعر الفضة في التاريخ أو الوقت نفسه. |
| حساب سعر طن النحاس وسعر الكيلو من سعر الرطل | تعرّف على سعر طن النحاس وسعر الكيلوغرام انطلاقًا من السعر بالدولار الأمريكي لكل رطل. ستحصل على شيفرة API وصيغ جداول البيانات ومثالًا محسوبًا لكل تحويل. |
| تحميل أسعار المعادن CSV: سجل الأسعار التاريخي | تحميل أسعار المعادن CSV: نزّل سجل أسعار الذهب اليومي بـ Python، أو استخدم جدول السجل في الموقع. ستجد أمثلة مؤرخة وتفاصيل التقسيم إلى صفحات ونقطة بداية كل سجل. |
| إعداد تنبيه سعر الذهب والسلع بـ Python | أعدّ تنبيه سعر الذهب والسلع مجدولًا باستخدام Python أو Zapier أو Make. قارن سعر الذهب بالحد الذي تحدده واحفظ الحالة، فيصلك التنبيه عند تجاوز الحد فقط ولا يتكرر. |
أسعار الصرف
أسعار الصرف في تواريخ سابقة والأسعار المتقاطعة والمتوسطات.
| دليل | ما الذي تغطيه |
|---|---|
| كيف تحصل على سعر الدولار في تاريخ معين | اعرف سعر الدولار في تاريخ معين عبر Narwhal API أو صفحة العملة، وكيف تقرأ السعر المعروض وتتعامل مع التواريخ الناقصة والقيم العشرية في جدول بيانات عند نسخ القيم. |
| حساب cross rate انطلاقًا من زوجي عملات | احسب cross rate لتحويل اليورو إلى الروبية الإندونيسية من سعرين بالدولار باستخدام Python أو جدول بيانات، مع اتجاه القسمة وأثر التواريخ واختلاف السعر المباشر. |
| حساب متوسط سعر الصرف الشهري | احسب متوسط سعر الصرف الشهري من الملاحظات اليومية بواسطة Python أو جدول بيانات، مع مثال USD/IDR لسبتمبر 2026 وسياق محاسبي لاستخدام النتيجة في الحسابات. |
| كيف تجد سعر الصرف بتاريخ معين لفاتورة | اعثر على سعر الصرف بتاريخ معين لتاريخ الفاتورة بـ Python أو جدول بيانات: تعامل مع عطلات نهاية الأسبوع، واختر اتجاه العملات، وحوّل فاتورة مؤرخة بـ EUR إلى USD. |
أسواق التنبؤ
الاحتمالات والنسب والتنبيهات.
| دليل | ما الذي تغطيه |
|---|---|
| تحويل Prediction Market Odds إلى نسبة احتمال | حوّل Prediction Market Odds وصيغ الأودز الأخرى إلى احتمالات ضمنية من الأسعار. استخدم Python أو جدول بيانات لإزالة الـ overround ومقارنة النتائج بعضها ببعض. |
| مقارنة Polymarket vs Kalshi حول سؤال واحد | Polymarket vs Kalshi في سؤال واحد عن الاحتياطي الفيدرالي: احسب الفجوة بين السعرين في سكربت أو جدول بيانات، واطّلع على قواعد كل منصة والاحتمال المدمج بينهما. |
| قراءة Fed rate odds من API أو من صفحة القرار | اقرأ Fed rate odds: احتمالات خفض الفائدة الفيدرالي الأمريكي وتثبيتها ورفعها عبر API أو صفحة القرار، مع التحرك المتوقع بنقاط الأساس ومثال لاجتماع بتاريخ محدد. |
| تنبيه تغير احتمالات Polymarket عند تحركها | كيف تضبط تنبيه تغير احتمالات Polymarket وأسواق التنبؤ بنص Python مجدول أو سير عمل بلا كود: احفظ الاحتمالات السابقة، واختر عتبة، وقارن كل قراءة جديدة بالسابقة. |
مهام API
الخطافات (Webhooks) والبث والتخزين المؤقت وملء البيانات التاريخية والوكلاء.
| دليل | ما الذي تغطيه |
|---|---|
| استقبال Webhooks من Narwhal خطوة بخطوة | شرح استقبال Webhooks: أنشئ وجهة في Narwhal، وتحقق من توقيعات التسليم، وعالج الأحداث المكررة، واستعد الأحداث الفائتة عبر السجل، مع مثال بلغة Python. |
| بث البيانات المباشر WebSocket للأحداث | تعلّم بث البيانات المباشر WebSocket عبر Python: اتصل ببث الأحداث والتنبؤات في Narwhal API، وصفِّ حسب الدولة والموضوع، واحفظ المؤشر، وعالج الأخطاء. |
| معالجة خطأ 429 API وتخزين الاستجابات مؤقتًا | تعامل مع خطأ 429 API وخزّن استجابات الـ API مؤقتًا بحسب نوع البيانات، مع Retry-After والتمييز بين حد المعدل ونفاد الرصيد، وكود Python ومثال لتكلفتها الشهرية. |
| جلب البيانات التاريخية API واستئناف التعبئة | جلب البيانات التاريخية API عبر التقسيم إلى صفحات بالمؤشر: احفظ الصفوف في ملف، واستأنف عمليات التعبئة التاريخية المتوقفة، وتحقق من أول تاريخ تُرجعه كل سلسلة. |
| جدولة جلب البيانات اليومي للذهب وسعر الصرف | تعرّف على جدولة جلب البيانات اليومي: اجلب الذهب وUSD/IDR بـ Python وcron وأضفهما إلى CSV، أو استخدم تدفقًا بلا برمجة، مع التوقيت ومعالجة الإخفاق والاستخدام. |
| ربط وكيل ذكاء اصطناعي بـ Narwhal عبر LLM Agent API | اربط وكيلًا عبر LLM Agent API بـ Narwhal باستخدام مفتاح API وMCP، واطلع على إعداد العميل وأدوات القراءة فقط وتفاصيل الرصيد وحلول أخطاء الاتصال في وكيلك. |
| كيف تنتقل إلى بديل Alpha Vantage في Narwhal | بديل Alpha Vantage: انتقل إلى Narwhal API واربط كل function بنقطة نهاية، واستبدل apikey بترويسة Bearer، وتحقق من بيانات مؤشر الأسعار والأسهم والصرف. |
عن أدلة الاستخدام هذه
يجيب كل دليل عن سؤال واحد، مع طلب يعمل فعلاً ومثال مؤرخ يمكنك مطابقته مع المصدر.
تستخدم جميع الأمثلة مفتاح API المجاني نفسه، ويأتي مع رصيد مجاني قدره $10 كل شهر خلال أول 12 شهراً.
احصل على هذه البيانات عبر API
جرّب طلباً.
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"الأسئلة الشائعة
ما الفرق بين دليل الاستخدام والدرس؟
يجيب دليل الاستخدام عن سؤال واحد، مثل حساب أيام العمل بين تاريخين. أما الدرس فيعدّ بيانات Narwhal في أداة تستخدمها بالفعل، مثل جدول بيانات أو Python أو Postgres.
هل أحتاج إلى مفتاح API؟
تحتاج أمثلة الكود إلى مفتاح API مجاني، ويأتي مع رصيد مجاني قدره $10 كل شهر خلال أول 12 شهراً. وتعمل بعض الأدلة أيضاً من جدول بيانات أو صفحة عامة دون مفتاح.
ما اللغات المستخدمة في الأمثلة؟
معظمها بلغة Python وصيغ جداول البيانات، مع JavaScript وSQL وأدوات بلا كود حيثما تناسب المهمة.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.