البيانات التاريخية لـالتضخم الموحد API
استرجع سجل التضخم الموحد (HICP) الشهري لبلد واحد، من الأقدم إلى الأحدث.
economics_ متاح عبر REST وعبر الأداة economics_ أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.
نقطة النهاية والطلب
GET /v1/economics/{country}/harmonised-inflation/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation/observations?start=2026-01&limit=2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"يستخدم MCP أداة economics_ مع الوسيطات المقابلة أدناه.
المعلمات
تنسيق الفترة المقبول لهذه العملية هو YYYY-MM.
| الاسم | مطلوب | النوع | المعنى |
|---|---|---|---|
country | نعم | المسار · ISO alpha-3 | رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية. |
start | لا | الاستعلام · YYYY-MM | أول فترة رصد، وهي مشمولة في النتائج. |
end | لا | الاستعلام · YYYY-MM | آخر فترة رصد، وهي مشمولة في النتائج. |
limit | لا | الاستعلام · عدد صحيح, 1–1000 | الحد الأقصى لعدد الفترات المُعادة. القيمة الافتراضية 100. قد تحتوي الصفحة على فترات أقل؛ اتبع next_cursor. |
cursor | لا | الاستعلام · سلسلة نصية غير قابلة للتفسير | قيمة next_cursor من الصفحة السابقة. |
series_ | لا | الاستعلام · UUID | اختياري. احذفه للحصول على المعدل السنوي، وهو السلسلة الافتراضية. مرر `series_id` لمستوى المؤشر لقراءة المؤشر بدلًا منه. ابحث عنه عبر `GET /v1/economics/{country}/series?family=harmonised-inflation`: إنه السلسلة التي تكون قيمة `unit` فيها `index`. |
الاستجابة
{
"source": {
"publisher": "Eurostat",
"distributor": "Eurostat"
},
"measure": "year_over_year",
"seasonal_adjustment": "not_seasonally_adjusted",
"classification": "COICOP 2018, all items (HICP total)",
"country": "FRA",
"series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
"unit": "percent",
"observations": [
{
"period": "2026-01",
"value": "0.4"
},
{
"period": "2026-02",
"value": "1.1"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}يطلب مثال السجل limit=2، فيحمل صفين. اختُصر next_ هنا. أما الحقيقي فهو نص معتم أطول.
| حقل | النوع | مطلوب | المعنى |
|---|---|---|---|
source | كائن | نعم | من نشر الرقم. publisher هو الهيئة الإحصائية صاحبة الرقم، وdistributor هو الهيئة التي تقرأ Narwhal منها. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_. |
measure | سلسلة نصية | نعم | year_ هو معدل التغير السنوي بالنسبة المئوية. وlevel هو مستوى المؤشر. |
seasonal_ | سلسلة نصية | نعم | Always not_. |
classification | سلسلة نصية | نعم | مجمّع الأسعار الذي يغطيه الرقم: جميع البنود، COICOP 2018. |
base_ | سلسلة نصية | لا | السنة التي يساوي فيها المؤشر 100. Present for the index level only. |
base_ | سلسلة نصية لعدد عشري | لا | قيمة المؤشر في سنة الأساس. تظهر لمستوى المؤشر فقط. |
country | سلسلة نصية | نعم | رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3. |
series_ | سلسلة نصية | نعم | السلسلة التي يأتي منها الرقم. مررها بوصفها series_ لقراءة السلسلة نفسها مرة أخرى. |
unit | سلسلة نصية | نعم | percent للمعدل السنوي، وindex لمستوى المؤشر. |
observations | مصفوفة | نعم | قراءات من الأقدم إلى الأحدث، واحدة لكل فترة. قد تحمل الصفحة قراءات أقل من limit. تابع next_ حتى يصبح null. |
observations[].period | سلسلة نصية | نعم | الشهر أو الربع أو السنة الرسمية التي تمثلها القراءة. |
observations[].value | سلسلة نصية لعدد عشري | نعم | الرقم في unit: المعدل السنوي بالنسبة المئوية، وقد يكون سالبًا، أو مستوى المؤشر. |
observations[].status | سلسلة نصية | لا | يظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_ أو definition_ أو break_. يُحذف في غير ذلك. |
observations[].release_ | سلسلة نصية | لا | preliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك. |
next_ | سلسلة نصية أو null | نعم | مرر هذا كما هو بوصفه cursor لقراءة الصفحة التالية. وهو null في الصفحة الأخيرة. |
أخطاء API والرصيد
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID,id startorendis not a month inYYYY-MMformat,startandenddiffer in format orstartis afterend, orlimitis outside 1 to 1000.version_,id versionandas_are not accepted on this route.of 400 invalid_: المؤشر مشوّه، أو أُصدر لمرشحات أخرى.cursor 409 snapshot_: المؤشرunavailable cursorمضى عليه أكثر من 24 ساعة وانتهت صلاحيته. ابدأ من جديد بدونcursor.401 invalid_: مفتاح Bearer مفقود أو مرفوض.api_ key 402 insufficient_: رصيدك لا يغطي الاستدعاء.credits 404 series_: البلد ليس في قائمة التغطية في هذه الصفحة، أوnot_ found series_ليس سلسلة لذلك البلد، أو لا تحتوي الفترة على أي قراءة. والبلد خارج القائمة يحصل على تفصيل يقول إن العائلة غير متاحة له. ولا يُحاسَب على 404.id 429 rate_: بلغ حد النافذة القصيرة للشبكة أو الحساب. أعد المحاولة بعدlimit_ exceeded Retry-After.503 economics_: لا تستطيع Narwhal تقديم السلسلة المخزنة بأمان.unavailable
Only a successful data response costs credit. راجع كل الأخطاء والترويسات وقواعد إعادة المحاولة.
حداثة البيانات
يعيد هذا المسار سلسلة Narwhal المخزنة الحالية، من الأقدم إلى الأحدث. وبدون start يبدأ من أقدم فترة مخزنة، لذا مرر start لقراءة الفترات الحديثة. ولا يقبل as_ ولا version، فلا يمكن قراءة نسخة أقدم. وتحذف Narwhal القراءات المفقودة بدلًا من ملئها.
اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.
تغطية الإصدار التجريبي العام الحالي
10 الدول
DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE
المؤشر الموحد الشهري لأسعار المستهلك (HICP)، لجميع البنود، من Eurostat، غير معدّل موسميًا. وهو ليس مسار inflation الوطني، ويختلف الرقمان لبلد واحد. السلسلة الافتراضية هي معدل التغير السنوي بالنسبة المئوية، وقد يكون سالبًا. ولمستوى المؤشر أساس 2025=100. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 series_ ولا يُحاسَب عليه. لقراءة مستوى المؤشر، اعرض سلاسل البلد أولًا: يُرجع GET / كل سلسلة مع series_ وname وunit (percent أو index) وis_، ويتيح طلب يتضمن limit وcursor التنقل بين الصفحات. مرّر series_ الذي تكون قيمة unit فيه index إلى مسار الأحدث أو التاريخ.
List the سلسلة
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"series": [
{
"country": "FRA",
"series_id": "11bc022a-cd6e-4847-8ff8-11dae4e93451",
"unit": "index",
"name": "Harmonised index of consumer prices",
"frequency": "monthly",
"first_period": "2000-01",
"last_period": "2026-10",
"family": "harmonised-inflation",
"definition": {
"base_period": "2025",
"base_value": "100",
"seasonal_adjustment": "not_seasonally_adjusted",
"measure": "level",
"classification": "COICOP 2018, all items (HICP total)"
}
},
{
"country": "FRA",
"series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
"unit": "percent",
"name": "Harmonised inflation, annual rate",
"is_default": true,
"frequency": "monthly",
"first_period": "2000-01",
"last_period": "2026-10",
"family": "harmonised-inflation",
"definition": {
"measure": "year_over_year",
"seasonal_adjustment": "not_seasonally_adjusted",
"annualization": "not_annualized",
"classification": "COICOP 2018, all items (HICP total)"
}
}
],
"next_cursor": null
}يتوفر FX اليومي عبر واجهة API لأسعار الصرف.
العودة إلى جميع عمليات Economics.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.
هل كانت هذه الصفحة مفيدة؟