مرجع API أسعار الفائدة الرئيسية

الطلبات

GET /v1/economics/{country}/central-bank/policy-rate
GET /v1/economics/{country}/central-bank/policy-rate?date=2026-09-15
GET /v1/economics/{country}/central-bank/policy-rate/history?start=2008-01-01&limit=1000
GET /v1/economics/{country}/central-bank/reserves?period=2026-07
GET /v1/economics/{country}/central-bank/balance-sheet?period=2026-09

استخدم رمز ISO alpha-3 بأحرف كبيرة في country.

عند عدم تحديد date، تُرجع الاستجابة أحدث مشاهدة من المصدر في اليوم الحالي بتوقيت UTC أو قبله. وعند تحديد date، تُرجع أحدث مشاهدة في التاريخ المطلوب أو قبله. تبقى الأيام التي لا تتوفر لها مشاهدات غائبة، ولا تحل أسعار الفائدة ذات تواريخ السريان المستقبلية محل السعر الحالي قبل موعدها مطلقًا.

أدوات MCP هي economics_get_policy_rate وeconomics_get_policy_rate_history وeconomics_get_central_bank_reserves وeconomics_get_central_bank_balance_sheet. يشترك REST وMCP في مفتاح Bearer والمخطط والحصة؛ ويُحتسب كل طلب استدعاءً واحدًا.

تتاح أسعار الفائدة الرئيسية مباشرةً في جميع الخطط. لا يخضع أحدث سعر لقيد تاريخي، بينما تخضع الطلبات التي تتضمن date أو نطاقًا تاريخيًا أو period للاحتياطيات أو period للميزانية العمومية للنافذة التاريخية للخطة: Free لمدة 12 شهرًا، وBasic لمدة 5 سنوات، وPro للسجل الكامل. تُرجع الطلبات التي تنتهي قبل النافذة 403 plan_upgrade_required.

الاستجابة

تستخدم الأمثلة قيمًا محفوظة لتوضيح بنية الاستجابة. هذه القيم ليست بيانات مباشرة.

{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.25",
  "qualifier": "exact",
  "unit": "percent",
  "effective_on": null,
  "observed_on": "2025-12-10",
  "announced_on": null
}

{
  "country": "USA",
  "authority": "federal_reserve",
  "currency": "USD",
  "instrument": "federal_funds_target_range",
  "rate_type": "range",
  "lower_bound": "3.50",
  "upper_bound": "3.75",
  "unit": "percent",
  "effective_on": "2025-12-11",
  "observed_on": null,
  "announced_on": null
}

تتضمن أسعار الفائدة المحدّدة rate وqualifier؛ وتتضمن النطاقات المستهدفة lower_bound وupper_bound بدلًا منهما. القيم سلاسل نصية تمثّل أعدادًا عشرية بنسبة مئوية سنوية، وأسعار الفائدة السالبة صالحة.

السجل

• start وend: تاريخان مشمولان بتنسيق YYYY-MM-DD.
• limit: من 1 إلى 1000؛ القيمة الافتراضية 100.
• cursor: قيمة next_cursor من الصفحة السابقة.

تُرتَّب النتائج من الأقدم إلى الأحدث. أرسل قيمة next_cursor في cursor مع عوامل التصفية والحد نفسيهما لكل صفحة لاحقة، حتى تصبح null. تُبقي مؤشرات الصفحات جميع الصفحات مرتبطة بالإصدار الأصلي لمدة 24 ساعة. يُرجع مؤشر أقدم أو بيانات سحبها البنك 409 cursor_expired؛ ابدأ مجددًا دون مؤشر.

تتضمن الاستجابة country وobservations وnext_cursor. تستخدم كل مشاهدة حقول استجابة سعر فائدة واحد.

