---
title: "API التقويم الاقتصادي | Narwhal API"
description: "تابع إصدارات الناتج المحلي والأسعار والعمل والتجارة ومنحنى العائد المجدولة وحالة نشرها، مع إبقاء المواعيد غير المؤكدة تقديرية دون عرضها كأوقات دقيقة."
url: "https://narwhalapi.com/ar/api/economic-calendar"
---

جميع واجهات API

# واجهة API للتقويم الاقتصادي

تابع الإصدارات الاقتصادية المجدولة وحالة نشرها. أنشئ تقويم إصدارات للناتج المحلي الإجمالي والأسعار وسوق العمل والتجارة ومنحنيات العائد دون اعتبار المواعيد غير المؤكدة أوقاتًا دقيقة.

[احصل على مفتاح API مجاني](https://narwhalapi.com/ar/signup)
[اقرأ التوثيق ‏←](https://narwhalapi.com/ar/docs/api/economic-calendar.md)

## الطلب الأول

### عرض الإصدارات في شهر

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

استجابة نموذجية

```
{
  "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
}
```

### ابحث عن قرار سعر الفائدة لبنك مركزي

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

استجابة نموذجية

```
{
  "releases": [
    {
      "release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-monetary-policy-press-conference",
      "name": "Monetary policy press conference",
      "topic": "policy_communication",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:30:00Z",
      "timezone": "America/New_York",
      "values": []
    },
    {
      "release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:00:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}
```

### اشتراكات التقويم

```
curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'
```

استجابة نموذجية

```
{
  "subscription_id": "00000000-0000-4000-8000-000000000301",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2027-10-22T09:00:00Z"
}
```

## نقاط النهاية

GET عرض الإصدارات`/v1/economics/calendar`

اعرض الإصدارات ضمن نطاق زمني.

#### المعلمات

- `countries` اختياري رموز ISO alpha-3، مثل USA. كرّر المعامل لعدة دول، بحد أقصى 50.
- `start_date` اختياري أول يوم في النافذة. تبدأ النافذة افتراضيًا قبل 30 يومًا من اليوم.
- `end_date` اختياري آخر يوم في النافذة. تنتهي افتراضيًا بعد 335 يومًا من اليوم. تمتد النافذة 366 يومًا على الأكثر.
- `limit` اختياري عدد الإصدارات في الصفحة، من 1 إلى 100. القيمة الافتراضية 100.
- `cursor` اختياري تابع باستخدام next_cursor والمرشحات نفسها.

#### كل إصدار في القائمة

- `release_id` سلسلة نصية الإصدار المراد قراءة تفاصيله.
- `name` سلسلة نصية الاسم الإنجليزي القياسي في Narwhal، مثل Producer prices. لا يتضمن تواريخ.
- `topic` سلسلة نصية ما تقيسه السلسلة، وهو نفسه في كل دولة، مثل consumer_prices أو gdp.
- `period` سلسلة نصية الفترة التي يغطيها الإصدار، مثل 2026-09 أو 2026-Q3.
- `status` سلسلة نصية حالة الإصدار، مثل scheduled.
- `at / date / between / by` سلسلة نصية التوقيت الذي ذكرته الجهة الناشرة: وقت محدد أو يوم أو نطاق أيام أو موعد نهائي. تظهر القيمة None عندما يكون التاريخ مجهولًا.
- `values` مصفوفة الأرقام المنشورة. تبقى المصفوفة فارغة حتى صدورها.

---

[المرجع الكامل ‏←](https://narwhalapi.com/ar/docs/api/economic-calendar.md)

GET جلب إصدار واحد`/v1/economics/calendar/{release_id}`

اقرأ إصدارًا، مع إمكانية تحديد version_id.

#### المعلمات

- `release_id` مطلوب معرّف UUID الخاص بالإصدار.
- `version_id` اختياري معرّف UUID لنسخة سابقة. بدونه تحصل على النسخة الحالية.

#### الإصدار

- `version` سلسلة نصية النسخة غير القابلة للتغيير، ويمكنك تمريرها لاحقًا باسم version_id.
- `name` سلسلة نصية الاسم الإنجليزي القياسي في Narwhal، مثل Producer prices. لا يتضمن تواريخ.
- `topic` سلسلة نصية ما تقيسه السلسلة، وهو نفسه في كل دولة، مثل consumer_prices أو gdp.
- `period` سلسلة نصية الفترة التي يغطيها الإصدار، مثل 2026-09 أو 2026-Q3.
- `status` سلسلة نصية حالة الإصدار، مثل scheduled.
- `at / date / between / by` سلسلة نصية التوقيت الذي ذكرته الجهة الناشرة: وقت محدد أو يوم أو نطاق أيام أو موعد نهائي. تظهر القيمة None عندما يكون التاريخ مجهولًا.
- `values` مصفوفة الأرقام المنشورة. تبقى المصفوفة فارغة حتى صدورها.

---

[المرجع الكامل ‏←](https://narwhalapi.com/ar/docs/api/economic-calendar.md)

## حالات الاستخدام

### موعد صدور CPI القادم

اعرف متى يصدر CPI الأمريكي القادم، بتوقيت UTC وبتوقيت نيويورك.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/find-the-next-cpi-release-date.md)

### تقويم اقتصادي

أنشئ تقويمًا للإصدارات الخاصة بالدول والتواريخ التي تختارها.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/build-an-economic-calendar.md)

### تنبيهات قبل الإصدار

احصل على تذكير قبل الإصدار من خلاصة تقويم أو من سكربت يومي.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/get-an-alert-before-an-economic-release.md)

### أوقات الإصدار بتوقيتك

حوّل أوقات الإصدار من UTC إلى الوقت المحلي مع مراعاة التوقيت الصيفي.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/convert-a-release-time-to-your-time-zone.md)

