مرجع API تقويم التسجيلات

إفصاحات S-1 وF-1 و424B حسب يوم الإفصاح، مع شروط الطرح

نظرة عامة

يسرد تقويم التسجيلات بيانات التسجيل والنشرات النهائية التي أرسلتها الشركات إلى SEC، حسب يوم الإفصاح: بيانات S-1 وF-1 وتعديلاتها، ونشرات 424B4 و424B1 التي تحدد شروط الطرح. يحتاج كل طلب إلى مفتاح Bearer، ويستخدم REST وMCP رصيدًا واحدًا.

كل صف إفصاح واحد، ومعظم الإفصاحات ليست أول بيع أسهم لشركة. class يبين نوع كل منها: ipo أو spac أو shell أو resale أو other. يشترك S-1 وتعديلاته ونشرته النهائية في file_number واحد، فعُدّ الطروحات بحسب file_number.

اترك end فارغًا للحصول على اليوم بتوقيت UTC، واترك start فارغًا للحصول على 30 يومًا قبل end. يغطي الطلب الواحد 12 شهرًا تقويميًا على الأكثر، والنافذة الأطول تعطي 400 range_too_large. يبدأ السجل في نوفمبر 2025.

الافتراضي هو الولايات المتحدة. يُجيب country=jpn ببيانات تسجيل الأوراق المالية اليابانية ويغطي جزءًا منها: نحو 79% من إفصاحات اليابان لها ملف نصي مقروء، والباقي مفقود. أما country=kor فهو 404 not_covered مجاني.

عنوان URL الأساسي: https://api.narwhalapi.com. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.

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

معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.

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

ما	كل حساب
تقويم التسجيلات	مشمول

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

هذا المسار يقع ضمن التقويمات، لكنه يُحاسَب بسعر Companies. كل إجابة ناجحة استدعاء واحد، مهما كان عدد الصفوف، وتُحاسَب الصفحة الفارغة أيضًا. لا تُحاسَب الأخطاء.
المبالغ بـ currency وكما طُبعت على الإفصاح. يترك الإفصاح الأمريكي currency محذوفًا، أي الدولار الأمريكي.
تُقرأ ticker وشروط الطرح وunderwriters وlaw_firms وmanagement من نص الإفصاح وتُحذف عندما لا يذكرها. القوائم غير مضمونة الاكتمال، وقد تحمل قائمة المتعهدين عنوان جدول مثل Joint Book-Runners بوصفه اسمًا.
تُقرأ management لإفصاحات ipo وspac وshell فقط. وتأتي financials من وسوم البيانات المالية داخل النشرة. كثير من الشركات التي لم تُدرج بعد لا تضع وسومًا على قوائمها، فتُحذف غالبًا.
تُرسل cik لإفصاحات الولايات المتحدة فقط. لدولة أخرى صفِّ بـ ticker.

نقاط النهاية

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

قائمة التسجيلات

GET /v1/calendars/registrations

بيانات التسجيل (S-1 وF-1 وتعديلاتهما) والنشرات النهائية (424B4 و424B1) المقدمة في نافذة تصل إلى 12 شهرًا، الأقدم أولًا. كل صف إفصاح واحد، ومعظم الإفصاحات ليست طروحات عامة أولية: class يبين نوع كل منها.

class هو ipo لأول طرح عام للشركة، سواء باعت الشركة أو حاملو أسهمها أو الطرفان. spac شركة شيك على بياض، وshell شركة ناشئة بلا عمليات. resale هو بيع حاملين حاليين أسهم شركة مدرجة أصلًا. other طرح لاحق أو أي شيء لا نستطيع تمييزه.

price_low وprice_high هما النطاق المتوقع في S-1 أو F-1. وفي 424B4 أو 424B1 هما السعر النهائي، فيتطابقان.

