البيانات التاريخية لـMoney supply API
استرجع سجل النقود بمعناها الواسع الشهري لبلد واحد، بعملته الخاصة، من الأقدم إلى الأحدث.
economics_ متاح عبر REST وعبر الأداة economics_ أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.
نقطة النهاية والطلب
GET /v1/economics/{country}/money-supply/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/KWT/money-supply/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` لسلسلة واحدة، مأخوذ من إجابة سابقة. احذفه لقراءة السلسلة الافتراضية للبلد. |
الاستجابة
{
"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",
"country": "KWT",
"series_id": "94322188-0436-47b7-b127-01f3f73cfab9",
"unit": "currency",
"currency": "KWD",
"observations": [
{
"period": "2026-01",
"value": "42179995400"
},
{
"period": "2026-02",
"value": "42605920000"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}يطلب مثال السجل limit=2، فيحمل صفين. اختُصر next_ هنا. أما الحقيقي فهو نص معتم أطول.
| حقل | النوع | مطلوب | المعنى |
|---|---|---|---|
source | كائن | نعم | من نشر الرقم. publisher هو الناشر الأصلي الذي تسميه البيانات الوصفية لسلسلة IMF، وdistributor هو IMF، الذي تقرأ Narwhal منه. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_. |
seasonal_ | سلسلة نصية | نعم | Always not_. |
aggregate | سلسلة نصية | نعم | Always broad_. |
definition_ | سلسلة نصية | نعم | اسم المجمّع في مجموعة بيانات IMF: Broad Money. |
country | سلسلة نصية | نعم | رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3. |
series_ | سلسلة نصية | نعم | السلسلة التي يأتي منها الرقم. مررها بوصفها series_ لقراءة السلسلة نفسها مرة أخرى. |
unit | سلسلة نصية | نعم | Always currency. |
currency | سلسلة ISO 4217 | نعم | العملة الوطنية للبلد، مثل KWD. |
observations | مصفوفة | نعم | قراءات من الأقدم إلى الأحدث، واحدة لكل فترة. قد تحمل الصفحة قراءات أقل من limit. تابع next_ حتى يصبح null. |
observations[].period | سلسلة نصية | نعم | الشهر أو الربع أو السنة الرسمية التي تمثلها القراءة. |
observations[].value | سلسلة نصية لعدد عشري | نعم | النقود بمعناها الواسع في نهاية الشهر، بوحدات كاملة من العملة الوطنية في currency. |
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 القراءات المفقودة بدلًا من ملئها.
اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.
تغطية الإصدار التجريبي العام الحالي
4 الدول
DOM, KAZ, KWT, MUS
شهري، بوحدات كاملة من عملة البلد نفسه، غير معدّل موسميًا. تعرّف البلدان النقود بمعناها الواسع تعريفات مختلفة، لذا قارن المستويات داخل بلد واحد فقط. يوزّع صندوق النقد الدولي (IMF) السلسلة، ويحدد source.publisher الناشر الأصلي. الفترة شهر بصيغة YYYY-MM. أي بلد آخر يُرجع 404 not_ ولا يُحاسَب عليه.
يتوفر FX اليومي عبر واجهة API لأسعار الصرف.
العودة إلى جميع عمليات Economics.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.
هل كانت هذه الصفحة مفيدة؟