ترفع طلبات السجل التاريخي قيمة start إلى بداية النافذة التاريخية للخطة: Free لمدة 12 شهرًا، وBasic لمدة 5 سنوات، وPro للسجل الكامل. تسجل الولايات المتحدة وأستراليا والتشيك وكندا وماليزيا تواريخ القرارات فقط، ولا ينقل السجل التاريخي سعرًا سابقًا إلى داخل النافذة. إذا لم تتضمن النافذة أي قرار، تحتوي الاستجابة على قائمة observations فارغة ([])، وتكون قيمة next_cursor هي null. يُرجع طلب السعر الحالي دون date السعر الساري، دون قيد تاريخي في أي خطة.

{
  "country": "USA",
  "observations": [
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target",
      "rate_type": "point",
      "rate": "1.00",
      "qualifier": "exact",
      "unit": "percent",
      "effective_on": "2008-10-29",
      "observed_on": null,
      "announced_on": null
    },
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target_range",
      "rate_type": "range",
      "lower_bound": "0.00",
      "upper_bound": "0.25",
      "unit": "percent",
      "effective_on": "2008-12-16",
      "observed_on": null,
      "announced_on": null
    }
  ],
  "next_cursor": "eyJhIjoiMjAwOC0xMi0xNiJ9"
}

الاحتياطيات

يُرجع إجمالي الأصول الاحتياطية الرسمية كما ينشرها البنك. استخدم YYYY-MM في period، أو احذفه للحصول على أحدث شهر.

{
  "country": "AUS",
  "period": "2026-07",
  "value": "145344",
  "currency": "AUD",
  "scale": "millions",
  "released_on": "2026-08-07"
}

value سلسلة نصية تمثّل عددًا عشريًا موجبًا. تحدّد الوحدة التي ينشرها البنك قيمة scale، وهي units أو millions؛ ويحدّد currency عملة القيمة. لا يحوّل Narwhal المقياس أو العملة مطلقًا. الشهر المرجعي هو period، وreleased_on هو تاريخ آخر تحديث أجراه الناشر لملفه. تبقى الأشهر غير المنشورة غائبة ولا تُملأ مطلقًا.

تتوفر الاحتياطيات لأستراليا (جدول RBA A4)، وماليزيا (بنك نيجارا ماليزيا، إجمالي الاحتياطيات الدولية)، ولألمانيا وفرنسا وأيرلندا وهولندا والبرتغال وسلوفينيا وإستونيا ولاتفيا وليتوانيا وكرواتيا، إضافة إلى التشيك، عبر سلسلة الأصول الاحتياطية لدى ECB باليورو. قيمة التشيك هي قيمة البنك الوطني التشيكي المسجّلة لدى ECB. تُرجع البلدان الأخرى 404 series_not_found.

الميزانيات العمومية

اقرأ إجمالي الأصول الشهرية لبنك مركزي (إجمالي الميزانية العمومية) عبر GET /v1/economics/{country}/central-bank/balance-sheet أو أداة MCP المسماة economics_get_central_bank_balance_sheet. عيّن المعامل الاختياري period إلى شهر مرجعي بتنسيق YYYY-MM، أو احذفه لإرجاع أحدث شهر.

{
  "country": "CAN",
  "period": "2026-09",
  "value": "242657",
  "currency": "CAD",
  "scale": "millions",
  "released_on": "2026-10-15"
}

يمثل period الشهر المرجعي، ويسجل released_on تاريخ النشر. بالنسبة إلى كندا، يمثل released_on تاريخ تسجيل Narwhal للرقم لأن ملف بنك كندا لا يتضمن تاريخ تحديث. تكون value سلسلة نصية عشرية موجبة كما نُشرت تمامًا، ويحدد currency وscale (units أو millions) الوحدات التي نشر بها البنك البيانات؛ ولا يجري Narwhal أي تحويل عليها مطلقًا.

