جميع واجهات API

API منحنى العائد للسندات الحكومية بدقة

احصل على منحنيات العائد الحكومية في 9 دول ومناطق عبر REST وMCP. اقرأ بيانات تاريخ واحد للمصدر أو بيانات تاريخية مقسمة إلى صفحات، بقيم على هيئة سلاسل نصية لنسب مئوية عشرية.

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

الطلب الأول

منحنى العائد في Get the United Kingdom

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the United States

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Germany

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/DEU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Japan

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/JPN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Canada

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/CAN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Sweden

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/SWE/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Norway

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/NOR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Australia

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/AUS/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

منحنى العائد في Get the Euro area

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/EMU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

نقاط النهاية

GETمنحنيات عائد السندات الحكومية/v1/economics/{country}/yield-curve

رصد واحد لدولة: الأحدث، أو تاريخ المصدر الدقيق الذي تطلبه.

المعلمات

  • countryمطلوب

    رمز من ثلاثة أحرف: USA وGBR وDEU وJPN وCAN وSWE وNOR وAUS وEMU.

  • dateاختياري

    احذفه للحصول على أحدث مشاهدة معتمدة. القيمة المحددة تختار تلك الفترة بالضبط، وتعيد الفترات غير المتاحة الرمز 404.

  • version_idاختياري

    إصدار نشر ثابت اختياري. احذفه لقراءة المنحنى المعتمد الحالي.

  • curve_typeاختياري

    المعامل curve_type اختياري ويحدد المنحنى في كلا المسارين، ولا ينطبق إلا على NOR وAUS وEMU، إذ تقدم كل منها منحنيين. احذفه للحصول على المنحنى الأول، وتسميه الاستجابة في curve_type. المنحنى الذي لا تقدمه الدولة يعيد الخطأ 400.

  • maturityاختياري

    اختياري في كلا المسارين. احذفه للحصول على المنحنى المتاح كاملًا. USA: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y. GBR: 0.5y, 1y, 1.5y, 2y, 2.5y, 3y, 3.5y, 4y, 4.5y, 5y, 5.5y, 6y, 6.5y, 7y, 7.5y, 8y, 8.5y, 9y, 9.5y, 10y, 10.5y, 11y, 11.5y, 12y, 12.5y, 13y, 13.5y, 14y, 14.5y, 15y, 15.5y, 16y, 16.5y, 17y, 17.5y, 18y, 18.5y, 19y, 19.5y, 20y, 20.5y, 21y, 21.5y, 22y, 22.5y, 23y, 23.5y, 24y, 24.5y, 25y, 25.5y, 26y, 26.5y, 27y, 27.5y, 28y, 28.5y, 29y, 29.5y, 30y, 30.5y, 31y, 31.5y, 32y, 32.5y, 33y, 33.5y, 34y, 34.5y, 35y, 35.5y, 36y, 36.5y, 37y, 37.5y, 38y, 38.5y, 39y, 39.5y, 40y. DEU: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. JPN: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 15y, 20y, 25y, 30y, 40y. CAN: 0.25y, 0.5y, 0.75y, 1y, 1.25y, 1.5y, 1.75y, 2y, 2.25y, 2.5y, 2.75y, 3y, 3.25y, 3.5y, 3.75y, 4y, 4.25y, 4.5y, 4.75y, 5y, 5.25y, 5.5y, 5.75y, 6y, 6.25y, 6.5y, 6.75y, 7y, 7.25y, 7.5y, 7.75y, 8y, 8.25y, 8.5y, 8.75y, 9y, 9.25y, 9.5y, 9.75y, 10y, 10.25y, 10.5y, 10.75y, 11y, 11.25y, 11.5y, 11.75y, 12y, 12.25y, 12.5y, 12.75y, 13y, 13.25y, 13.5y, 13.75y, 14y, 14.25y, 14.5y, 14.75y, 15y, 15.25y, 15.5y, 15.75y, 16y, 16.25y, 16.5y, 16.75y, 17y, 17.25y, 17.5y, 17.75y, 18y, 18.25y, 18.5y, 18.75y, 19y, 19.25y, 19.5y, 19.75y, 20y, 20.25y, 20.5y, 20.75y, 21y, 21.25y, 21.5y, 21.75y, 22y, 22.25y, 22.5y, 22.75y, 23y, 23.25y, 23.5y, 23.75y, 24y, 24.25y, 24.5y, 24.75y, 25y, 25.25y, 25.5y, 25.75y, 26y, 26.25y, 26.5y, 26.75y, 27y, 27.25y, 27.5y, 27.75y, 28y, 28.25y, 28.5y, 28.75y, 29y, 29.25y, 29.5y, 29.75y, 30y. SWE: 1m, 3m, 6m, 2y, 5y, 7y, 10y. NOR: 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y. AUS: 2y, 3y, 5y, 10y. EMU: 3m, 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. تُزال التكرارات وتُرتَّب الآجال. تعيد التسميات غير المدعومة الخطأ 400.

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

  • countryسلسلة نصية بصيغة ISO alpha-3

    الدولة أو الإقليم المطلوب.

  • curve_type"nominal_par" | "nominal_zero_coupon" | "spot_svensson" | "constant_maturity_ytm" | "zero_coupon" | "constant_maturity_benchmark" | "spot_svensson_aaa"

    الولايات المتحدة: العائد الاسمي عند القيمة الاسمية (وزارة الخزانة الأمريكية). المملكة المتحدة: عائد الكوبون الصفري الاسمي بالرسملة المستمرة (بنك إنجلترا). ألمانيا: العائد الفوري وفق نموذج سفينسون (البنك المركزي الألماني، دويتشه بوندسبنك). اليابان: العائد حتى الاستحقاق لسندات الحكومة اليابانية (JGB) بأجل استحقاق ثابت (وزارة المالية اليابانية). كندا: عائد الكوبون الصفري (الخصم) (بنك كندا). السويد: عوائد مرجعية لأذون وسندات الحكومة (البنك المركزي السويدي، ريكسبنك). النرويج: عوائد الكوبون الصفري للأوراق المالية الحكومية (بنك النرويج، نورجيس بنك). أستراليا: عائد السندات الحكومية حتى الاستحقاق (بنك الاحتياطي الأسترالي). منطقة اليورو: الأسعار الفورية للسندات الحكومية المصنفة AAA (البنك المركزي الأوروبي).

  • dateسلسلة نصية بصيغة YYYY-MM-DD

    تاريخ المصدر المشترك بين جميع نقاط هذا المنحنى.

  • yieldsمصفوفة

    الآجال المتاحة، مرتبة من الأقصر إلى الأطول. تبقى مصفوفة حتى لو كان هناك أجل واحد فقط.

  • yields[].maturityسلسلة نصية

    إحدى تسميات الآجال المدعومة.

  • yields[].tenorسلسلة نصية

    tenor هو أجل الاستحقاق بصيغة مدة قياسية، فستة أشهر تُكتب P6M في كل دولة، سواء كتبها المصدر 6m أو 0.5y.

  • yields[].yield_percentسلسلة نصية لعدد عشري

    العائد بالنسبة المئوية، مع الحفاظ على دقة الكسور العشرية في المصدر.

