مرجع واجهة إيداعات SEC API

البحث عن الشركات والهوية الثابتة وبيانات الإيداعات الوصفية. متاح باستخدام مفتاح Narwhal API

عنوان URL الأساسي والهوية

مسار REST الأساسي

https://api.narwhalapi.com/v1/companies

يقبل البحث اسم الشركة أو رمزها أو CIK. وتعيد الاستجابة معرّف الشركة الثابت المستخدم في مساري الهوية والإيداعات، ويتوفر ذلك باستخدام مفتاح Narwhal API.
لكل شركة معادة معرّف معتم ثابت واحد هو company_idيبقى Ticker وCIK اسميْن بديلين.
تستخدم REST وMCP مخططات الإدخال والإخراج نفسها.

طلب

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

ثلاث عمليات للإصدار الأول

لكل عملية مسار REST واحد وأداة MCP واحدة بالمخطط نفسه للإدخال والإخراج.

عملية	مسار REST	أداة MCP
البحث عن الشركات	`/v1/companies`	`companies_search`
احصل على هوية الشركة	`/v1/companies/{company_id}`	`companies_get`
اعرض إيداعات الشركة	`/v1/companies/{company_id}/filings`	`companies_list_filings`

السلوك المشترك

تستخدم نتائج التجميع ترتيبًا حتميًا ومؤشرات معتمة بدل الإزاحات أو أرقام الصفحات.
ترتبط المؤشرات بالاستعلام المطبّع ومعرّف الشركة والحد وكل مرشح إيداع.
يقبل البحث اسم الشركة أو رمزها أو CIK. وتعيد الاستجابة معرّف الشركة الثابت المستخدم في مساري الهوية والإيداعات، ويتوفر ذلك باستخدام مفتاح Narwhal API. as_of وقت اللقطة المنشورة الكاملة.
يعيد معرّف الشركة غير المعروف 404 company_not_foundتعيد شركة معروفة لا توجد لها إيداعات مطابقة مصفوفة فارغة.
يعيد إدخال نموذج أو تاريخ أو مؤشر أو ترقيم صفحات غير صالح 400 invalid_query.
تستخدم استجابات REST وMCP الناجحة حصة Narwhal المشتركة.

نطاق الإصدار الأول

الإصدار الأول يقتصر على البيانات الوصفية وروابط SEC الأساسية. ولا يتضمن أجسام الإيداعات أو المرفقات أو حقائق XBRL أو البحث بالنص الكامل أو بيانات CUSIP أو البيانات المالية أو معاملات المطلعين المطبّعة أو الحيازات المؤسسية أو التنبيهات أو إشارات التداول.

تقتصر التغطية على مجموعة المُصدرين المقبولة. وتتضمن الاستجابات وقت as_of للنشر. اقرأ منهجية الشركات لقواعد الهوية والتعديل واللقطة.