### اجتماعات FOMC ومحاضرها

اعرض قرارات الفائدة المجدولة لـ FOMC ومحاضر الاجتماعات.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/find-fomc-meeting-dates-and-minutes.md)

### اجتماعات البنوك المركزية

اعرض تواريخ قرارات البنوك المركزية بترتيب زمني.

[اقرأ الدليل ‏←](https://narwhalapi.com/ar/how-to/list-all-central-bank-meetings.md)

## التغطية

114 دولة. لـ 43 منها جداول إصدار تُقرأ من ناشريها مباشرة؛ وللـ 71 الأخرى تواريخ من تقويم طرف ثالث، موسومة بأنها استرشادية.

- ألبانيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/albania.md)
- أنغولا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/angola.md)
- الأرجنتين[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/argentina.md)
- أرمينيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/armenia.md)
- أستراليا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/australia.md)
- النمسا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/austria.md)
- أذربيجان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/azerbaijan.md)
- البحرين[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/bahrain.md)
- بنغلاديش[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/bangladesh.md)
- بيلاروس[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/belarus.md)
- بلجيكا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/belgium.md)
- البوسنة والهرسك[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/bosnia-and-herzegovina.md)

عرض كل الدول (114)

- بوتسوانا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/botswana.md)
- البرازيل[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/brazil.md)
- بلغاريا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/bulgaria.md)
- الرأس الأخضر[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/cabo-verde.md)
- كندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/canada.md)
- تشيلي[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/chile.md)
- الصين[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/china.md)
- كولومبيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/colombia.md)
- كوستاريكا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/costa-rica.md)
- كرواتيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/croatia.md)
- قبرص[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/cyprus.md)
- تشيكيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/czechia.md)
- الدنمارك[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/denmark.md)
- جمهورية الدومينيكان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/dominican-republic.md)
- الإكوادور[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/ecuador.md)
- مصر[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/egypt.md)
- السلفادور[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/el-salvador.md)
- إستونيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/estonia.md)
- إسواتيني[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/eswatini.md)
- منطقة اليورو[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/euro-area.md)
- فنلندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/finland.md)
- فرنسا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/france.md)
- جورجيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/georgia.md)
- ألمانيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/germany.md)
- غانا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/ghana.md)
- اليونان[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/greece.md)
- غواتيمالا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/guatemala.md)
- هونغ كونغ[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/hong-kong.md)
- المجر[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/hungary.md)
- آيسلندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/iceland.md)
- الهند[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/india.md)
- إندونيسيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/indonesia.md)
- أيرلندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/ireland.md)
- إسرائيل[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/israel.md)
- إيطاليا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/italy.md)
- جامايكا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/jamaica.md)
- اليابان[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/japan.md)
- الأردن[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/jordan.md)
- كازاخستان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/kazakhstan.md)
- كينيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/kenya.md)
- قيرغيزستان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/kyrgyzstan.md)
- لاتفيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/latvia.md)
- لبنان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/lebanon.md)
- ليسوتو[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/lesotho.md)
- ليتوانيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/lithuania.md)
- لوكسمبورغ[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/luxembourg.md)
- ماكاو[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/macao.md)
- ملاوي[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/malawi.md)
- ماليزيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/malaysia.md)
- مالطا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/malta.md)
- موريشيوس[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/mauritius.md)
- المكسيك[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/mexico.md)
- مولدوفا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/moldova.md)
- منغوليا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/mongolia.md)
- الجبل الأسود[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/montenegro.md)
- المغرب[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/morocco.md)
- موزمبيق[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/mozambique.md)
- ناميبيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/namibia.md)
- هولندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/netherlands.md)
- نيوزيلندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/new-zealand.md)
- نيجيريا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/nigeria.md)
- مقدونيا الشمالية[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/north-macedonia.md)
- النرويج[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/norway.md)
- عُمان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/oman.md)
- باكستان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/pakistan.md)
- فلسطين[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/palestine.md)
- بابوا غينيا الجديدة[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/papua-new-guinea.md)
- باراغواي[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/paraguay.md)
- بيرو[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/peru.md)
- الفلبين[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/philippines.md)
- بولندا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/poland.md)
- البرتغال[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/portugal.md)
- رومانيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/romania.md)
- روسيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/russia.md)
- رواندا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/rwanda.md)
- المملكة العربية السعودية[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/saudi-arabia.md)
- صربيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/serbia.md)
- سيشل[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/seychelles.md)
- سنغافورة[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/singapore.md)
- سلوفاكيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/slovakia.md)
- سلوفينيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/slovenia.md)
- جنوب أفريقيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/south-africa.md)
- كوريا الجنوبية[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/south-korea.md)
- إسبانيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/spain.md)
- سريلانكا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/sri-lanka.md)
- سورينام[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/suriname.md)
- السويد[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/sweden.md)
- سويسرا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/switzerland.md)
- تايوان[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/taiwan.md)
- تايلاند[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/thailand.md)
- تونس[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/tunisia.md)
- تركيا[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/turkey.md)
- أوغندا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/uganda.md)
- أوكرانيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/ukraine.md)
- الإمارات العربية المتحدة[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/united-arab-emirates.md)
- المملكة المتحدة[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/united-kingdom.md)
- الولايات المتحدة[جدول رسمي](https://narwhalapi.com/ar/economics/calendar/united-states.md)
- أوروغواي[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/uruguay.md)
- أوزبكستان[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/uzbekistan.md)
- فيتنام[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/vietnam.md)
- زامبيا[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/zambia.md)
- زيمبابوي[تواريخ استرشادية](https://narwhalapi.com/ar/economics/calendar/zimbabwe.md)

## المصادر

55 ناشراً رسمياً: مكاتب إحصاء ووزارات وبنوك مركزية. وتاريخ الناشر ورقمه لهما الغلبة دائماً على تقويم الطرف الثالث.

- Instituto Nacional de Estadística y Censos (INDEC)الأرجنتين
- Australian Bureau of Statistics (ABS)أستراليا
- Statistics Austria النمسا
- Eurostat 7 دولة
- Statbel بلجيكا
- National Bank of Belgium بلجيكا
- Banco Central do Brasil البرازيل
- National Statistical Institute (NSI)بلغاريا
- Statistics Canada كندا
- Central Bank of Chile (BCCh)تشيلي
- National Statistics Institute of Chile (INE)تشيلي
- Croatian Bureau of Statistics (CBS)كرواتيا

عرض كل 55 مصدرًا

- Czech Statistical Office (ČSÚ)تشيكيا
- Statistics Denmark الدنمارك
- Statistics Estonia إستونيا
- European Commission (DG ECFIN)منطقة اليورو
- Statistics Finland فنلندا
- Finnish Customs (Tulli)فنلندا
- National Institute of Statistics and Economic Studies (INSEE)فرنسا
- French Customs فرنسا
- Federal Statistical Office of Germany (Destatis)ألمانيا
- Hellenic Statistical Authority (ELSTAT)اليونان
- Hungarian Central Statistical Office (KSH)المجر
- Statistics Iceland آيسلندا
- Ministry of Statistics and Programme Implementation (MoSPI)الهند
- Central Statistics Office (CSO)أيرلندا
- Italian National Institute of Statistics (Istat)إيطاليا
- Statistics Bureau of Japan اليابان
- Cabinet Office of Japan اليابان
- Japan Customs اليابان
- Central Statistical Bureau of Latvia (CSB)لاتفيا
- State Data Agency of Lithuania ليتوانيا
- STATEC لوكسمبورغ
- Department of Statistics Malaysia (DOSM)ماليزيا
- INEGI المكسيك
- Statistics Netherlands (CBS)هولندا
- Stats NZ نيوزيلندا
- Statistics Norway (SSB)النرويج
- Statistics Poland بولندا
- Statistics Portugal (INE)البرتغال
- National Bank of Romania (BNR)رومانيا
- Federal State Statistics Service (Rosstat)روسيا
- Bank of Russia روسيا
- Singapore Department of Statistics (SingStat)سنغافورة
- Singapore government open-data publications سنغافورة
- Statistical Office of the Republic of Slovenia (SURS)سلوفينيا
- National Statistics Institute of Spain (INE)إسبانيا
- Spanish Tax Agency (AEAT)إسبانيا
- Statistics Sweden (SCB)السويد
- Directorate-General of Budget, Accounting and Statistics (DGBAS)تايوان
- Turkish Statistical Institute (TurkStat)تركيا
- Office for National Statistics (ONS)المملكة المتحدة
- Bureau of Labor Statistics (BLS)الولايات المتحدة
- Bureau of Economic Analysis (BEA)الولايات المتحدة
- US Census Bureau الولايات المتحدة

## واجهات API ذات صلة

### واجهة API للعطلات الرسمية

العطلات الرسمية حسب الدولة، بنطاق وطني وإقليمي.

[استكشف API ‏←](https://narwhalapi.com/ar/api/calendars/holidays.md)

### واجهة API للاقتصاد

مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والفائدة.

[استكشف API ‏←](https://narwhalapi.com/ar/api/economics.md)

### الأسعار

رصيد مدفوع مسبقاً، 2 دولار لكل 1,000 استدعاء، بلا خطط أو شرائح.

[عرض الأسعار ‏←](https://narwhalapi.com/ar/pricing.md)

## الأسئلة الشائعة

هل لكل إصدار وقت دقيق؟

لا. قد تحدد الجهة الناشرة تاريخًا فقط، أو نطاقًا، أو موعدًا نهائيًا. تحتفظ الاستجابة بهذه الدقة في أحد الحقول at أو date أو between أو by في المستوى الأعلى.

هل يمكنني استرجاع نسخة سابقة؟

استخدم المعلمة version_id في طلب تفاصيل الإصدار لاختيار نسخة غير قابلة للتغيير.

هل توجد واجهة API مجانية للتقويم الاقتصادي؟

نعم. يحصل كل حساب في Narwhal على 10 دولارات من الرصيد المجاني كل شهر، بلا بطاقة وبلا تاريخ انتهاء. يكلّف طلب التقويم استدعاءً واحداً بسعر 2 دولار لكل 1,000 استدعاء، فيغطي الرصيد المجاني 5,000 استدعاء شهرياً.

هل يتضمن التقويم توقعات الإجماع؟

نعم، حيث يتوفر ذلك في تقويم من طرف ثالث. تحمل القيمة التوقع بجانب الرقم السابق، وبعد الإصدار الرقم الفعلي. والتوقع تقدير وليس رقماً منشوراً، ويغيب عند عدم معرفته. لا يوجد تقييم للأهمية.

ما المنطقة الزمنية لأوقات الإصدار؟

وقت الإصدار الدقيق، في الحقل at، يكون بتوقيت UTC. ويعطي الحقل timezone المنطقة الزمنية IANA الخاصة بالناشر، مثل Asia/Jakarta، لتتمكن من عرض الوقت المحلي. والإصدار الذي له تاريخ فقط لا وقت له.

ما حجم التاريخ الذي يعيده التقويم؟

يغطي الطلب نافذة حتى 366 يوماً. وتمتد النافذة الافتراضية من 30 يوماً قبل اليوم إلى 335 يوماً بعده. للنطاقات الأطول، اقرأ نافذة تلو الأخرى. والإصدار الذي تغيّر يحتفظ بنسخه السابقة، وتقرأها باستخدام version_id.

هل يمكنني الحصول على التقويم كخلاصة ICS؟

نعم. أنشئ اشتراكاً في التقويم فتعيد Narwhal رابط .ics خاصاً يمكن لتطبيق التقويم الاشتراك فيه. ويمكن أن يضم الإصدارات أو العطلات الرسمية أو كليهما، لـ 1 إلى 50 دولة ضمن نافذة حتى 366 يوماً. وإنشاؤه يكلّف استدعاءً واحداً.

هل يستطيع وكيل ذكاء اصطناعي قراءة التقويم عبر MCP؟

نعم. يضم خادم Narwhal MCP الأداتين economics_list_releases وeconomics_get_release، وهما العمليتان نفسهما في نقطتي REST.

ما حدود المعدل؟

50 طلباً في الدقيقة ما دام الحساب يحمل رصيداً مجانياً فقط، و500 في الدقيقة متى حمل رصيداً مدفوعاً. ويُحدَّد عنوان الشبكة الواحد بـ 120 في الدقيقة. وتحمل استجابة 429 ترويسة Retry-After ولا تكلّف شيئاً.

ما الذي يجب أن أتحقق منه قبل استخدام البيانات؟

لا يضمن الإصدار المجدول النشر في وقت دقيق. احتفظ بدقة التوقيت والمنطقة الزمنية، وتعامل مع الإصدارات الملغاة صراحةً. الوقت المجدول والوقت الذي رصد فيه Narwhal الإصدار يصفان حدثين مختلفين.

## ابدأ بمفتاح مجاني

رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.

[احصل على مفتاح API مجاني](https://narwhalapi.com/ar/signup)