تتاح البيانات الشهرية في جميع الخطط لكندا (CAN، بنك كندا، CAD) وماليزيا (MYS، بنك نيجارا ماليزيا، MYR)؛ ويُرجع أي بلد آخر 404 series_not_found. إذا حُددت period صراحةً وكانت تنتهي قبل النافذة التاريخية للخطة، يُرجع الطلب 403 plan_upgrade_required: تتيح Free مدة 12 شهرًا، وBasic مدة 5 سنوات، وPro السجل الكامل.

التغطية

لمنطقة اليورو سعر فائدة رئيسي واحد. يُرجع رمز كل دولة مدرجة من أعضاء منطقة اليورو سعر فائدة تسهيلات الإيداع لدى ECB بدءًا من تاريخ اعتماد تلك الدولة لليورو.

تسرد صفوف الولايات المتحدة وأستراليا والتشيك وكندا وماليزيا تواريخ قرارات أسعار الفائدة (التغييرات فقط). وتسرد صفوف السويد والنرويج والدنمارك والبرازيل والدول الأعضاء في منطقة اليورو مشاهدات مؤرخة قد تكرر السعر السابق.

كان policy_rate في السويد سعر فائدة إعادة الشراء حتى 8 June 2022. تقتصر تغطية البرازيل على سعر الفائدة الرئيسي، وتُستبعد التواريخ التي لم تدخل حيز السريان بعد.

المصادر والتنويهات

ينشر بنك كندا وECB وRBA بياناتهم مجانًا على مواقعهم الإلكترونية. يغيّر Narwhal التنسيق ويُرجع القيم المنشورة. لا تؤيّد هذه المؤسسات Narwhal.

• Source: Bank of Canada. This information is available free of charge on the Bank of Canada website: https://www.bankofcanada.ca.
• Source: European Central Bank (ECB). This information is available free of charge on the ECB website: https://www.ecb.europa.eu.
• Source: Reserve Bank of Australia 2026. This information is available free of charge on the RBA website: https://www.rba.gov.au.

احتفظ بنسبة البيانات إلى مصدرها أينما تعرضها. يتضمن إشعار بنك السويد المركزي تاريخ البيانات في الصفحات التي تقرأ البيانات المباشرة.

• Source: Board of Governors of the Federal Reserve System
• Source: Bank Negara Malaysia. Data and information are subject to Terms of Use for BNM Datasets.
• Source: Sveriges Riksbank, with the date of the data.
• Source: the CNB
• Source: Norges Bank
• Source: Danmarks Nationalbank
• Source: Statistics Denmark - StatBank.dk/dnrentd
• Source: Banco Central do Brasil (SGS 432), Open Data Commons Open Database License (ODbL).

الشروط: بنك الاحتياطي الأسترالي · البنك الوطني التشيكي · الاحتياطي الفيدرالي

الأخطاء

• 400 invalid_query البلد أو التاريخ أو عامل التصفية غير صالح.
• 400 invalid_cursor مؤشر صفحات غير سليم التنسيق أو صادر لعوامل تصفية مختلفة.
• 401 invalid_api_key مفتاح Bearer مفقود أو مرفوض.
• 403 plan_upgrade_required يقع التاريخ المطلوب أو تنتهي الفترة المطلوبة قبل النطاق الزمني للبيانات التاريخية في خطتك.
• 404 series_not_found لا يوجد سعر فائدة يطابق الطلب، أو أن البلد غير مشمول بالتغطية.
• 409 cursor_expired تجاوز عمر مؤشر الصفحات 24 ساعة أو سُحبت بياناته.
• 429 rate_limit_exceeded تم بلوغ حد الطلبات خلال فترة قصيرة. انتظر المدة المحدّدة في Retry-After.
• 429 quota_exhausted استنفد الحساب حصته الشهرية.
• 503 economics_unavailable لا يمكن تقديم بيانات المصدر بأمان.

الأخطاء والحصة · مرجع واجهة API للاقتصاد · واجهة API لأسعار فائدة البنوك المركزية