التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←جميع واجهات API
API إفصاحات الشركات للقوائم والسجلات
اسرد إفصاحات شركة، أو اجلب سجل إفصاح، أو اقرأ أحدث الإفصاحات عبر الشركات، مع روابط إلى النسخ الرسمية لدى الجهات التنظيمية.
الطلب الأول
اعرض الإفصاحات السنوية للشركة
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية
{
"id": "usa:0000789019",
"filings": [
{
"id": "usa:0000789019:0001193125-26-323660",
"date": "2026-07-29",
"type": "annual",
"title": "10-K"
}
]
}نقاط النهاية
GETاعرض إفصاحات الشركة/v1/companies/{company_id}/filings
إفصاحات الشركة، الأحدث أولًا، مع رابط لكل نسخة رسمية.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
typeاختياريفئة الإفصاح، مثل annual.
حقول الاستجابة
idحقلمعرّف الإفصاح
dateحقلتاريخ تقديم الإفصاح
typeحقلفئة الإفصاح، مثل سنوي أو ربع سنوي أو حدث أو ملكية
titleحقلعنوان الإفصاح
urlحقلرابط الإفصاح الرسمي على موقع الجهة التنظيمية
company_idحقلمعرّف الشركة المرتبطة بالإفصاح
formحقلتسمية النموذج لدى الجهة التنظيمية، مثل 10-K أو 13D
period_endحقلتاريخ نهاية فترة التقرير التي يغطيها الإفصاح
filing_id (on stock earnings)حقلالتقرير السنوي أو النصف سنوي أو ربع السنوي الذي يغطي تقرير أرباح سابقًا. مرّره إلى مسار الإفصاح لقراءة السجل. يُحذف عند عدم وجود إفصاح مطابق وعند عدم وجود تقرير يناسب التاريخ.
المرجع الكامل ←
GETاحصل على أحدث الإفصاحات عبر الشركات/v1/filings/latest
GETاحصل على سجل إفصاح/v1/filings/{filing_id}
سجل إفصاح واحد، مع نموذجه وتواريخه ورابط للنسخة الرسمية.
المعلمات
filing_idمطلوبمعرّف إفصاح، مثل usa:0000320193:0000320193-25-000079.
المرجع الكامل ←
حالات الاستخدام
احصل على إشعار بالإفصاحات الجديدة
استقبل webhook عند نشر إفصاح وتحقق منه.
اقرأ الدليل ←حمّل بيانات الشركات لسنوات
تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←ابقَ ضمن حدودك
خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←اسأل وكيلًا ذكيًا عن شركة
امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←التغطية
- الولايات المتحدةالإفصاحات والقوائم المالية. السجل التاريخي منذ 2009.
- اليابانأكثر من 3,800 شركة، سنوي ونصف سنوي.
- كوريانحو نصف الشركات المدرجة حتى الآن.
- تايواننحو 1,980 شركة. تقارير النصف الأول من 2026.
- الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةنحو 3,200 شركة في 26 دولة، سنوي فقط.
- المملكة المتحدةنحو 800 شركة في الأسواق المنظمة، سنوي فقط.
المصادر
- الولايات المتحدةSEC EDGAR
- اليابانEDINET، هيئة الخدمات المالية
- كورياDART، هيئة الرقابة المالية
- تايوانالشركات المدرجة في TWSE وTPEx
- الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةالتقارير السنوية بصيغة ESEF
- المملكة المتحدةالجهات المصدرة في السوق المنظمة بالمملكة المتحدة
واجهات API ذات صلة
SEC EDGAR API عبر Narwhal
إفصاحات الولايات المتحدة المباشرة والبيانات المالية XBRL الموحدة من SEC EDGAR
استكشف API ←تغطية EDINET API متاحة الآن
إفصاحات اليابان وقوائمها المالية، مباشرة
استكشف API ←تغطية DART API متاحة الآن
إفصاحات كوريا وقوائمها المالية، مباشرة
استكشف API ←MOPS API لإفصاحات تايوان وقوائمها
البيانات المالية للشركات التايوانية من TWSE OpenAPI وبيانات TPEx المفتوحة على data.gov.tw
استكشف API ←ESEF API للإفصاحات السنوية للشركات
التقارير السنوية لشركات من 26 دولة في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية
استكشف API ←تقارير الشركات المدرجة في بريطانيا عبر API التقارير المالية للشركات البريطانية
التقارير السنوية للمصدرين في الأسواق المنظمة بالمملكة المتحدة
استكشف API ←الأسئلة الشائعة
أي النماذج تغطي المصدّرين الأجانب الخاصين؟
يُصنَّف النموذج 20-F سنوياً، ويُصنَّف النموذج 6-K حدثاً.
هل يمكنني جلب إفصاح بمعرّفه؟
استخدم GET /v1/filings/{filing_id} لجلب سجل إفصاح بعينه.
أين أقرأ الإفصاح الأصلي؟
اتبع رابط url في السجل للوصول إلى النسخة الرسمية على موقع الجهة التنظيمية. تبقى تلك الوثيقة هي المرجع.
كيف أنتقل من تقرير الأرباح إلى إفصاحه؟
يحمل صف أرباح سابق في مسارات الأسهم معرّف إفصاح عندما يتوفر لدينا التقرير الذي يغطيه. مرّره إلى مسار الإفصاح. قد يختلف ربح السهم في الأرباح عن ربح السهم في القوائم المالية للإفصاح، لأن رقم الأرباح مبني على أساس بيانات السوق.
قوائم إفصاحات الشركات
اقرأ إفصاحات الشركة بحسب النوع والنموذج والتاريخ.
أحدث الإفصاحات
احصل على أحدث الإفصاحات عبر الشركات من نقطة نهاية واحدة.
الروابط الرسمية
يتضمن كل سجل معرّفاً وتاريخاً ونوعاً وعنواناً ورابطاً إلى الإفصاح الرسمي.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.