Money supply API
استرجع أحدث نقود بمعناها الواسع شهرية لبلد واحد، بعملته الخاصة، من IMF.
economics_ متاح عبر REST وعبر الأداة economics_ أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.
نقطة النهاية والطلب
GET /v1/economics/{country}/money-supplycurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/KWT/money-supply" \
--header "Authorization: Bearer $NARWHAL_API_KEY"يستخدم MCP أداة economics_ مع الوسيطات المقابلة أدناه.
المعلمات
تنسيق الفترة المقبول لهذه العملية هو YYYY-MM.
| الاسم | مطلوب | النوع | المعنى |
|---|---|---|---|
country | نعم | المسار · ISO alpha-3 | رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية. |
period | لا | الاستعلام · YYYY-MM | لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها. |
series_ | لا | الاستعلام · UUID | اختياري. `series_id` لسلسلة واحدة، مأخوذ من إجابة سابقة. احذفه لقراءة السلسلة الافتراضية للبلد. |
الاستجابة
{
"source": {
"publisher": "Country authorities; National Summary Data Pages; European Central Bank; IMF Staff Calculations",
"distributor": "International Monetary Fund"
},
"seasonal_adjustment": "not_seasonally_adjusted",
"aggregate": "broad_money",
"definition_label": "Broad Money",
"period": "2026-08",
"value": "42767544300",
"country": "KWT",
"series_id": "94322188-0436-47b7-b127-01f3f73cfab9",
"unit": "currency",
"currency": "KWD"
}| حقل | النوع | مطلوب | المعنى |
|---|---|---|---|
source | كائن | نعم | من نشر الرقم. publisher هو الناشر الأصلي الذي تسميه البيانات الوصفية لسلسلة IMF، وdistributor هو IMF، الذي تقرأ Narwhal منه. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_. |
seasonal_ | سلسلة نصية | نعم | Always not_. |
aggregate | سلسلة نصية | نعم | Always broad_. |
definition_ | سلسلة نصية | نعم | اسم المجمّع في مجموعة بيانات IMF: Broad Money. |
period | سلسلة نصية | نعم | فترة الرصد الرسمية المعادة. |
value | سلسلة نصية لعدد عشري | نعم | النقود بمعناها الواسع في نهاية الشهر، بوحدات كاملة من العملة الوطنية في currency. |
status | سلسلة نصية | لا | يظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_ أو definition_ أو break_. يُحذف في غير ذلك. |
release_ | سلسلة نصية | لا | preliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك. |
country | سلسلة نصية | نعم | رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3. |
series_ | سلسلة نصية | نعم | السلسلة التي يأتي منها الرقم. مررها بوصفها series_ لقراءة السلسلة نفسها مرة أخرى. |
unit | سلسلة نصية | نعم | Always currency. |
currency | سلسلة ISO 4217 | نعم | العملة الوطنية للبلد، مثل KWD. |
أخطاء API والرصيد
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID, orid periodis not a month inYYYY-MMformat.version_,id versionandas_are not accepted on this route.of 401 invalid_: مفتاح Bearer مفقود أو مرفوض.api_ key 402 insufficient_: رصيدك لا يغطي الاستدعاء.credits 404 series_: البلد ليس في قائمة التغطية في هذه الصفحة، أوnot_ found series_ليس سلسلة لذلك البلد، أو لا توجد قراءة تطابقid period. والبلد خارج القائمة يحصل على تفصيل يقول إن العائلة غير متاحة له. ولا يُحاسَب على 404.429 rate_: بلغ حد النافذة القصيرة للشبكة أو الحساب. أعد المحاولة بعدlimit_ exceeded Retry-After.503 economics_: لا تستطيع Narwhal تقديم السلسلة المخزنة بأمان.unavailable
Only a successful data response costs credit. راجع كل الأخطاء والترويسات وقواعد إعادة المحاولة.
حداثة البيانات
عند حذف period تُعاد أحدث قراءة مخزنة. يقرأ استدعاء API قاعدة بيانات Narwhal. ولا يستدعي الناشر مباشرةً. ولا تحتوي الإجابة على released_، لأن التاريخ الذي يعرضه الموزّع ليس تاريخ إصدار الناشر.
اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.
تغطية الإصدار التجريبي العام الحالي
4 الدول
DOM, KAZ, KWT, MUS
شهري، بوحدات كاملة من عملة البلد نفسه، غير معدّل موسميًا. تعرّف البلدان النقود بمعناها الواسع تعريفات مختلفة، لذا قارن المستويات داخل بلد واحد فقط. يوزّع صندوق النقد الدولي (IMF) السلسلة، ويحدد source.publisher الناشر الأصلي. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 not_ ولا يُحاسَب عليه.
يتوفر FX اليومي عبر واجهة API لأسعار الصرف.
العودة إلى جميع عمليات Economics.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.
هل كانت هذه الصفحة مفيدة؟