المرجع الكامل ‏←
GETالبيانات التاريخية لـمنحنيات عائد السندات الحكومية/v1/economics/{country}/yield-curve/history

كل ملاحظة في النطاق، من الأقدم، بحد أقصى 1,000 في الصفحة. اتبع next_cursor حتى يصبح null.

المعلمات

  • countryمطلوب

    رمز من ثلاثة أحرف: USA وGBR وDEU وJPN وCAN وSWE وNOR وAUS وEMU.

  • startاختياري

    الحد الأدنى شاملًا. احذفه للبدء من أول فترة متاحة.

  • endاختياري

    الحد الأعلى شاملًا، ولا يجوز أن يسبق start. احذفه للانتهاء عند آخر فترة متاحة.

  • limitاختياري

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

  • cursorاختياري

    مرِّر next_cursor كما هو مع الدولة والمرشحات وlimit نفسها. تنتهي صلاحية المؤشرات بعد 24 ساعة.

  • as_ofاختياري

    يعيد المنحنيات كما نُشرت حتى نهاية هذا اليوم بتوقيت UTC.

  • curve_typeاختياري

    المعامل curve_type اختياري ويحدد المنحنى في كلا المسارين، ولا ينطبق إلا على NOR وAUS وEMU، إذ تقدم كل منها منحنيين. احذفه للحصول على المنحنى الأول، وتسميه الاستجابة في curve_type. المنحنى الذي لا تقدمه الدولة يعيد الخطأ 400.

  • maturityاختياري

    اختياري في كلا المسارين. احذفه للحصول على المنحنى المتاح كاملًا. USA: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y. GBR: 0.5y, 1y, 1.5y, 2y, 2.5y, 3y, 3.5y, 4y, 4.5y, 5y, 5.5y, 6y, 6.5y, 7y, 7.5y, 8y, 8.5y, 9y, 9.5y, 10y, 10.5y, 11y, 11.5y, 12y, 12.5y, 13y, 13.5y, 14y, 14.5y, 15y, 15.5y, 16y, 16.5y, 17y, 17.5y, 18y, 18.5y, 19y, 19.5y, 20y, 20.5y, 21y, 21.5y, 22y, 22.5y, 23y, 23.5y, 24y, 24.5y, 25y, 25.5y, 26y, 26.5y, 27y, 27.5y, 28y, 28.5y, 29y, 29.5y, 30y, 30.5y, 31y, 31.5y, 32y, 32.5y, 33y, 33.5y, 34y, 34.5y, 35y, 35.5y, 36y, 36.5y, 37y, 37.5y, 38y, 38.5y, 39y, 39.5y, 40y. DEU: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. JPN: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 15y, 20y, 25y, 30y, 40y. CAN: 0.25y, 0.5y, 0.75y, 1y, 1.25y, 1.5y, 1.75y, 2y, 2.25y, 2.5y, 2.75y, 3y, 3.25y, 3.5y, 3.75y, 4y, 4.25y, 4.5y, 4.75y, 5y, 5.25y, 5.5y, 5.75y, 6y, 6.25y, 6.5y, 6.75y, 7y, 7.25y, 7.5y, 7.75y, 8y, 8.25y, 8.5y, 8.75y, 9y, 9.25y, 9.5y, 9.75y, 10y, 10.25y, 10.5y, 10.75y, 11y, 11.25y, 11.5y, 11.75y, 12y, 12.25y, 12.5y, 12.75y, 13y, 13.25y, 13.5y, 13.75y, 14y, 14.25y, 14.5y, 14.75y, 15y, 15.25y, 15.5y, 15.75y, 16y, 16.25y, 16.5y, 16.75y, 17y, 17.25y, 17.5y, 17.75y, 18y, 18.25y, 18.5y, 18.75y, 19y, 19.25y, 19.5y, 19.75y, 20y, 20.25y, 20.5y, 20.75y, 21y, 21.25y, 21.5y, 21.75y, 22y, 22.25y, 22.5y, 22.75y, 23y, 23.25y, 23.5y, 23.75y, 24y, 24.25y, 24.5y, 24.75y, 25y, 25.25y, 25.5y, 25.75y, 26y, 26.25y, 26.5y, 26.75y, 27y, 27.25y, 27.5y, 27.75y, 28y, 28.25y, 28.5y, 28.75y, 29y, 29.25y, 29.5y, 29.75y, 30y. SWE: 1m, 3m, 6m, 2y, 5y, 7y, 10y. NOR: 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y. AUS: 2y, 3y, 5y, 10y. EMU: 3m, 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. تُزال التكرارات وتُرتَّب الآجال. تعيد التسميات غير المدعومة الخطأ 400.

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

  • countryسلسلة نصية بصيغة ISO alpha-3

    الدولة أو الإقليم المطلوب.

  • curve_type"nominal_par" | "nominal_zero_coupon" | "spot_svensson" | "constant_maturity_ytm" | "zero_coupon" | "constant_maturity_benchmark" | "spot_svensson_aaa"

    الولايات المتحدة: العائد الاسمي عند القيمة الاسمية (وزارة الخزانة الأمريكية). المملكة المتحدة: عائد الكوبون الصفري الاسمي بالرسملة المستمرة (بنك إنجلترا). ألمانيا: العائد الفوري وفق نموذج سفينسون (البنك المركزي الألماني، دويتشه بوندسبنك). اليابان: العائد حتى الاستحقاق لسندات الحكومة اليابانية (JGB) بأجل استحقاق ثابت (وزارة المالية اليابانية). كندا: عائد الكوبون الصفري (الخصم) (بنك كندا). السويد: عوائد مرجعية لأذون وسندات الحكومة (البنك المركزي السويدي، ريكسبنك). النرويج: عوائد الكوبون الصفري للأوراق المالية الحكومية (بنك النرويج، نورجيس بنك). أستراليا: عائد السندات الحكومية حتى الاستحقاق (بنك الاحتياطي الأسترالي). منطقة اليورو: الأسعار الفورية للسندات الحكومية المصنفة AAA (البنك المركزي الأوروبي).

  • observationsمصفوفة

    الأقدم أولًا. تُحذف الفترات المفقودة، ويعيد النطاق الصالح الخالي مصفوفة فارغة.

  • observations[].dateسلسلة نصية بصيغة YYYY-MM-DD

    تاريخ المصدر المشترك بين جميع نقاط هذا المنحنى.

  • observations[].yieldsمصفوفة

    الآجال المتاحة، مرتبة من الأقصر إلى الأطول. تبقى مصفوفة حتى لو كان هناك أجل واحد فقط.

  • observations[].yields[].maturityسلسلة نصية

    إحدى تسميات الآجال المدعومة.

  • observations[].yields[].tenorسلسلة نصية

    tenor هو أجل الاستحقاق بصيغة مدة قياسية، فستة أشهر تُكتب P6M في كل دولة، سواء كتبها المصدر 6m أو 0.5y.

  • observations[].yields[].yield_percentسلسلة نصية لعدد عشري

    العائد بالنسبة المئوية، مع الحفاظ على دقة الكسور العشرية في المصدر.

  • next_cursorسلسلة نصية أو null

    رمز متابعة معتم، والقيمة null تعني عدم وجود صفحة تالية.

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

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