MCP: الأداة calendars_list_registrations.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`start`	استعلام	لا	التاريخ	أول يوم إفصاح (YYYY-MM-DD)، شاملًا. الحذف يعني 30 يومًا قبل `end`.
`end`	استعلام	لا	التاريخ	آخر يوم إفصاح، شاملًا. الحذف يعني اليوم (UTC). يغطي `start` إلى `end` 12 شهرًا تقويميًا على الأكثر (400 range_too_large).
`country`	استعلام	لا	سلسلة نصية	رمز الدولة من ثلاثة أحرف للسجل. الحذف يعني USA. الدولة التي لا يغطيها المسار تُجيب 404 not_covered.
`cik`	استعلام	لا	سلسلة نصية	إفصاحات صاحب SEC CIK هذا فقط (الأصفار البادئة اختيارية). للولايات المتحدة فقط: مع دولة أخرى استخدم `ticker`.
`ticker`	استعلام	لا	سلسلة نصية	الإفصاحات التي تذكر هذا الرمز على الغلاف (الرمز المقترح لشركة تطرح أسهمها للجمهور)، أو التي يعرف الفهرس مقدمها بهذا الرمز.
`class`	استعلام	لا	one of ipo, spac, shell, resale, other	الإفصاحات من هذه الفئة فقط: ipo أو spac أو shell أو resale أو other.
`form`	استعلام	لا	one of S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, TODOKE, TODOKE/A	الإفصاحات على هذا النموذج فقط، مثل S-1 أو 424B4.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.
`limit`	استعلام	لا	عدد صحيح	عدد الصفوف في الصفحة. الافتراضي 100 وبحد أقصى 500.

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

حقل	النوع	يُرسل	المعنى
`start`	التاريخ	دائمًا	أول يوم إفصاح في النافذة بعد تطبيق القيم الافتراضية.
`end`	التاريخ	دائمًا	آخر يوم إفصاح في النافذة بعد تطبيق القيم الافتراضية.
`registrations`	قائمة كائنات	دائمًا	الإفصاحات في النافذة، الأقدم أولًا.
`registrations[].filing_id`	سلسلة نصية	دائمًا	معرّف الإفصاح، لاستخدامه مع Filings API.
`registrations[].cik`	سلسلة نصية	اختياري	CIK لدى SEC لمقدّم الإفصاح. إفصاحات الولايات المتحدة فقط.
`registrations[].company_id`	سلسلة نصية	اختياري	معرّف الشركة في فهرسنا، عندما يكون مقدّم الإفصاح فيه.
`registrations[].name`	سلسلة نصية	اختياري	اسم مقدّم الإفصاح.
`registrations[].form`	one of S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, TODOKE, TODOKE/A	دائمًا	النموذج: `S-1` أو `S-1/A` أو `F-1` أو `F-1/A` أو `424B4` أو `424B1`، و`TODOKE` و`TODOKE/A` في اليابان.
`registrations[].filed`	التاريخ	دائمًا	يوم تقديم الإفصاح.
`registrations[].class`	one of ipo, spac, shell, resale, other	دائمًا	نوع الإفصاح: `ipo` أو `spac` أو `shell` أو `resale` أو `other`.
`registrations[].currency`	سلسلة نصية	اختياري	عملة الحقول المالية. الحذف يعني الدولار الأمريكي.
`registrations[].price_low`	سلسلة نصية	اختياري	الحد الأدنى للسعر المتوقع للسهم، أو السعر النهائي في النشرة.
`registrations[].price_high`	سلسلة نصية	اختياري	الحد الأعلى للسعر المتوقع للسهم، أو السعر النهائي في النشرة.
`registrations[].exchange`	سلسلة نصية	اختياري	السوق الذي يذكره مقدّم الإفصاح على غلافه.
`registrations[].file_number`	سلسلة نصية	اختياري	رقم التسجيل المطبوع على الإفصاح، مثل `333-284180`. لكل طرح رقم واحد.
`registrations[].ticker`	سلسلة نصية	اختياري	الرمز الذي يعطيه الغلاف للأسهم.
`registrations[].shares_offered`	سلسلة نصية	اختياري	الأسهم أو الوحدات أو ADSs في عنوان الغلاف، قبل أي تخصيص زائد.
`registrations[].offered_as`	one of shares, units, ads	اختياري	ما يُطرح: `shares` أو `units` أو `ads`.
`registrations[].offering_amount`	سلسلة نصية	اختياري	إجمالي مبلغ الطرح من جدول أسعار الغلاف.
`registrations[].underwriting_discount`	سلسلة نصية	اختياري	إجمالي خصم الاكتتاب من جدول أسعار الغلاف.
`registrations[].proceeds_before_expenses`	سلسلة نصية	اختياري	إجمالي العوائد قبل المصروفات من جدول أسعار الغلاف.
`registrations[].price_per_share`	سلسلة نصية	اختياري	سعر الطرح للسهم أو الوحدة أو ADS، كما يبيّن `offered_as`.
`registrations[].underwriting_discount_per_share`	سلسلة نصية	اختياري	خصم الاكتتاب للسهم أو الوحدة أو ADS.
`registrations[].proceeds_per_share`	سلسلة نصية	اختياري	العوائد للسهم أو الوحدة أو ADS.
`registrations[].underwriters`	list of string	اختياري	الشركات المذكورة على الغلاف بوصفها متعهدي اكتتاب.
`registrations[].law_firms`	list of string	اختياري	مكاتب المحاماة من خانة Copies to، ومن Legal Matters في إفصاحات `ipo` و`spac` و`shell`.
`registrations[].management`	قائمة كائنات	اختياري	المديرون والمسؤولون التنفيذيون من جدول الإدارة في الإفصاح.
`registrations[].management[].name`	سلسلة نصية	دائمًا	اسم المدير أو المسؤول.
`registrations[].management[].title`	سلسلة نصية	دائمًا	المسمى كما يذكره الإفصاح.
`registrations[].management[].age`	عدد صحيح	اختياري	العمر كما يذكره الإفصاح.
`registrations[].financials`	كائن	اختياري	أحدث أرقام سنوية للشركة، مقروءة من وسوم البيانات المالية في النشرة. تُحذف عندما لا تكون القوائم موسومة.
`registrations[].financials.fiscal_year_end`	التاريخ	دائمًا	نهاية أحدث سنة مالية كاملة لها أرقام موسومة.
`registrations[].financials.currency`	سلسلة نصية	اختياري	عملة القوائم.
`registrations[].financials.revenue`	سلسلة نصية	اختياري	إيرادات تلك السنة، بوحدات كاملة.
`registrations[].financials.net_income`	سلسلة نصية	اختياري	صافي دخل تلك السنة، بوحدات كاملة.
`registrations[].financials.total_assets`	سلسلة نصية	اختياري	إجمالي الأصول في ذلك التاريخ، بوحدات كاملة.
`registrations[].financials.total_liabilities`	سلسلة نصية	اختياري	إجمالي الالتزامات في ذلك التاريخ، بوحدات كاملة.
`registrations[].financials.total_equity`	سلسلة نصية	اختياري	إجمالي حقوق الملكية في ذلك التاريخ، بوحدات كاملة.
`registrations[].financials.cash`	سلسلة نصية	اختياري	النقد في ذلك التاريخ، بوحدات كاملة.
`next_cursor`	سلسلة نصية	دائمًا	مرّره بوصفه cursor لقراءة الصفحة التالية. يُرسل دائمًا؛ وقيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/registrations?ticker=ACCV&form=424B4&start=2026-10-01&end=2026-11-12"

