مرجع API علاوة مخاطر الأسهم

علاوة مخاطر الأسهم وعلاوة مخاطر الدولة حسب الدولة

نظرة عامة

تقدير Narwhal لعلاوة مخاطر الأسهم: العائد الإضافي الذي يتوقعه المستثمرون من الأسهم فوق سند حكومي خالٍ من المخاطر. يحتاج كل طلب إلى مفتاح Bearer، ويسحب REST وMCP من رصيد واحد.

الدولة هي رمزها ISO 3166 alpha-3، مثل USA أو IDN. الإجمالي هو علاوة السوق الناضجة مضافاً إليها علاوة مخاطر الدولة، وعلاوة مخاطر الدولة هي هامش تعثر الدولة مضروباً في نسبة التقلب. كل رقم نسبة مئوية كسلسلة نصية عشرية بأربع منازل، عدا النسبة، فهي رقم عادي.

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

عنوان URL الأساسي: https://api.narwhalapi.com. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.

ما يحصل عليه كل حساب

ما	كل حساب
أحدث رقم لدولة	مشمول
أحدث رقم لكل دولة	مشمول
السجل	السجل التاريخي الكامل

راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.

A country appears only when we hold a row for it. Without a row the route returns 404 series_not_found; nothing is filled in or carried forward.
لا علاوة دولة للسوق الناضجة: ففي الولايات المتحدة هامش التعثر 0 ونسبة التقلب فارغة والإجمالي يساوي العلاوة الناضجة. وألمانيا، مرجع منطقة اليورو، علاوة دولتها 0 أيضاً.
الأرقام بالدولار الأمريكي. ويحتاج معدل الخصم بعملة أخرى إلى إضافة فرق التضخم بين العملتين.
يُقسَّم السجل التاريخي إلى صفحات حسب التاريخ: أرسل next_cursor الصفحة، مع المعاملات الأخرى نفسها، لقراءة التالية.
الأرقام تقديرات للتحليل، وليست نصيحة مالية أو استثمارية أو قانونية أو ضريبية.

نقاط النهاية

كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

احصل على علاوة مخاطر الأسهم لدولة

GET /v1/economics/{country}/equity-risk-premium

أحدث علاوة مخاطر أسهم لدولة واحدة، أو الأحدث في date أو قبله: علاوة السوق الناضجة، وهامش تعثر الدولة، ونسبة التقلب، وعلاوة مخاطر الدولة، والإجمالي، لكل منها أساسه.

أرسل date لقراءة أحدث رقم في ذلك اليوم أو قبله.

MCP: الأداة economics_get_equity_risk_premium.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`country`	مسار	نعم	سلسلة نصية
`date`	استعلام	لا	سلسلة نصية

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