هل ظهر منحنى العائد المقلوب؟ تحقق بالأرقام

قارن عائدين واقرأ الفارق بنقاط الأساس.

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

احسب سعر الفائدة الحقيقي

اطرح التضخم من العائد الاسمي باستخدام معادلة فيشر.

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

ملء السجل التاريخي

نزّل سلسلة كاملة صفحة بصفحة واستأنف إذا توقف التنزيل.

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

التغطية

  • الولايات المتحدةعائد اسمي عند القيمة الاسمية. يومي منذ 2 يناير 1990.
  • المملكة المتحدةعائد اسمي لسندات الكوبون الصفري بالرسملة المستمرة. يومي منذ 2 يناير 1979.
  • ألمانياعائد فوري بنموذج Svensson. يومي منذ 7 أغسطس 1997.
  • اليابانعائد حتى الاستحقاق لسندات JGB بأجل استحقاق ثابت. يومي منذ 1974.
  • كنداعائد السندات الصفرية الكوبون (المخصومة). يومي منذ 2 يناير 1986.
  • السويدعوائد مرجعية لأذون وسندات الحكومة. يومي منذ 3 يناير 1983.
  • النرويجعوائد السندات الحكومية الصفرية الكوبون. يومي منذ 2 يناير 2015.
  • أسترالياعائد السندات الحكومية حتى الاستحقاق. يومي منذ 20 مايو 2013.
  • منطقة اليوروأسعار فورية للسندات الحكومية بتصنيف AAA. يومي منذ 6 سبتمبر 2004.