{ "start": "2026-10-01", "end": "2026-11-12", "registrations": [ { "filing_id": "usa:0002141406:0001628280-26-064097", "cik": "0002141406", "company_id": "usa:0002141406", "name": "Accelevation Holdings Corp.", "form": "424B4", "filed": "2026-10-01", "class": "ipo", "price_low": "18.00", "price_high": "18.00", "exchange": "Nasdaq", "file_number": "333-298715", "ticker": "ACCV", "shares_offered": "30000000", "offered_as": "shares", "offering_amount": "540000000", "underwriting_discount": "28350000", "proceeds_before_expenses": "170550000", "price_per_share": "18.00", "underwriting_discount_per_share": "0.945", "proceeds_per_share": "17.055", "underwriters": [ "Morgan Stanley", "J.P. Morgan", "Goldman Sachs & Co. LLC", "Barclays" ], "law_firms": [ "Kirkland & Ellis LLP", "Simpson Thacher & Bartlett LLP" ], "management": [ { "name": "Michael Rubiera", "title": "Chief Executive Officer and Director", "age": 52 }, { "name": "Kenneth Krause", "title": "Chief Financial Officer", "age": 51 } ] } ], "next_cursor": null }

الأخطاء

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

الرمز	الحالة	المعنى
`invalid_query`	400	معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
`range_too_large`	400	النافذة أطول مما يسمح به المسار.
`invalid_cursor`	400	مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
`not_covered`	404	السوق أو البلد أو الشركة غير مغطى بعد.
`insufficient_credits`	402	رصيدك أقل من تكلفة الطلب.
`company_data_unavailable`	503	تعذّرت قراءة الإفصاحات وراء هذا المسار الآن. حاول مرة أخرى بعد قليل.

هل كانت هذه الصفحة مفيدة؟