حقل	النوع	يُرسل
`country`	سلسلة نصية	دائمًا
`as_of`	التاريخ	دائمًا
`unit`	always "percent"	دائمًا
`mature_erp`	سلسلة نصية	دائمًا
`country_default_spread`	سلسلة نصية	دائمًا
`volatility_ratio`	سلسلة نصية	دائمًا
`country_risk_premium`	سلسلة نصية	دائمًا
`total_erp`	سلسلة نصية	دائمًا
`basis`	كائن	دائمًا
`basis.mature_erp`	إحدى القيم: observed, modelled, table	دائمًا
`basis.country_default_spread`	إحدى القيم: observed, modelled, table	دائمًا
`basis.volatility_ratio`	إحدى القيم: observed, modelled, table	دائمًا
`basis.country_risk_premium`	إحدى القيم: observed, modelled, table	دائمًا
`basis.total_erp`	إحدى القيم: observed, modelled, table	دائمًا
`methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	اختياري

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium"

{
  "country": "ITA",
  "as_of": "2026-10-28",
  "unit": "percent",
  "mature_erp": "3.2230",
  "country_default_spread": "0.8881",
  "volatility_ratio": "2.0310",
  "country_risk_premium": "1.8037",
  "total_erp": "5.0267",
  "basis": {
    "mature_erp": "observed",
    "country_default_spread": "observed",
    "volatility_ratio": "modelled",
    "country_risk_premium": "modelled",
    "total_erp": "modelled"
  },
  "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
}

احصل على سجل علاوة مخاطر الأسهم

GET /v1/economics/{country}/equity-risk-premium/history

علاوة مخاطر الأسهم لدولة واحدة حسب التاريخ، الأقدم أولاً، بتقسيم إلى صفحات عبر next_cursor.

MCP: الأداة economics_get_equity_risk_premium_history.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`country`	مسار	نعم	سلسلة نصية
`start`	استعلام	لا	سلسلة نصية
`end`	استعلام	لا	سلسلة نصية
`limit`	استعلام	لا	عدد صحيح
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.

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

حقل	النوع	يُرسل	المعنى
`country`	سلسلة نصية	دائمًا
`observations`	قائمة كائنات	دائمًا
`observations[].country`	سلسلة نصية	دائمًا
`observations[].as_of`	التاريخ	دائمًا
`observations[].unit`	always "percent"	دائمًا
`observations[].mature_erp`	سلسلة نصية	دائمًا
`observations[].country_default_spread`	سلسلة نصية	دائمًا
`observations[].volatility_ratio`	سلسلة نصية	دائمًا
`observations[].country_risk_premium`	سلسلة نصية	دائمًا
`observations[].total_erp`	سلسلة نصية	دائمًا
`observations[].basis`	كائن	دائمًا
`observations[].basis.mature_erp`	إحدى القيم: observed, modelled, table	دائمًا
`observations[].basis.country_default_spread`	إحدى القيم: observed, modelled, table	دائمًا
`observations[].basis.volatility_ratio`	إحدى القيم: observed, modelled, table	دائمًا
`observations[].basis.country_risk_premium`	إحدى القيم: observed, modelled, table	دائمًا
`observations[].basis.total_erp`	إحدى القيم: observed, modelled, table	دائمًا
`observations[].methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	اختياري
`next_cursor`	سلسلة نصية	دائمًا	Pass as cursor to read the next page. Always sent; null on the last page.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium/history?start=2026-01-01"

{
  "country": "ITA",
  "observations": [
    {
      "country": "ITA",
      "as_of": "2026-09-01",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    },
    {
      "country": "ITA",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    }
  ],
  "next_cursor": null
}

سرد علاوات مخاطر الأسهم لكل الدول

GET /v1/economics/equity-risk-premium

أحدث علاوة مخاطر أسهم لكل دولة لها علاوة، مرتبة حسب الدولة.

MCP: الأداة economics_list_equity_risk_premium.

المعلمات

لا يأخذ هذا المسار أي معاملات.

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

حقل	النوع	يُرسل
`countries`	قائمة كائنات	دائمًا
`countries[].country`	سلسلة نصية	دائمًا
`countries[].as_of`	التاريخ	دائمًا
`countries[].unit`	always "percent"	دائمًا
`countries[].mature_erp`	سلسلة نصية	دائمًا
`countries[].country_default_spread`	سلسلة نصية	دائمًا
`countries[].volatility_ratio`	سلسلة نصية	دائمًا
`countries[].country_risk_premium`	سلسلة نصية	دائمًا
`countries[].total_erp`	سلسلة نصية	دائمًا
`countries[].basis`	كائن	دائمًا
`countries[].basis.mature_erp`	إحدى القيم: observed, modelled, table	دائمًا
`countries[].basis.country_default_spread`	إحدى القيم: observed, modelled, table	دائمًا
`countries[].basis.volatility_ratio`	إحدى القيم: observed, modelled, table	دائمًا
`countries[].basis.country_risk_premium`	إحدى القيم: observed, modelled, table	دائمًا
`countries[].basis.total_erp`	إحدى القيم: observed, modelled, table	دائمًا
`countries[].methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	اختياري

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/equity-risk-premium"

{
  "countries": [
    {
      "country": "DEU",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.0000",
      "volatility_ratio": "2.5462",
      "country_risk_premium": "0.0000",
      "total_erp": "3.2230",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "observed",
        "country_risk_premium": "observed",
        "total_erp": "observed"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    },
    {
      "country": "ITA",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    }
  ]
}

الأخطاء

تستخدم الأخطاء بنية المشكلة المشتركة مع: request_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.

الرمز	الحالة	المعنى
`invalid_query`	400	معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
`series_not_found`	404	لا نملك علاوة مخاطر أسهم لهذه الدولة.
`invalid_cursor`	400	مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
`insufficient_credits`	402	رصيدك أقل من تكلفة الطلب.
`economics_unavailable`	503	بيانات الاقتصاد لا تستطيع الإجابة الآن. حاول بعد قليل.

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