واجهة API لنمو GDP

استرجع المقاييس الرسمية لنمو الناتج المحلي الإجمالي الحقيقي لربع سنة واحد.

economics_get_gdp_growth متاح عبر REST و economics_get_gdp_growth أداة MCP. يعيد كلاهما شكل البيانات نفسه ويستهلك الحصة الشهرية نفسها.

نقطة النهاية والطلب

نقطة نهاية REST

GET /v1/economics/{country}/gdp-growth

طلب نموذجي

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

يستخدم MCP أداة economics_get_gdp_growth مع المعلمات المقابلة أدناه.

المعلمات

تنسيق الفترة المقبول لهذه العملية هو YYYY-QN.

الاسم	مطلوب	النوع	المعنى
`country`	نعم	المسار · ISO alpha-3	رمز دولة واحد مدعوم بأحرف كبيرة: AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA.
`period`	لا	الاستعلام · YYYY-QN	اتركه لأحدث إصدار مكتمل مقبول، أو مرر فترة واحدة دقيقة.

الاستجابة

استجابة نموذجية

{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "unit": "percent",
  "price_basis": "constant",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "not_annualized",
  "released_on": "2026-07-30"
}

حقل	النوع	مطلوب	المعنى
`country`	سلسلة نصية	نعم	رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3.
`period`	سلسلة نصية	نعم	فترة الملاحظة الرسمية المعادة.
`year_over_year`	سلسلة عشرية	نعم	تغير الناتج المحلي الإجمالي الحقيقي مقارنة بالربع نفسه من العام السابق.
`quarter_over_quarter`	سلسلة عشرية	نعم	تغير الناتج المحلي الإجمالي الحقيقي مقارنة بالربع السابق.
`year_to_date`	سلسلة عشرية	لا	النمو الرسمي منذ بداية السنة عندما ينشره المصدر؛ وإلا يُحذف.
`unit`	"percent"	نعم	وحدة مقاييس النمو.
`price_basis`	"constant"	نعم	يؤكد أن النمو محسوب من الناتج المحلي الإجمالي الحقيقي.
`seasonal_adjustment`	تعداد	نعم	ما إذا كانت السلسلة الرسمية معدّلة موسمياً.
`annualization`	تعداد	نعم	ما إذا كان معدل النمو المنشور محوّلاً إلى أساس سنوي.
`released_on`	التاريخ	نعم	تاريخ النشر الرسمي، وليس وقت استرجاع Narwhal.

الأخطاء والحصة

400 invalid_query — تنسيق الدولة أو الفترة أو المرشح غير صالح.
401 invalid_api_key — مفتاح Bearer مفقود أو مرفوض.
404 series_not_found — لا توجد ملاحظة معتمدة تطابق الطلب.
429 rate_limit_exceeded — تم بلوغ حد الشبكة أو الحساب قصير النافذة؛ أعد المحاولة بعد Retry-After.
429 quota_exhausted — بلغ الحساب مخصصه الشهري.
503 economics_unavailable — لا يستطيع Narwhal تقديم إصدار مقبول بأمان.

تستهلك استجابة البيانات الناجحة فقط الحصة. راجع الـ كل الأخطاء والترويسات وقواعد إعادة المحاولة.

الحداثة

حذف period يعيد أحدث إصدار مقبول مخزن لدى Narwhal. يقرأ استدعاء API قاعدة بيانات Narwhal؛ ولا يتصل بالناشر الرسمي مباشرة.

released_on هو تاريخ النشر الرسمي.

اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.

تغطية الإصدار التجريبي العام الحالي

النمو الفصلي على أساس سنوي وربع سنوي متاح للعامة للدول AUS وCAN وDEU وFRA وGBR وJPN وMYS وNLD وSGP وUSA. ولا يظهر الحقل الاختياري year_to_date إلا عندما ينشره المصدر الرسمي.

المسارات الإقليمية الإندونيسية وCommodities ليست عامة. وتتوفر FX عبر FX API.

العودة إلى إلى كل Economics العمليات.