مرجع API تاريخ منحنى العائد

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

طلب

GET /v1/economics/{country}/yield-curve/history

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"

الولايات المتحدة طلب

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

ألمانيا طلب

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

اليابان طلب

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

كندا طلب

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

السويد طلب

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

النرويج طلب

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

أستراليا طلب

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

منطقة اليورو طلب

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

REST and MCP use the same Bearer key, response schema and credit balance. MCP tool: economics_get_yield_curve_history.

المعلمات

الاسم	النوع	مطلوب	المعنى
`country`	المسار · ISO alpha-3	نعم	رموز الدول المدعومة: USA, GBR, DEU, JPN, CAN, SWE, NOR, AUS, EMU. الولايات المتحدة: العائد الاسمي عند القيمة الاسمية (وزارة الخزانة الأمريكية). المملكة المتحدة: عائد الكوبون الصفري الاسمي بالرسملة المستمرة (بنك إنجلترا). ألمانيا: العائد الفوري وفق نموذج سفينسون (البنك المركزي الألماني، دويتشه بوندسبنك). اليابان: العائد حتى الاستحقاق لسندات الحكومة اليابانية (JGB) بأجل استحقاق ثابت (وزارة المالية اليابانية). كندا: عائد الكوبون الصفري (الخصم) (بنك كندا). السويد: عوائد مرجعية لأذون وسندات الحكومة (البنك المركزي السويدي، ريكسبنك). النرويج: عوائد الكوبون الصفري للأوراق المالية الحكومية (بنك النرويج، نورجيس بنك). أستراليا: عائد السندات الحكومية حتى الاستحقاق (بنك الاحتياطي الأسترالي). منطقة اليورو: الأسعار الفورية للسندات الحكومية المصنفة AAA (البنك المركزي الأوروبي).
`start`	سلسلة نصية بصيغة YYYY-MM-DD	لا	الحد الأدنى شاملًا. احذفه للبدء من أول فترة متاحة.
`end`	سلسلة نصية بصيغة YYYY-MM-DD	لا	الحد الأعلى شاملًا، ولا يجوز أن يسبق start. احذفه للانتهاء عند آخر فترة متاحة.
`limit`	عدد صحيح · 1–1000	لا	القيمة الافتراضية 100. يحسب التواريخ أو السنوات، لا نقاط العائد المفردة.
`cursor`	سلسلة نصية معتمة	لا	مرِّر next_cursor كما هو مع الدولة والمرشحات وlimit نفسها. تنتهي صلاحية المؤشرات بعد 24 ساعة.
`as_of`	سلسلة نصية بصيغة YYYY-MM-DD	لا	يعيد المنحنيات كما نُشرت حتى نهاية هذا اليوم بتوقيت 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.

أبقِ الدولة والنطاق واختيار آجال الاستحقاق (حيثما ينطبق) والحد دون تغيير عند اتباع المؤشر. يعتمد الترقيم على لقطة نشر واحدة غير قابلة للتغيير. الحد الافتراضي 100 فترة، والحد الأقصى 1,000. التاريخ الذي لا يوجد له منحنى، مثل عطلة نهاية الأسبوع، ونطاق السجل التاريخي الذي لا توجد فيه منحنيات، كلاهما يُرجع: 404 series_not_found.

الاستجابة

استجابة نموذجية عينة محفوظة من المصدر · وليست طلبًا مباشرًا

{
  "country": "GBR",
  "curve_type": "nominal_zero_coupon",
  "observations": [
    {
      "date": "2026-09-09",
      "yields": [
        {
          "maturity": "2y",
          "tenor": "P2Y",
          "yield_percent": "4.4821473122101274"
        },
        {
          "maturity": "10y",
          "tenor": "P10Y",
          "yield_percent": "5.2493002729396405"
        }
      ]
    },
    {
      "date": "2026-09-10",
      "yields": [
        {
          "maturity": "2y",
          "tenor": "P2Y",
          "yield_percent": "4.6509003413966044"
        },
        {
          "maturity": "10y",
          "tenor": "P10Y",
          "yield_percent": "5.3572243604351168"
        }
      ]
    }
  ],
  "next_cursor": null
}