المصادر

Japan's yield data is reused under Public Data License 1.0. Narwhal formats the source data for the API. This version was not created by the Ministry of Finance, Japan. Source licence

Source: Sveriges Riksbank. The data date is shown alongside the data. Narwhal has no official collaboration or partnership with the Riksbank.

Source: Norges Bank. Values are shown as published.

Source Reserve Bank of Australia 2026. The RBA publishes this data free of charge at rba.gov.au and does not endorse Narwhal.

Source: ECB. The ECB publishes this data free of charge at ecb.europa.eu, and values are shown as published.

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

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

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

استكشف API ‏←

تقويم الإصدارات الاقتصادية

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

استكشف API ‏←

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

كم مرة تُحدَّث البيانات؟

تتبع منحنيات وزارة الخزانة الأمريكية نشرها اليومي. يهدف بنك إنجلترا إلى النشر قبل الظهر بتوقيت Europe/London في يوم العمل التالي. يصدر البنك المركزي الألماني (دويتشه بوندسبنك) منحنيات يومية. تنشر وزارة المالية اليابانية في الساعة 09:30 بالتوقيت الياباني في يوم العمل التالي. ينشر بنك كندا المنحنى مرة واحدة تقريبًا في الأسبوع، بعد نحو 2 إلى 3 أسابيع من تاريخ المشاهدة. وعادةً ما يكون عمر أحدث منحنى من 2 إلى 3 أسابيع. ينشر البنك المركزي السويدي (ريكسبنك) في كل يوم عمل. ينشر بنك النرويج (نورجيس بنك) في كل يوم عمل. ينشر بنك الاحتياطي الأسترالي الجدول F2 في أيام العمل، وعادةً خلال يومين. ينشر البنك المركزي الأوروبي المنحنى في يوم العمل التالي. قد لا يتوفر منحنى جديد في عطلات نهاية الأسبوع والعطلات الرسمية. يمكن تعديل قيم المصدر. التحقق من المصدر لا يضمن وجود مشاهدة جديدة.

