يحتاج التقييم إلى علاوة مخاطر أسهم تعكس الدولة التي تنشأ فيها التدفقات النقدية. يعيد Narwhal لكل دولة علاوة السوق الناضجة وفارق التعثر للدولة وعلاوة مخاطر الدولة والإجمالي، ومسارًا لتكلفة رأس مال الشركة يستخدم العلاوة نفسها.
اقرأ علاوة مخاطر الأسهم لدولة ما
curl -s "https://api.narwhalapi.com/v1/economics/BRA/equity-risk-premium" \
-H "Authorization: Bearer $NARWHAL_API_KEY"{
"country": "BRA",
"as_of": "2026-11-01",
"unit": "percent",
"mature_erp": "3.2973",
"country_default_spread": "2.1300",
"volatility_ratio": "1.5211",
"country_risk_premium": "3.2400",
"total_erp": "6.5373",
"basis": {
"mature_erp": "observed",
"country_default_spread": "table",
"volatility_ratio": "table",
"country_risk_premium": "table",
"total_erp": "table"
},
"methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
}كل الأرقام بالنسبة المئوية، وas_of هو التاريخ الذي تصفه. الأرقام الخمسة يبني بعضها على بعض كما تصف منهجية علاوة مخاطر الأسهم.
mature_erpهي العلاوة الضمنية للسوق الناضجة، أي الولايات المتحدة. وهي نفسها في استجابة كل دولة.country_default_spreadهو العائد الإضافي الذي تدفعه الدولة فوق السوق الناضجة مقابل مخاطر التعثر.volatility_ratioهي تقلب الأسهم مقسومًا على تقلب السندات الحكومية.country_risk_premiumهي الفارق مضروبًا في النسبة. للبرازيل، 2.13 مضروبًا في 1.5211 يساوي 3.24.total_erpهيmature_erpزائدcountry_risk_premium. للبرازيل، 3.2973 زائد 3.24 يساوي 6.5373.
يبيّن الكائن basis أي الأجزاء observed أو modelled أو table. تأتي القيمة table من جدول عام لمخاطر الدول. هذه الصفوف حديثة بقدر حداثة الجدول، فتتحرك عند تحديثه وليس مع كل عائد سندات. استجابة الولايات المتحدة فيها فارق 0 وvolatility_ratio بقيمة null، لأن الولايات المتحدة هي السوق الناضجة، فيساوي total_erp لديها mature_erp.
حوّل العلاوة إلى تكلفة حقوق الملكية
تكلفة حقوق الملكية لمشروع في دولة ما تساوي السعر الخالي من المخاطر زائد بيتا مضروبة في العلاوة الإجمالية للدولة التي تنشأ فيها التدفقات. تنص المنهجية على أن الأرقام بالدولار الأمريكي، فاستخدم سعرًا خاليًا من المخاطر أمريكيًا. يقرأ السكربت عائد 10 سنوات الأمريكي من مسار منحنى العائد، ويأخذ بيتا الخاصة بك، ثم يقرأ كل الدول من GET /v1/economics/equity-risk-premium ويتحقق من أن mature_erp زائد country_risk_premium يساوي total_erp قبل أن يستخدم الصف.
- اختر المدخلات السعر الخالي من المخاطر يأتي من API. أما بيتا بقيمة 1.2 فهي قيمة مؤقتة لتقديرك الخاص، لأن مسار العلاوة لا يوفّر بيتا.
- شغّل السكربت يطبع عدد الدول وتكلفة حقوق الملكية لأربع منها.
import os from decimal import Decimal import requests HEAD = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"} API = "https://api.narwhalapi.com" def get(path, **params): r = requests.get(API + path, params=params, headers=HEAD, timeout=15) r.raise_for_status() return r.json() # Risk-free rate: the 10 year US yield, in percent rf = Decimal(get("/v1/economics/USA/yield-curve", maturity="10y")["yields"][0]["yield_percent"]) beta = Decimal("1.2") # your own estimate for the project countries = {c["country"]: c for c in get("/v1/economics/equity-risk-premium")["countries"]} print(len(countries), "countries") for code in ("USA", "IDN", "BRA", "ZAF"): c = countries[code] mature, crp, total = (Decimal(c[k]) for k in ("mature_erp", "country_risk_premium", "total_erp")) assert mature + crp == total print(f"{code} as_of {c['as_of']} mature {mature} crp {crp} total {total} " f"cost of equity {rf + beta * total:.2f}%") - قراءة النتيجة كان عائد 10 سنوات 4.91%. أعاد السكربت تكلفة حقوق ملكية 8.87% للولايات المتحدة و11.82 لإندونيسيا و12.75 للبرازيل و13.55 لجنوب أفريقيا، من بين 175 دولة في القائمة.
هذه معدلات خصم بالدولار. أما معدل العملة المحلية فيحتاج إلى إضافة فارق التضخم بين العملتين كما تنص المنهجية.
احصل على بيتا وتكلفة الدين وWACC لشركة مدرجة
للسهم المدرج، يجري مسار تكلفة رأس المال الحساب نفسه ويواصل حتى WACC. يعيد بيتا والسعر الخالي من المخاطر والعلاوة التي استخدمها وتكلفة حقوق الملكية وتكلفة الدين ومعدل الضريبة والأوزان في إجابة واحدة. العلاوة الافتراضية هي إجمالي Narwhal نفسه لدولة السهم. ويمكنك إرسال علاوتك بالمعامل erp. تسرد منهجية تكلفة رأس المال المعادلات وحالات الرفض.
curl -s "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/cost-of-capital" \
-H "Authorization: Bearer $NARWHAL_API_KEY"{
"id": "XNAS:MSFT",
"currency": "USD",
"beta": {
"window": "2y",
"frequency": "weekly",
"observations": 103,
"raw": "1.1507",
"adjusted": "1.1010",
"used": "raw"
},
"risk_free": {
"rate": "4.9100",
"source": "yield_curve",
"as_of": "2026-11-02"
},
"equity_risk_premium": {
"rate": "3.2973",
"source": "narwhal",
"country": "USA",
"as_of": "2026-11-01",
"basis": "observed"
},
"cost_of_equity": "8.7042",
"cost_of_debt": {
"pre_tax": "8.1917",
"after_tax": "6.0922",
"period": "ttm"
},
"tax_rate": {
"rate": "25.6300",
"basis": "table"
},
"weights": {
"equity": "99.0666",
"debt": "0.9334"
},
"wacc": "8.6798",
"warnings": [],
"methodology_url": "https://narwhalapi.com/methodology/cost-of-capital"
}قيمة cost_of_equity وهي 8.7042 تساوي السعر الخالي من المخاطر 4.91 زائد بيتا الخام 1.1507 مضروبة في العلاوة 3.2973. تعطي الأوزان 99.0666% لحقوق الملكية و0.9334% للدين، وقيمة wacc هي 8.6798%. في الاستجابة الكاملة يحمل كل مدخل أساسه وتاريخه، ويأتي الرقم الذي يحتاج إلى عناية مع بند في warnings، وهي فارغة هنا.
هل تتغير العلاوة مع الوقت؟
نعم. يسرد مسار التاريخ تواريخ سابقة. أعاد لإندونيسيا as_of بقيمة 2026-10-28 مع total_erp بقيمة 5.6830، وas_of بقيمة 2026-11-01 مع 5.7573، بينما بقي country_default_spread عند 1.6200. تحركت mature_erp من 3.2230 إلى 3.2973، وهذا حرّك الإجمالي.
احفظ تاريخ as_of بجانب أي سعر تستخدمه في تقييم، ليمكن تتبع الرقم لاحقًا. اقرأ مسار التاريخ حين تريد أن ترى كيف تحركت العلاوة بين التواريخ.
ماذا يحدث حين لا يستطيع مسار تكلفة رأس المال الإجابة؟
يعيد 422 ويسمّي المشكلة بدل ملء الفراغ. أعاد طلب AAPL الرمز inputs_unavailable مع تفصيل أن مصروف الفوائد غير مسجل. ويرفض المسار أيضًا البنوك وشركات التأمين. مرّر erp أو risk_free أو tax_rate الخاصة بك حيث يقبلها المسار، وعالج الخطأ 422 في الشيفرة.
ما الدول المشمولة؟
أعاد مسار القائمة 175 دولة في التشغيل أعلاه. لا تظهر الدولة إلا حين تتوفر كل مدخلاتها، فغياب الرمز يعني عدم وجود صف وليس صفرًا. أجابت البرازيل وإندونيسيا وجنوب أفريقيا، وكذلك الولايات المتحدة.
نُشر في .