مرجع تقويم الشركات API للأرباح وتجزئة الأسهم

نظرة عامة

توزيعات أرباح الشركات وتجزئات الأسهم لنافذة من الأيام، عبر كل شركة مُدرجة نغطيها. يحتاج كل طلب إلى مفتاح Bearer، ويسحب REST وMCP من رصيد واحد.

تمتد التواريخ من 30 يومًا مضت إلى 90 يومًا قادمة، ويغطي الطلب الواحد 7 أيام كحد أقصى. احذف start ليكون اليوم بتوقيت UTC، واحذف end ليكون اليوم نفسه كما في start. خارج هذا النطاق تكون الإجابة 400 invalid_query، والمدة الأطول تعيد 400 range_too_large.

تُغطى USA فقط حاليًا. أي بلد آخر يعيد 404 not_covered. لا تظهر إلا الشركات الموجودة في قائمة الرموز لدينا، مع معرّفنا واسمنا، وتُعرض فئات الأسهم لجهة إصدار واحدة في صف واحد.

عنوان URL الأساسي: https://api.narwhalapi.com. أداة MCP هي company_calendars, with one action لكل مسار أدناه.

ما يحصل عليه كل حساب

راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.

• كل طلب استدعاء واحد، مهما كان عدد الصفوف.
• تُحذف الشركة التي ليس لها رمز مُدرج نشط في قائمة الرموز لدينا.
• نسبة التجزئة هي أسهم جديدة مقابل قديمة: 4:1 تعني أربعة مقابل واحد، و1:10 تجزئة عكسية.

نقاط النهاية

كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

تقويم توزيعات أرباح الشركات

GET /v1/calendars/dividends

التوزيعات التي يحين استحقاقها ضمن النافذة: تاريخ الاستحقاق ومبلغ السهم الواحد وعملته. start وend يومان شاملان (YYYY-MM-DD)؛ وعند حذفهما يكون start اليوم (UTC) ويكون end هو start. تمتد التواريخ من 30 يومًا مضت إلى 90 يومًا قادمة (400 invalid_query خارج ذلك)، ويغطي الطلب 7 أيام كحد أقصى (400 range_too_large). country هو USA، البلد الوحيد حاليًا (404 not_covered). لا تظهر إلا الشركات الموجودة في قائمة الرموز لدينا، مع معرّفنا واسمنا؛ وتُعرض الوحدات وفئات الأسهم لجهة إصدار واحدة في صف واحد. متاح لكل حساب، واستدعاء واحد لكل طلب.

MCP: الأداة company_calendars, action dividends.

المعلمات

حقول الاستجابة

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/dividends?start=2026-10-26&end=2026-11-01"

{
  "entries": [
    {
      "ex_date": "2026-10-29",
      "id": "XNYS:KO",
      "symbol": "KO",
      "name": "The Coca-Cola Company",
      "amount": "0.51",
      "currency": "USD"
    }
  ],
  "next_cursor": null
}

تقويم تجزئات أسهم الشركات

GET /v1/calendars/splits

تجزئات الأسهم التي تسري ضمن النافذة، مع النسبة كأسهم جديدة مقابل قديمة (4:1 تعني أربعة مقابل واحد؛ و1:10 تجزئة عكسية). start وend يومان شاملان (YYYY-MM-DD)؛ وعند حذفهما يكون start اليوم (UTC) ويكون end هو start. تمتد التواريخ من 30 يومًا مضت إلى 90 يومًا قادمة (400 invalid_query خارج ذلك)، ويغطي الطلب 7 أيام كحد أقصى (400 range_too_large). country هو USA، البلد الوحيد حاليًا (404 not_covered). لا تظهر إلا الشركات الموجودة في قائمة الرموز لدينا، مع معرّفنا واسمنا؛ وتُعرض الوحدات وفئات الأسهم لجهة إصدار واحدة في صف واحد. متاح لكل حساب، واستدعاء واحد لكل طلب.

MCP: الأداة company_calendars, action splits.

المعلمات

حقول الاستجابة

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/splits?start=2026-10-26&end=2026-11-01"

{
  "entries": [
    {
      "date": "2026-10-28",
      "id": "XNAS:EXMP",
      "symbol": "EXMP",
      "name": "Example Holdings Inc.",
      "ratio": "4:1"
    }
  ],
  "next_cursor": null
}

الأخطاء

تستخدم الأخطاء بنية المشكلة المشتركة مع: request_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.