ماذا يحدث عند غياب قيمة؟

تُحذف الآجال المفقودة. لا تملأ Narwhal أي نقطة مفقودة من المصدر، ولا تستبدل منحنى أقدم به، ولا تختلق قيمة.

لماذا تختلف منحنيات العائد بين الدول؟

تختلف مقاييس المنحنى بحسب الدولة. احتفظ بالمصدر ونوع المنحنى والأجل مع كل قيمة.

هل تقدم الدولة منحنى ثانيًا؟

Norway: Use curve_type=constant_maturity_benchmark for Norges Bank generic rates: Treasury bills at 3, 6 and 12 months and government bonds at 3, 5, 7 and 10 years. تبدأ البيانات التاريخية في 2 يناير 2019. Australia: Use curve_type=zero_coupon for RBA table F17 zero-coupon yields, from 0.25 to 10 years in quarter-year steps. تبدأ البيانات التاريخية في 3 يناير 2017، ويضيف RBA الصفوف بعد نحو 1 شهر من تاريخها. Euro area: Use curve_type=spot_svensson_all_issuers for the ECB curve covering all euro area central government issuers: 3, 6 and 9 months, then 1 to 30 years in yearly steps, with daily history from 6 September 2004.

كيف أتصفح السجل التاريخي صفحةً صفحة؟

اختر بداية ونهاية شاملتين. تُعرض الاستجابات من الأقدم، بحد أقصى 1,000 تاريخ مصدر في الصفحة. اتبع next_cursor مع المرشحات وlimit نفسها حتى يصبح null. يحتفظ المؤشر بلقطة النشر لمدة تصل إلى 24 ساعة؛ وتعيد اللقطة المنتهية أو المسحوبة الخطأ 409، فأعد المحاولة بدون المؤشر.