الحساب الجاري API
استرجع رصيد الحساب الجاري ربع السنوي بالدولار الأمريكي لبلد واحد، من IMF.
economics_ متاح عبر REST وعبر الأداة economics_ أداة MCP. كلتاهما تُرجع بنية البيانات نفسها وتستخدم الرصيد نفسه.
نقطة النهاية والطلب
GET /v1/economics/{country}/current-accountcurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/IDN/current-account" \
--header "Authorization: Bearer $NARWHAL_API_KEY"يستخدم MCP أداة economics_ مع الوسيطات المقابلة أدناه.
المعلمات
تنسيق الفترة المقبول لهذه العملية هو YYYY-QN.
| الاسم | مطلوب | النوع | المعنى |
|---|---|---|---|
country | نعم | المسار · ISO alpha-3 | رمز دولة واحد مدعوم بأحرف لاتينية كبيرة؛ راجع قائمة التغطية لهذه العملية. |
period | لا | الاستعلام · YYYY-QN | لا تُرسله للحصول على أحدث إصدار مكتمل مقبول، أو حدّد فترة واحدة بعينها. |
series_ | لا | الاستعلام · UUID | اختياري. `series_id` لسلسلة واحدة، مأخوذ من إجابة سابقة. احذفه لقراءة السلسلة الافتراضية للبلد. |
الاستجابة
{
"source": {
"publisher": "Country authorities; National Summary Data Pages; European Central Bank; IMF Staff Estimates",
"distributor": "International Monetary Fund"
},
"accounting_standard": "BPM6",
"time_basis": "period_flow",
"period": "2026-Q2",
"value": "-12487416024.3855",
"country": "IDN",
"series_id": "b025aa04-14db-4649-87b8-359c20069196",
"unit": "currency",
"currency": "USD"
}| حقل | النوع | مطلوب | المعنى |
|---|---|---|---|
source | كائن | نعم | من نشر الرقم. publisher هو الناشر الأصلي الذي تسميه البيانات الوصفية لسلسلة IMF، وdistributor هو IMF، الذي تقرأ Narwhal منه. مصدر واحد لكل سلسلة، طوال سجلها. لا يوجد released_. |
accounting_ | سلسلة نصية | نعم | دليل ميزان المدفوعات الذي يتبعه الرقم، مثل BPM6. |
time_ | سلسلة نصية | نعم | دائمًا period_: صافي التدفق خلال الربع، لا رصيدًا. |
period | سلسلة نصية | نعم | فترة الرصد الرسمية المعادة. |
value | سلسلة نصية لعدد عشري | نعم | صافي رصيد الحساب الجاري للربع، بالدولار الأمريكي. القيمة السالبة عجز. |
status | سلسلة نصية | لا | يظهر فقط للرقم الذي يضع الناشر عليه علامة: estimated أو break_ أو definition_ أو break_. يُحذف في غير ذلك. |
release_ | سلسلة نصية | لا | preliminary عندما يصنّف الناشر الرقم على أنه مؤقت. يُحذف في غير ذلك. |
country | سلسلة نصية | نعم | رمز الدولة المطلوب بالأحرف الكبيرة وفق ISO alpha-3. |
series_ | سلسلة نصية | نعم | السلسلة التي يأتي منها الرقم. مررها بوصفها series_ لقراءة السلسلة نفسها مرة أخرى. |
unit | سلسلة نصية | نعم | Always currency. |
currency | سلسلة ISO 4217 | نعم | Always USD. |
أخطاء 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 quarter inYYYY-QNformat.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_، لأن التاريخ الذي يعرضه الموزّع ليس تاريخ إصدار الناشر.
اقرأ كيف تعمل فحوص المصدر والتحقق والإصدارات المخزنة والفحوص الفاشلة.
تغطية الإصدار التجريبي العام الحالي
9 الدول
ARG, CHN, IDN, KOR, MEX, SLV, THA, UKR, URY
ربع سنوي، بالدولار الأمريكي. الرصيد هو صافي السلع والخدمات والدخل والتحويلات، والقيمة السالبة عجز. يوزّع صندوق النقد الدولي (IMF) السلسلة، ويحدد source.publisher الناشر الأصلي. الفترة ربع بصيغة YYYY-QN. أي بلد آخر يُرجع 404 not_ ولا يُحاسَب عليه.
يتوفر FX اليومي عبر واجهة API لأسعار الصرف.
العودة إلى جميع عمليات Economics.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.
هل كانت هذه الصفحة مفيدة؟