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

نفّذ ذلك باستخدام واجهة API

اجلب العائد الاسمي والتضخم كلًا على حدة، ثم ضعهما في الحساب نفسه. تحتوي استجابة العائد على date، بينما تحتوي استجابة التضخم على period. احتفظ بهذين التاريخين مع النتيجة ليكون لسعر الفائدة الحقيقي مرجع واضح لكل من سعره الاسمي ومدخل التضخم.

استخدم GET /v1/economics/USA/yield-curve?maturity=10y للمدخل الاسمي وGET /v1/economics/USA/inflation لمدخل التضخم. الحقل الاسمي نسبة مئوية سنوية، وحقل التضخم نسبة مئوية خلال آخر 12 شهرًا. يحوّل السكربت كل مدخل نسبة مئوية داخل تعبير فيشر، ثم يضرب النتيجة في 100 ليطبعها نسبةً مئوية.

1. احصل على مفتاح API مجاني أنشئ مفتاحًا مجانيًا. تستخدم Narwhal حسابًا واحدًا ومفتاح API واحدًا لجميع واجهات بياناتها، وتشترك REST وMCP في هذا المفتاح.
2. ضبط متغير البيئة احفظ المفتاح في NARWHAL_API_KEY. يقرأ السكربت هذا المتغير ويرسل المفتاح بصيغة Authorization: Bearer YOUR_KEY مع كل طلب إلى https://api.narwhalapi.com.
3. جلب المدخلات وحساب السعر استخدم سكربت Python لطلب منحنى العائد الأمريكي مع maturity=10y ومعدل التضخم الأمريكي. يقرأ yield_percent من المصفوفة yields وyear_over_year من استجابة التضخم، ثم يطبع نتيجتي الطرح وفيشر.
   Python: سعر الفائدة الحقيقي الأمريكي لأجل 10 سنوات

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1/economics/USA"
   curve = requests.get(
       f"{API}/yield-curve", params={"maturity": "10y"}, headers=H, timeout=10
   ).json()
   inflation = requests.get(f"{API}/inflation", headers=H, timeout=10).json()
   
   nominal = float(curve["yields"][0]["yield_percent"])  # percent a year
   cpi = float(inflation["year_over_year"])  # percent over the last 12 months
   print(f"nominal {nominal}%  inflation {cpi}% ({inflation['period']})")
   print(f"approximate real rate  {nominal - cpi:.2f}%")
   print(
       f"exact (Fisher) real rate {((1 + nominal / 100) / (1 + cpi / 100) - 1) * 100:.2f}%"
   )

4. احتفظ بفترة التضخم مع النتيجة اقرأ فترة التضخم المطبوعة بجانب معدلات الإدخال. يستخدم السكربت استجابة التضخم مدخلًا للتضخم؛ وفي الحساب الاستشرافي، قدّم رقم التضخم المتوقع الذي تحدده بنفسك بدلًا من ذلك المعدل التاريخي.

نفّذ ذلك في جدول بيانات أو دون شيفرة

ضع العائد الاسمي في B1 ومعدل التضخم السنوي في B2، وكلاهما رقم معبَّر عنه بالنسبة المئوية. تقسم الصيغة كل مدخل على 100 قبل إجراء حساب فيشر، لذلك يجب أن تستخدم مدخلات الخلايا الوحدات نفسها التي تستخدمها حقول API. احتفظ بتاريخ العائد وفترة التضخم بجانب المدخلات.

=(1+B1/100)/(1+B2/100)-1

نسّق النتيجة كنسبة مئوية. تنتج القسمة السعر المعدَّل بالتضخم في صورة كسر، ويعرض تنسيق النسبة المئوية هذا الكسر كسعر فائدة. إذا أردت نظرة تقريبية، فاستخدم صيغة الطرح بدلًا من ذلك. وبالمدخلات المئوية نفسها، تعيد الفرق بالنقاط المئوية مباشرة.

=B1-B2

يتيح لك الجدول أيضًا استبدال مدخل التضخم التاريخي بتوقعك الخاص. أبقِ هذا الاختيار ظاهرًا بجانب المدخل، لأن النتيجة المبنية على التضخم المتوقع تجيب عن سؤال مختلف عن النتيجة المبنية على التضخم الذي حدث بالفعل.

متى تستخدم كل خيار

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

أي أجل للعائد أستخدم؟

اختر أجل العائد بما يناسب أفقك الزمني: استخدم 2y للأجل القصير و10y للأجل الطويل. تقبل المعلمة maturity قيمًا مثل 3m و1y و2y و10y و30y. يختار السكربت المرفق 10y، لذا فإن نتيجته سعر فائدة حقيقي مبني على عائد السندات الأمريكية لأجل 10 سنوات.

إذا غيّرت الأجل، فاذكر ذلك الأجل في وصف نتيجتك. يستخدم الحساب العائد الاسمي الذي تختاره، لذلك يكون الأفق الزمني جزءًا من معنى سعر الفائدة الحقيقي الناتج.

لماذا تختلف صيغتا سعر الفائدة الحقيقي؟

تتجاهل صيغة الطرح المختصرة الحد التقاطعي في معادلة فيشر. في مثال 23 أكتوبر 2026، يعطي عائد اسمي 5.00% وتضخم سبتمبر 2026 عند 3.70% نتيجة 1.30% بالطرح و1.25% بمعادلة فيشر، أي فارق 0.05 نقطة مئوية. ويزداد الفارق عند الأسعار الأعلى.

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

أي معدل تضخم أستخدم مع عائد سنوي؟

استخدم أحدث معدل تضخم عام على أساس سنوي في الحساب بأثر رجعي. حقل API هو year_over_year. خلط معدل تضخم شهري بعائد سنوي يعطي إجابة خاطئة لأن المدخلين يصفان فترتين مختلفتين.

أبقِ فترة مرجع التضخم ظاهرة حتى لو اختلفت عن تاريخ العائد. في مثال 23 أكتوبر 2026 المحسوب، مدخل التضخم هو رقم سبتمبر 2026 على أساس سنوي. تحدد هذه الفترة التضخم التاريخي المستخدم في الحساب.

مثال محلول: السندات الأمريكية لأجل 10 سنوات، 23 أكتوبر 2026

في 23 أكتوبر 2026، بلغ العائد الاسمي للسندات الأمريكية لأجل 10 سنوات 5.00%. وكان مدخل التضخم 3.70% لشهر سبتمبر 2026. ابدأ بهذين المدخلين المئويين، وحوّلهما إلى معاملي النمو اللذين تستخدمهما معادلة فيشر، ثم اقسم المعامل الاسمي على معامل التضخم.

بمدخلات 23 أكتوبر 2026، تطرح الحسبة السريعة تضخم سبتمبر 2026 البالغ 3.70% من العائد الاسمي 5.00%، فتعطي 1.30%. أما بمعادلة فيشر، فمعامل النمو الاسمي 1.0500 ومعامل نمو التضخم 1.0370، ونسبتهما 1.01254. اطرح 1 من النسبة غير المقرَّبة وعبّر عن الناتج نسبةً مئوية، فيظهر 1.25%. أبقِ ناتج القسمة غير المقرَّب في الصيغة حتى العرض النهائي حتى لا تصبح النسبة الوسيطة المقرَّبة مدخلًا جديدًا.