جميع واجهات API

API أسعار الفائدة

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

احصل على مفتاح API مجاني

اقرأ التوثيق ‏←

متاح99.94% uptime, last 30 أيام378 ms زمن الاستجابة المعتاد

الطلب الأول

احصل على منحنى العائد

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منحنيات عائد السندات الحكومية/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.