API لأسعار فائدة البنوك المركزية

البيانات التي يمكنك قراءتها

تشمل التغطية سعر الفائدة الأساسي الرسمي للبنوك العشرة المدرجة أدناه. تحدد كل مشاهدة البلد والجهة والعملة والأداة. تُمثَّل الأسعار بسلاسل نصية عشرية كنسبة مئوية سنوية، ويُسمح بالقيم السالبة. تحتوي مشاهدة القيمة المفردة على rate وqualifier؛ ويحتوي النطاق على lower_bound وupper_bound.

البنوك والأدوات

رموز البلدان الأعضاء في منطقة اليورو المدعومة هي DEU وFRA وIRL وNLD وPRT وSVN وEST وLVA وLTU وHRV. يُرجع كل منها أداة ECB نفسها، مع بيانات تاريخية تبدأ من اعتماد ذلك البلد لليورو. أرسل رموز البلدان بأحرف كبيرة.

احصل على سعر الفائدة الحالي

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

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate"

تستخدم الاستجابة التوضيحية للولايات المتحدة مثال النطاق المحفوظ الساري من 11 ديسمبر 2025. يوضح مثال كندا استجابة بقيمة مفردة؛ وقيمته وتاريخه للتوضيح.

{
  "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"
}

{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.00",
  "qualifier": "exact",
  "unit": "percent",
  "observed_on": "2025-12-11"
}

احصل على سعر الفائدة في تاريخ سابق

مرر date=YYYY-MM-DD للحصول على أحدث مشاهدة في ذلك التاريخ أو قبله. لا تُنشأ بيانات اصطناعية للأيام المفقودة. تحتوي كل مشاهدة على حقل واحد فقط من effective_on أو observed_on؛ وقد يوجد announced_on أيضًا. حافظ على هذا التمييز عند مقارنة البلدان أو تسجيل تغيرات أسعار الفائدة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate?date=2025-12-11"

احصل على البيانات التاريخية

استخدم start وend وlimit في مسار البيانات التاريخية. الحد الافتراضي هو 100، والنطاق المسموح من 1 إلى 1000. تحتوي الاستجابات على country وobservations مرتبة من الأقدم إلى الأحدث وnext_cursor. مرر مؤشر التصفح المُرجع في cursor لطلب الصفحة التالية.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate/history?start=2025-12-11&end=2026-10-27&limit=100"

يثبّت مؤشر التصفح المنشورات لمدة 24 ساعة. تُرجع مؤشرات التصفح المنتهية الصلاحية أو حقوق الاستخدام المسحوبة الرمز 409. تُرجع المدخلات غير الصالحة الرمز 400، والبيانات غير المتاحة الرمز 404، وبيانات المصدر غير الآمنة الرمز 503. يستهلك كل طلب وحدة استخدام واحدة. راجع توثيق الأخطاء لمعالجة الأخطاء.

الاحتياطيات الرسمية

مسار الاحتياطيات المقرر هو /v1/economics/{country}/central-bank/reserves، مع المعامل الاختياري period=YYYY-MM. تشمل التغطية AUS وMYS والبلدان العشرة الأعضاء في منطقة اليورو المذكورة أعلاه وCZE عبر سلسلة ECB. تنشر أستراليا القيم بعملة AUD، وماليزيا بعملة MYR، وسلسلة ECB بعملة EUR. تحافظ الاستجابات على العملة المنشورة وعلى scale، إما units أو millions؛ ولا تُحوَّل القيم مطلقًا. تبقى الأشهر المفقودة مفقودة. يمثل released_on تاريخ تحديث الملف لدى الناشر.

المصادر

وحّدت Narwhal تنسيق بيانات بنك كندا. تقتصر التعديلات على بيانات ECB على التنسيق. تُقدَّم القيم كما نُشرت تمامًا. ولا يعني ذلك تأييد أي بنك.

• 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. https://www.bnm.gov.my/terms-of-use-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).

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

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

هل بيانات أسعار فائدة البنوك المركزية مجانية؟

يتوفر الوصول في جميع الخطط، بما فيها Free، مع بيانات آنية. يستهلك كل طلب وحدة استخدام واحدة. تتوفر البيانات الأصلية مجانًا على مواقع البنوك، وفقًا لشروط المصادر وإشعاراتها الواردة أعلاه.