إنشاء تمارين اقتصاد ببيانات حقيقية من مصادر رسمية

التمرين 1: سعر الفائدة الحقيقي

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

curl -s "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "country": "USA",
  "authority": "federal_reserve",
  "currency": "USD",
  "instrument": "federal_funds_target_range",
  "unit": "percent",
  "effective_on": "2026-09-17",
  "observed_on": null,
  "announced_on": null,
  "rate_type": "range",
  "lower_bound": "3.75",
  "upper_bound": "4.00"
}

curl -s "https://api.narwhalapi.com/v1/economics/USA/inflation" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "country": "USA",
  "period": "2026-09",
  "year_over_year": "3.7",
  "month_over_month": "0.6",
  "year_to_date": "4.0",
  "released_on": "2026-10-14"
}

يصل سعر الفائدة الرئيسي على شكل نطاق، إذ تبلغ lower_bound 3.75 وupper_bound 4.00، فيكون السؤال الأول للصف: أي رقم واحد نستخدم؟ يأخذ السكربت نقطة المنتصف 3.875. أما التضخم فقيمة year_over_year له 3.7 للفترة 2026-09. ويلي ذلك سؤال ثانٍ: السعر هو المستوى المحدد اليوم، بينما يصف رقم التضخم الأشهر الاثني عشر الماضية، فالنتيجة سعر فائدة حقيقي ينظر إلى الوراء. اسأل الطلاب عما يحتاج المستثمر إلى معرفته بدلا من ذلك.

التمرين 2: نمو الأسعار الكامن في الناتج المحلي الإجمالي

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

curl -s "https://api.narwhalapi.com/v1/economics/USA/gdp/observations?start=2025-Q3&end=2026-Q3" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "annualized": true,
  "country": "USA",
  "as_of": "2026-10-29T00:00:00Z",
  "currency": "USD",
  "observations": [
    {
      "period": "2025-Q3",
      "value": "31180493000000"
    },
    {
      "period": "2025-Q4",
      "value": "31462523000000"
    },
    {
      "period": "2026-Q1",
      "value": "31906274000000"
    },
    {
      "period": "2026-Q2",
      "value": "32563030000000"
    },
    {
      "period": "2026-Q3",
      "value": "33010036000000"
    }
  ]
}

curl -s "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q3" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "country": "USA",
  "period": "2026-Q3",
  "year_over_year": "2.1",
  "quarter_over_quarter": "0.832",
  "released_on": "2026-10-29"
}

المستويات بالأسعار الجارية وبالدولار الأمريكي، وقيمة annualized فيها true. استجابة النمو حقيقية، وقيمة year_over_year فيها 2.1 للربع 2026-Q3. يشير الطلبان إلى الربع نفسه والمدة نفسها، وهذا مهم. فخلط معدل سنوي بمعدل ربع سنوي يعطي جوابا لا معنى له، لذا اطلب من الطلاب تسمية مدة كل رقم قبل القسمة، وكتابتها بجانب النتيجة في دفاترهم.

تنفيذ الحسابين

1. سعر الفائدة الحقيقي (تقريبي) اطرح التضخم من السعر الاسمي: 3.875 ناقص 3.7 يساوي 0.175 نقطة مئوية. هذه هي الطريقة المختصرة التي يتعرف عليها الطلاب أولا.
2. سعر الفائدة الحقيقي (دقيق) اقسم واحدا زائد السعر الاسمي على واحد زائد التضخم ثم اطرح واحدا: 1.03875 مقسومة على 1.037 ناقص واحد تساوي 0.169 بالمئة. يختلف الجوابان في الخانة العشرية الثالثة، وهذه نقطة مفيدة للنقاش.
3. نمو الناتج المحلي الإجمالي الاسمي اقسم مستوى 2026-Q3 على مستوى 2025-Q3، أي 33010036000000 على 31180493000000، ثم اطرح واحدا. النتيجة 5.87 بالمئة.
4. نمو الأسعار الضمني اقسم واحدا زائد النمو الاسمي على واحد زائد النمو الحقيقي، أي 1.0587 على 1.021، ثم اطرح واحدا. النتيجة 3.69 بالمئة.
   Python، التمرينان معا

   import os
   import requests
   
   BASE = "https://api.narwhalapi.com"
   HEAD = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   
   def get(path, **params):
       r = requests.get(BASE + path, params=params, headers=HEAD, timeout=15)
       r.raise_for_status()
       return r.json()
   
   # Exercise 1: the real policy rate
   policy = get("/v1/economics/USA/central-bank/policy-rate")
   lower, upper = float(policy["lower_bound"]), float(policy["upper_bound"])
   rate = (lower + upper) / 2
   inflation = float(get("/v1/economics/USA/inflation")["year_over_year"])
   approx = rate - inflation
   exact = ((1 + rate / 100) / (1 + inflation / 100) - 1) * 100
   print(f"policy {rate}  inflation {inflation}  approx {approx:.3f}  exact {exact:.3f}")
   
   # Exercise 2: how much of nominal GDP growth is price growth
   levels = get("/v1/economics/USA/gdp/observations", start="2025-Q3", end="2026-Q3")
   by_quarter = {o["period"]: float(o["value"]) for o in levels["observations"]}
   nominal = (by_quarter["2026-Q3"] / by_quarter["2025-Q3"] - 1) * 100
   real = float(get("/v1/economics/USA/gdp-growth", period="2026-Q3")["year_over_year"])
   prices = ((1 + nominal / 100) / (1 + real / 100) - 1) * 100
   print(f"nominal {nominal:.2f}  real {real}  implied price growth {prices:.2f}")

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

ما التمارين الأخرى التي تناسب البيانات نفسها؟

• التضخم: قارن حقلي التغير الشهري والتغير السنوي في استجابة واحدة، واسأل أيهما يستشهد به البنك المركزي. تتيح حاسبة التضخم للطلاب التحقق من النتيجة يدويا.
• منحنى العائد: خذ عائد 2 سنة وعائد 10 سنوات من مسار منحنى العائد واحسب الفارق، كما في دليل التحقق من انعكاس منحنى العائد.
• نمو الناتج المحلي الإجمالي: كرر التمرين 2 لدولة أخرى، وقارن أولا علامة annualized لكل دولة.

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

هل يستطيع الطلاب استخدام بلدهم؟

غالبا نعم، لكن تحقق من التغطية أولا. أعادت إندونيسيا والبرازيل معدل التضخم وسعر الفائدة الرئيسي معا، بينما أعادت المكسيك التضخم دون سعر فائدة رئيسي، مع الرمز 404 والرمز series_not_found. أعط الطلاب قائمة قصيرة بدول جربتها بنفسك، ودعهم يتعاملون مع 404 على أنه فجوة في البيانات داخل دفترهم.

لماذا تحمل بعض مستويات الناتج المحلي الإجمالي علامة annualized؟

أعادت الولايات المتحدة واليابان وكندا القيمة true في annualized، فمستوياتها الفصلية معبر عنها بمعدل سنوي. ولم تعد المملكة المتحدة وألمانيا هذه العلامة. لا تتأثر النسبة بين مستويين من السلسلة نفسها، ولهذا ينجح التمرين 2، لكن لا يمكن مقارنة مستويات دولتين قبل أن تتفق العلامة والعملة والفترة.

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

تعرض كل استجابة released_on وperiod، فيرى الطلاب مدى قدم الرقم. في الدرس، ثبّت تاريخ جلب البيانات واحتفظ بالمخرجات، لأن طلبا لاحقا قد يعيد فترة أحدث وجوابا مختلفا.