مرجع API التقويم الاقتصادي
اعرض الإصدارات المجدولة واسترجع نسخ النشر غير القابلة للتغيير مع الحفاظ على دقة الجدول الأصلية.
طلب
تصفح تقويم الإصدارات الاقتصادية ←
تستخدم العمليتان مفتاح Bearer الخاص بـ Narwhal. Each successful request costs one call on the Calendars API code, $2 per 1,000 calls. نظرة عامة على المنتج ←
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31&limit=25" \
--header "Authorization: Bearer $NARWHAL_API_KEY"GET /v1/economics/calendar/{release_id} يسترجع إصدارًا واحدًا. أضف version_ لاختيار إصدار محدد غير قابل للتغيير.
المعلمات
| معلمة | قاعدة |
|---|---|
countries | رموز ISO alpha-3 اختيارية. كرر معلمة الاستعلام لعدة دول؛ بحد أقصى 50. |
start_ | نافذة تاريخ شاملة اختيارية. الإعداد الافتراضي من 30 يومًا قبل اليوم إلى 335 يومًا بعده؛ وبحد أقصى 366 يومًا. |
limit / | حجم الصفحة 1–100، والافتراضي 100. تابع باستخدام next_ مع المرشحات دون تغيير. |
release_ | تستخدم تفاصيل الإصدار معرّف مسار UUID ومعرّف إصدار UUID اختياريًا. |
release_ غير المعروف يعيد 404 not_. المؤشر المشوّه أو المعدّل أو الذي لا يطابق المرشحات يعيد 400 invalid_. المؤشر الأقدم من 30 دقيقة أو اللقطة غير المتاحة يعيد 409 cursor_. ابدأ من جديد دون المؤشر المنتهي.
استجابة نموذجية
استجابة قائمة توضيحية. تعيد عملية التفاصيل كائن إصدار واحدًا بالحقول نفسها، إضافةً إلى version وobserved_.
{
"releases": [
{
"release_id": "00000000-0000-4000-8000-000000000201",
"revision": 0,
"country": "USA",
"series_id": "usa-consumer-prices",
"name": "Consumer prices",
"topic": "consumer_prices",
"family": "prices",
"period": "2026-09",
"status": "scheduled",
"at": "2026-10-14T12:30:00Z",
"timezone": "America/New_York",
"values": []
}
],
"next_cursor": null
}| حقل | قاعدة |
|---|---|
name | name هو الاسم الإنجليزي الموحّد لدى Narwhal، ويُختار من قائمة مغلقة، مثل Producer prices أو Labour force survey. ولا يتضمن تواريخ. |
series_ | series_ هو معرّف Narwhal الدائم للسلسلة، وتشترك فيه جميع الإصدارات، مثل tur-producer-prices. وهو معرّف نصي مختصر وليس UUID، لذا لا تقبله مسارات /. ويُحذف عندما لا تكون السلسلة قد صُنفت بعد. |
topic | يحدد topic ما تقيسه السلسلة، وهو موحد بين الدول، مثل consumer_ أو labour_ أو gdp أو merchandise_ أو policy_. ولا يرد هذا الحقل إذا لم تُصنَّف السلسلة بعد، وقد تُضاف موضوعات جديدة. |
stage | يحدد stage طبعة أرقام الفترة التي يتضمنها الإصدار: flash أو advance أو first أو second أو third أو preliminary أو final. ولا يظهر في الإصدار ذي الطبعة الواحدة. |
at / | لا يظهر حقل توقيت عندما يكون التاريخ مجهولًا أو عندما لا يملك النطاق التقديري إلا حدًا أدنى. at هو وقت النشر الدقيق، وdate هو يوم النشر دون وقت محدد، وbetween نطاق شامل للأيام المحتملة بالشكل [from, to]، وby هو آخر يوم ممكن: موعد نهائي لا يوم نشر موعود. جميع الطوابع الزمنية بتوقيت UTC؛ وtimezone هي المنطقة الزمنية للناشر وفق IANA. |
period / | period هي الفترة التي يغطيها الإصدار، بمستوى التفصيل الذي توفره الجهة الناشرة: 2026-09 (شهر)، أو 2026-Q3 (ربع سنة)، أو 2018-04/ (نطاق متحرك)، أو 2026-09-12 (يوم أو أسبوع)، أو 2025 (سنة). يُحذف الحقل إذا لم تحدد الجهة الناشرة فترة. أما values فهو موجود دائمًا، ويكون فارغًا حتى تُنشر الأرقام؛ انظر القيم أدناه. |
date_ | date_ is indicative when the date comes from a third-party calendar and not from the publisher. An indicative date can still move. It is absent when the publisher or the central bank set the date. The publisher's date always wins over the third-party calendar. |
meeting | meeting is set on a central bank's policy meeting and holds the meeting's days from the bank's own calendar. kind is scheduled (the date is on the bank's calendar for the year), unscheduled or extraordinary. starts_ is the first day of a multi-day meeting, when the bank gives it, and ends_ is the last day, the day the decision is announced. |
revision / | تزداد revision كلما تغيرت تفاصيل الإصدار. وتكون 0 إذا لم يُعدّل الإصدار مطلقًا. يعيد GET / أيضًا version، وهي النسخة غير القابلة للتغيير التي تُمرر لاحقًا بصفتها version_، وobserved_، وهو آخر وقت رصد فيه Narwhal الإصدار في تقويم الجهة الناشرة. |
لا يظهر الحقل إلا إذا كانت له قيمة. لا تُدرج المقالات البحثية ومجموعات البيانات المكررة التي تضعها بعض الجهات الناشرة إلى جانب إصداراتها.
معنى الجدول والحالة
family هو أحد القيم التالية: gdp، prices، labour، trade، yield_، policy_، activity، survey، housing، money، أو public_. status هو scheduled، published، أو cancelled.
يُعبّر عن التوقيت بأحد الحقول at أو date أو between أو by في المستوى الأعلى. احتفظ بـ timezone والحدود المتاحة؛ فـ by موعد نهائي، لا وعد بالنشر في ذلك اليوم. observed_ هو آخر وقت رصد فيه Narwhal الإصدار في تقويم الجهة الناشرة.
يظل الإلغاء وإعادة الجدولة ممثّلَين بإصدارات صريحة. لا تستبدل وقتًا غير معروف بمنتصف الليل.
يستمد تقويم Narwhal تواريخ وأوقات إصدارات البنك المركزي الأوروبي وبنك كندا من موقعيهما الإلكترونيين، حيث تتاح مجانًا. ويتضمن كل إصدار للبنك المركزي الأوروبي في كل استجابة حقل notice الذي يذكر البنك المركزي الأوروبي مصدرًا ويوضح أن المعلومات متاحة مجانًا على https://www.ecb.europa.eu.
Consensus, indicative dates and central bank meetings
Besides the publishers' own schedules, the calendar carries a third-party calendar. It adds a consensus forecast to figures, dates for releases the publishers do not list, and the days of central bank policy meetings. The publisher's date and figure always win over the third-party calendar.
This request returns the Bank Indonesia policy rate decision with a meeting object and a consensus on each rate, and a bank lending release whose date is indicative. Nothing is published yet, so actual is absent.
curl --request GET \\
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=IDN&start_date=2026-11-18&end_date=2026-11-18" \\
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "7c9f64b5-bc4c-4875-9757-a5a3be9796dd",
"revision": 1,
"country": "IDN",
"series_id": "idn-policy-rate-decision",
"name": "Policy rate decision",
"topic": "policy_rate",
"family": "policy_rate",
"status": "scheduled",
"date": "2026-11-18",
"timezone": "Asia/Jakarta",
"values": [
{
"measure": "deposit_facility_rate",
"period": "2026-11",
"unit": "percent",
"previous": "5",
"consensus": "5"
},
{
"measure": "lending_facility_rate",
"period": "2026-11",
"unit": "percent",
"previous": "6.5",
"consensus": "6.75"
},
{
"measure": "policy_rate",
"period": "2026-11",
"unit": "percent",
"previous": "5.75",
"consensus": "6"
}
],
"meeting": {
"kind": "scheduled",
"ends_on": "2026-11-18"
}
},
{
"release_id": "ff160cc0-f950-4bde-8f98-73dbb6ff6423",
"revision": 1,
"country": "IDN",
"series_id": "idn-bank-lending",
"name": "Bank lending",
"topic": "money_credit",
"family": "money",
"period": "2026-10",
"status": "scheduled",
"date_basis": "indicative",
"at": "2026-11-18T07:30:00Z",
"timezone": "Asia/Jakarta",
"values": [
{
"measure": "bank_credit_yoy",
"unit": "percent",
"transformation": "year_over_year",
"previous": "13.26"
}
]
}
],
"next_cursor": null
}After a decision, a figure from the third-party calendar shows as provisional until the publisher's own release confirms it. This answer is the Bank Negara Malaysia decision of 5 November 2026.
curl --request GET \\
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=MYS&start_date=2026-11-05&end_date=2026-11-05" \\
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "007f2565-07af-43df-b778-0abef890689a",
"revision": 1,
"country": "MYS",
"series_id": "mys-policy-rate-decision",
"name": "Policy rate decision",
"topic": "policy_rate",
"family": "policy_rate",
"status": "published",
"date_basis": "indicative",
"at": "2026-11-05T07:00:00Z",
"timezone": "Asia/Kuala_Lumpur",
"values": [
{
"measure": "policy_rate",
"period": "2026-11",
"unit": "percent",
"actual": "2.75",
"previous": "2.75",
"consensus": "2.75",
"provisional": true
}
]
}
],
"next_cursor": null
}Treat date_ and provisional as signs that a date or a figure can still change.
نطاق تغطية تقويم الإصدارات
The calendar covers 114 countries as of 13 November 2026. Official release schedules from statistical offices and central banks come first. A third-party calendar adds countries and releases that the publishers do not list in a form Narwhal can read. A date that comes only from the third-party calendar carries date_ indicative. Coverage varies by publisher and economic series; inclusion does not mean every indicator has a schedule. Filter the list request by country and date window to see the releases available in that snapshot.
Countries in the calendar · 114
AGO ALB ARE ARG ARM AUS AUT AZE BEL BGD BGR BHR BIH BLR BRA BWA CAN CHE CHL CHN COL CPV CRI CYP CZE DEU DNK DOM ECU EGY EMU ESP EST FIN FRA GBR GEO GHA GRC GTM HKG HRV HUN IDN IND IRL ISL ISR ITA JAM JOR JPN KAZ KEN KGZ KOR LBN LKA LSO LTU LUX LVA MAC MAR MDA MEX MKD MLT MNE MNG MOZ MUS MWI MYS NAM NGA NLD NOR NZL OMN PAK PER PHL PNG POL PRT PRY PSE ROU RUS RWA SAU SGP SLV SRB SUR SVK SVN SWE SWZ SYC THA TUN TUR TWN UGA UKR URY USA UZB VNM ZAF ZMB ZWE
Countries with a release calendar page · 114
- ألبانيا · ALB
- أنغولا · AGO
- الأرجنتين · ARG
- أرمينيا · ARM
- أستراليا · AUS
- النمسا · AUT
- أذربيجان · AZE
- البحرين · BHR
- بنغلاديش · BGD
- بيلاروس · BLR
- بلجيكا · BEL
- البوسنة والهرسك · BIH
- بوتسوانا · BWA
- البرازيل · BRA
- بلغاريا · BGR
- الرأس الأخضر · CPV
- كندا · CAN
- تشيلي · CHL
- الصين · CHN
- كولومبيا · COL
- كوستاريكا · CRI
- كرواتيا · HRV
- قبرص · CYP
- تشيكيا · CZE
- الدنمارك · DNK
- جمهورية الدومينيكان · DOM
- الإكوادور · ECU
- مصر · EGY
- السلفادور · SLV
- إستونيا · EST
- إسواتيني · SWZ
- منطقة اليورو · EMU
- فنلندا · FIN
- فرنسا · FRA
- جورجيا · GEO
- ألمانيا · DEU
- غانا · GHA
- اليونان · GRC
- غواتيمالا · GTM
- هونغ كونغ · HKG
- المجر · HUN
- آيسلندا · ISL
- الهند · IND
- إندونيسيا · IDN
- أيرلندا · IRL
- إسرائيل · ISR
- إيطاليا · ITA
- جامايكا · JAM
- اليابان · JPN
- الأردن · JOR
- كازاخستان · KAZ
- كينيا · KEN
- قيرغيزستان · KGZ
- لاتفيا · LVA
- لبنان · LBN
- ليسوتو · LSO
- ليتوانيا · LTU
- لوكسمبورغ · LUX
- ماكاو · MAC
- ملاوي · MWI
- ماليزيا · MYS
- مالطا · MLT
- موريشيوس · MUS
- المكسيك · MEX
- مولدوفا · MDA
- منغوليا · MNG
- الجبل الأسود · MNE
- المغرب · MAR
- موزمبيق · MOZ
- ناميبيا · NAM
- هولندا · NLD
- نيوزيلندا · NZL
- نيجيريا · NGA
- مقدونيا الشمالية · MKD
- النرويج · NOR
- عُمان · OMN
- باكستان · PAK
- فلسطين · PSE
- بابوا غينيا الجديدة · PNG
- باراغواي · PRY
- بيرو · PER
- الفلبين · PHL
- بولندا · POL
- البرتغال · PRT
- رومانيا · ROU
- روسيا · RUS
- رواندا · RWA
- المملكة العربية السعودية · SAU
- صربيا · SRB
- سيشل · SYC
- سنغافورة · SGP
- سلوفاكيا · SVK
- سلوفينيا · SVN
- جنوب أفريقيا · ZAF
- كوريا الجنوبية · KOR
- إسبانيا · ESP
- سريلانكا · LKA
- سورينام · SUR
- السويد · SWE
- سويسرا · CHE
- تايوان · TWN
- تايلاند · THA
- تونس · TUN
- تركيا · TUR
- أوغندا · UGA
- أوكرانيا · UKR
- الإمارات العربية المتحدة · ARE
- المملكة المتحدة · GBR
- الولايات المتحدة · USA
- أوروغواي · URY
- أوزبكستان · UZB
- فيتنام · VNM
- زامبيا · ZMB
- زيمبابوي · ZWE
An empty result means no releases are listed for that query in the snapshot. It does not guarantee that the publisher has no upcoming releases. Central bank meeting dates are served in this calendar as meeting. Public holidays, including bank holidays, and exchange closures are separate calendar datasets: see the public holidays reference و exchange closures reference (الإنجليزية).
القيم
Each release in the economic release calendar API includes a values array, empty until figures are published. Each value is a figure printed by the publisher: actual for the release's own period and previous for the period before. An actual that comes from a third-party calendar is marked provisional. Narwhal never computes these figures.
{
"values": [
{
"measure": "producer_price_change_mom",
"unit": "percent",
"transformation": "month_over_month",
"actual": "0",
"previous": "0.1",
"previous_revised_from": "0.2"
}
]
}| حقل | قاعدة |
|---|---|
measure | measure يحدد الرقم داخل الإصدار، مثل producer_. |
concept | يوضح concept ما الذي يقيسه الرقم، مثل gdp أو cpi، ولذلك يحمل الرقم نفسه المفهوم نفسه في كل بلد. اقرأه مع transformation وannualization لإجراء مقارنة بين أرقام متماثلة. |
notice | يحتوي notice على شروط المصدر التي تفرض الجهة الناشرة عرضها عند كل وصول، مثل شروط البنك المركزي الأوروبي. اعرضها مع الإصدار. يُحذف الحقل إذا لم توجد شروط من هذا النوع. |
period | لا يظهر period إلا عندما تغطي القيمة فترة تختلف عن period الخاص بالإصدار، كما في طلبات إعانة البطالة المستمرة التي تغطي الأسبوع السابق لأسبوع الإصدار نفسه. |
unit | unit هي percent (القيمة 1.2 تعني 1.2%)، أو index (مع index_، مثل 2015=100)، أو thousands، أو currency، أو ratio (مثل نسبة الوظائف إلى المتقدمين)، أو balance (صافي رصيد المسح بالنقاط، لا بالنسبة المئوية). |
currency / | لا يظهر الحقلان currency (رمز ISO 4217) وscale (units أو thousands أو millions أو hundred_ أو billions) إلا عندما تكون قيمة unit هي currency. يستخدم الرقم مقياس الأعداد الذي تطبعه الجهة الناشرة. |
transformation | transformation هي month_، أو year_، أو quarter_، أو three_، أو change (فرق في المستويات بوحدة الآلاف، مثل التغير في التوظيف). يُحذف الحقل عندما تكون القيمة مستوىً. |
annualized / | annualized is true when the figure is at an annual rate, as with U.S. GDP growth. not_ is true when the figure is not seasonally adjusted. If annualized is absent, the figure is not annualized. If not_ is absent, the figure is seasonally adjusted, or, on a figure from a third-party calendar, the source does not say. |
actual / | actual هو رقم فترة الإصدار نفسه؛ وprevious هو رقم الفترة السابقة. تنشر الجهة الناشرة كليهما، ولا يحسبهما Narwhal مطلقًا. يُحذف أي رقم لم يرد في الإصدار؛ ثم يحمل الإصدار التالي قيمة actual السابقة بصفتها previous. |
consensus | consensus is the expected figure for the period, from a third-party calendar. It is a forecast and not a published figure. It is absent when no forecast is known, and it can appear on a value whose actual the publisher printed. |
provisional | provisional is true when actual has not been confirmed by the publisher's own release. The figure comes from a third-party calendar and can change when the publisher publishes. It is absent otherwise. |
previous_ | previous_ هو الرقم السابق كما نُشر أول مرة، عندما يعدّل هذا الإصدار قيمة previous. |
value_ | لا يظهر value_ إلا عند غياب actual: تشير pending_ إلى الفترة بعد الوقت المجدول وحتى التقاط الرقم، وتشير unavailable إلى أن الإصدار نُشر أو أُلغي دون ذلك الرقم. |
قد تُضاف قيم جديدة لهذه الحقول بمرور الوقت، لذا ينبغي للتطبيقات العميلة قبول القيم التي لا تتعرف عليها.
هل كانت هذه الصفحة مفيدة؟