التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←جميع واجهات API
API كبار المساهمين في الشركات
اقرأ حاملي 5% أو أكثر في الولايات المتحدة واليابان وكوريا، مع الأسماء والنسب المُبلَّغ عنها والأسهم وتواريخ الأحداث ومراجع الإفصاحات.
الطلب الأول
احصل على كبار الملاك بنسبة 5% أو أكثر
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/holders" \
--header "Authorization: Bearer $NARWHAL_API_KEY"نقاط النهاية
GETاحصل على كبار الملاك بنسبة 5% أو أكثر/v1/companies/{company_id}/holders
الملاك بنسبة 5% أو أكثر، مع النسبة المبلغ عنها وعدد الأسهم والإفصاح الذي يبلغ عنها.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
حقول الاستجابة
holderحقلاسم الحامل، دون عنوان أو رقم هوية شخصية
percentحقلنسبة الملكية كما كُتبت في الإفصاح، و5.12 تعني 5.12%
sharesحقلعدد الأسهم المُبلَّغ عنها للحامل
event_dateحقلتاريخ حدث الملكية المُبلَّغ عنه في الإفصاح
filedحقلتاريخ تقديم إفصاح الملكية
filing_idحقلمعرّف إفصاح الملكية الذي يبلّغ عن الحيازة
securityحقلفئة الورقة المالية ونوعها وisin عندما يسمي الإفصاح ورقة مالية
المرجع الكامل ←
حالات الاستخدام
احصل على إشعار بالإفصاحات الجديدة
استقبل webhook عند نشر إفصاح وتحقق منه.
اقرأ الدليل ←حمّل بيانات الشركات لسنوات
تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←ابقَ ضمن حدودك
خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←اسأل وكيلًا ذكيًا عن شركة
امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←التغطية
- الولايات المتحدةالإفصاحات والقوائم المالية. السجل التاريخي منذ 2009.
- اليابانأكثر من 3,800 شركة، سنوي ونصف سنوي.
- كوريانحو نصف الشركات المدرجة حتى الآن.
المصادر
- الولايات المتحدةSEC EDGAR
- اليابانEDINET، هيئة الخدمات المالية
- كورياDART، هيئة الرقابة المالية
واجهات API ذات صلة
API إفصاحات الشركات للقوائم والسجلات
قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات
استكشف API ←تحليل القوائم المالية للشركات عبر API
القوائم الموحدة وفترات التقرير والإصدارات التاريخية
استكشف API ←SEC EDGAR API عبر Narwhal
إفصاحات الولايات المتحدة المباشرة والبيانات المالية XBRL الموحدة من SEC EDGAR
استكشف API ←الأسئلة الشائعة
هل تسرد نقطة النهاية هذه كل المساهمين؟
تغطي نقطة نهاية الحاملين حاملي 5% أو أكثر كما وردوا في إفصاحات الملكية.
ما التواريخ ومراجع الإفصاحات التي تُرجع؟
يتضمن كل سجل حامل event_date وfiled وfiling_id، إلى جانب اسم الحامل والنسبة وعدد الأسهم.
هل يمكنني طلب الحاملين باستخدام اسم مستعار للرمز؟
تقبل نقطة النهاية معرّف شركة مثل usa:0000789019، وكذلك اسماً مستعاراً مقبولاً مثل usa:MSFT.
إلى أي مدى يمتد السجل التاريخي للملاك؟
يحصل كل حساب على التاريخ الكامل، مسلَّمًا مباشرة.
النسبة كما وردت في الإفصاح
القيمة المئوية 5.12 تعني 5.12%، بما يطابق النسبة المكتوبة في الإفصاح.
الأسماء فقط
تحتوي سجلات الحاملين على أسماء، ولا تحتوي أبداً على عناوين أو أرقام هوية شخصية.
الورقة المالية عند ذكرها
يحمل كائن الورقة المالية الفئة والنوع وisin عندما يسمي الإفصاح ورقة مالية.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.