واجهة API للتضخم

الطلب الأول

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/inflation?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا

{
  "country": "USA",
  "period": "2026-07",
  "year_over_year": "3.651",
  "month_over_month": "0.153",
  "year_to_date": "0.755",
  "released_on": "2026-08-12"
}

نقاط النهاية

GETالتضخم/v1/economics/{country}/inflation

country: رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
period: لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها.
version_id: نسخة نشر غير قابلة للتغيير واختيارية. استخدم `resource_version` من حدث `dataset.published` أو `dataset.revised`؛ واحذفه لقراءة المؤشر المعتمد حاليًا.

MCP · economics_get_inflation

مرجع API ‏←

GETسجل التضخم/v1/economics/{country}/inflation/observations

country: رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية.
start: أول فترة رصد، وهي مشمولة. في خطتَي Free وBasic، تُنقل البداية التي تسبق نافذة خطتك إلى أول فترة داخلها. وتتضمن الاستجابة عندئذٍ start.
end: آخر فترة رصد، وهي مشمولة في النتائج.
limit: الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor.
cursor: قيمة next_cursor من الصفحة السابقة.

MCP · economics_get_inflation_history

مرجع API ‏←

السجل

cURL

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/inflation/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا

{
  "country": "USA",
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-07",
      "year_over_year": "3.2",
      "month_over_month": "0.2",
      "year_to_date": "1.9"
    }
  ],
  "next_cursor": null
}