حقل	النوع	المعنى
`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 تعني عدم وجود صفحة تالية.

تبقى القيم نصوصًا عشرية. لا يُختلق أي طابع زمني للمصدر ولا تاريخ نشر. Request IDs, cost and balance are returned in headers.

أخطاء API والرصيد

الحالة	المعنى
`400`	صيغة الدولة أو التاريخ أو السنة أو النطاق أو أجل الاستحقاق أو الحد أو المؤشر غير صالحة.
`401`	مفتاح API مفقود أو مرفوض.
`404`	لا توجد ملاحظة متاحة تطابق التاريخ أو السنة أو النطاق أو آجال الاستحقاق المحددة بدقة.
`409`	انتهت صلاحية لقطة النشر أو سُحبت. أعد البدء دون المؤشر.
`429`	تم بلوغ حد المعدل.
`503`	لا يمكن تقديم البيانات المقبولة بأمان.

A successful response costs one call, including an empty history result. Errors cost nothing. الأخطاء والترويسات المشتركة ‏←

التغطية وحداثة البيانات

الولايات المتحدة · USA، المملكة المتحدة · GBR، ألمانيا · DEU، اليابان · JPN، كندا · CAN، السويد · SWE، النرويج · NOR، أستراليا · AUS، منطقة اليورو · EMU · الولايات المتحدة: 2 يناير 1990 فصاعدًا · المملكة المتحدة: 2 يناير 1979 فصاعدًا · ألمانيا: 7 أغسطس 1997 فصاعدًا · اليابان: 1974 فصاعدًا · كندا: 2 يناير 1986 فصاعدًا · السويد: 3 يناير 1983 فصاعدًا · النرويج: 2 يناير 2015 فصاعدًا · أستراليا: 20 مايو 2013 فصاعدًا · منطقة اليورو: 6 سبتمبر 2004 فصاعدًا. تتبع منحنيات وزارة الخزانة الأمريكية نشرها اليومي. يهدف بنك إنجلترا إلى النشر قبل الظهر بتوقيت Europe/London في يوم العمل التالي. يصدر البنك المركزي الألماني (دويتشه بوندسبنك) منحنيات يومية. تنشر وزارة المالية اليابانية في الساعة 09:30 بالتوقيت الياباني في يوم العمل التالي. ينشر بنك كندا المنحنى مرة واحدة تقريبًا في الأسبوع، بعد نحو 2 إلى 3 أسابيع من تاريخ المشاهدة. وعادةً ما يكون عمر أحدث منحنى من 2 إلى 3 أسابيع. ينشر البنك المركزي السويدي (ريكسبنك) في كل يوم عمل. ينشر بنك النرويج (نورجيس بنك) في كل يوم عمل. ينشر بنك الاحتياطي الأسترالي الجدول F2 في أيام العمل، وعادةً خلال يومين. ينشر البنك المركزي الأوروبي المنحنى في يوم العمل التالي. قد لا يتوفر منحنى جديد في عطلات نهاية الأسبوع والعطلات الرسمية. يمكن تعديل قيم المصدر. التحقق من المصدر لا يضمن وجود مشاهدة جديدة.

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

الولايات المتحدة: العائد الاسمي عند القيمة الاسمية. سجل يومي من 2 يناير 1990. الآجال: من شهر واحد إلى 30 سنة.

المصدر: وزارة الخزانة الأمريكية

المملكة المتحدة: العائد الاسمي للسندات صفرية القسيمة باحتساب الفائدة المركبة المستمرة. سجل يومي من 2 يناير 1979. الآجال: من 0.5 إلى 40 سنة، بفواصل نصف سنة.

المصدر: بنك إنجلترا

ألمانيا: العائد الفوري وفق نموذج سفينسون. سجل يومي من 7 أغسطس 1997. الآجال: من سنة واحدة إلى 30 سنة، بفواصل سنة.

المصدر: البنك الاتحادي الألماني

اليابان: العائد حتى الاستحقاق للسندات الحكومية اليابانية ذات الأجل الثابت. سجل يومي من 1974. الآجال: من سنة واحدة إلى 10 سنوات، ثم 15 و20 و25 و30 و40 سنة.

المصدر: وزارة المالية اليابانية

يُعاد استخدام بيانات العوائد اليابانية بموجب ترخيص البيانات العامة 1.0 (Public Data License 1.0). تنسّق Narwhal بيانات المصدر لتناسب واجهة API. لم تُعدّ وزارة المالية اليابانية هذه النسخة. ترخيص المصدر

كندا: عائد السندات عديمة القسيمة (الخصم). سجل يومي من 2 يناير 1986. الآجال: من 0.25 إلى 30 سنة، بفواصل ربع سنة؛ وحتى 25 سنة قبل عام 1991.

المصدر: بنك كندا

السويد: العوائد المرجعية لأذون الخزانة والسندات الحكومية. سجل يومي من 3 يناير 1983. الآجال: أذون الخزانة بآجال 1 و3 و6 أشهر؛ والسندات الحكومية بآجال 2 و5 و7 و10 سنوات، مع سلاسل زمنية للسندات تبدأ بين عامي 1985 و1987.

المصدر: البنك المركزي السويدي

المصدر: البنك المركزي السويدي. يُعرض تاريخ البيانات إلى جانب البيانات. لا توجد علاقة تعاون أو شراكة رسمية بين Narwhal والبنك المركزي السويدي. ترخيص المصدر

النرويج: عوائد الأوراق المالية الحكومية عديمة القسيمة. سجل يومي من 2 يناير 2015. الآجال: 6 و9 أشهر، ثم من 1 إلى 10 سنوات بفاصل سنة واحدة.

المصدر: البنك المركزي النرويجي

المصدر: البنك المركزي النرويجي. تُعرض القيم كما نُشرت. ترخيص المصدر

أستراليا: عائد السندات الحكومية حتى الاستحقاق. سجل يومي من 20 مايو 2013. الآجال: 2 و3 و5 و10 سنوات، وتبدأ سلسلة 10 سنوات في مايو 2013 والسلاسل الأخرى في سبتمبر 2013.

المصدر: بنك الاحتياطي الأسترالي

المصدر بنك الاحتياطي الأسترالي 2026. ينشر RBA هذه البيانات مجانًا على rba.gov.au ولا يؤيد Narwhal. ترخيص المصدر

منطقة اليورو: المعدلات الفورية للسندات الحكومية ذات التصنيف AAA. سجل يومي من 6 سبتمبر 2004. الآجال: 3 و6 و9 أشهر، ثم من 1 إلى 30 سنة بفاصل سنة واحدة.

المصدر: البنك المركزي الأوروبي

المصدر: ECB. ينشر ECB هذه البيانات مجانًا على ecb.europa.eu، وتُعرض القيم كما نُشرت. ترخيص المصدر

نظرة عامة على مجموعة البيانات ‏←

هل كانت هذه الصفحة مفيدة؟