التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←جميع واجهات API
SEC EDGAR API عبر Narwhal
احصل على سجلات الإفصاح الأمريكية والبيانات المالية XBRL الموحدة بصيغة JSON عبر Narwhal، دون أن تتعامل مع بيانات EDGAR الخام بنفسك.
الطلب الأول
اعرض إفصاحات الشركة
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
--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
ابحث عن الشركات بالاسم واحصل على معرّفاتها. استخدم المعرّف في كل الطلبات الأخرى.
المعلمات
qاختيارينص البحث، مثل اسم شركة.
المرجع الكامل ←
GETاعرض إفصاحات الشركة/v1/companies/{company_id}/filings
إفصاحات الشركة، الأحدث أولًا، مع رابط لكل نسخة رسمية.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
typeاختياريفئة الإفصاح، مثل annual.
المرجع الكامل ←
GETاحصل على القوائم المالية الموحدة للشركات/v1/companies/{company_id}/financials
قوائم مالية موحدة للشركة، صف لكل فترة، بالعملة التي تقدم بها الشركة إفصاحاتها.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
periodاختياريannual أو semiannual بحسب السجل.
statementاختياريincome أو balance أو cash_flow أو per_share.
fieldsاختياريأسماء عناصر مفصولة بفواصل، مثل revenue,net_income.
المرجع الكامل ←
GETاحصل على كبار الملاك بنسبة 5% أو أكثر/v1/companies/{company_id}/holders
الملاك بنسبة 5% أو أكثر، مع النسبة المبلغ عنها وعدد الأسهم والإفصاح الذي يبلغ عنها.
المعلمات
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
المرجع الكامل ←
حالات الاستخدام
احصل على إشعار بالإفصاحات الجديدة
استقبل webhook عند نشر إفصاح وتحقق منه.
اقرأ الدليل ←حمّل بيانات الشركات لسنوات
تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←ابقَ ضمن حدودك
خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←اسأل وكيلًا ذكيًا عن شركة
امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←التغطية
- الولايات المتحدةالإفصاحات والقوائم المالية. السجل التاريخي منذ 2009.
المصادر
- الولايات المتحدةSEC EDGAR
واجهات API ذات صلة
تغطية EDINET API متاحة الآن
إفصاحات اليابان وقوائمها المالية، مباشرة
استكشف API ←تغطية DART API متاحة الآن
إفصاحات كوريا وقوائمها المالية، مباشرة
استكشف API ←API إفصاحات الشركات للقوائم والسجلات
قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات
استكشف API ←تحليل القوائم المالية للشركات عبر API
القوائم الموحدة وفترات التقرير والإصدارات التاريخية
استكشف API ←MOPS API لإفصاحات تايوان وقوائمها
البيانات المالية للشركات التايوانية من TWSE OpenAPI وبيانات TPEx المفتوحة على data.gov.tw
استكشف API ←ESEF API للإفصاحات السنوية للشركات
التقارير السنوية لشركات من 26 دولة في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية
استكشف API ←تقارير الشركات المدرجة في بريطانيا عبر API التقارير المالية للشركات البريطانية
التقارير السنوية للمصدرين في الأسواق المنظمة بالمملكة المتحدة
استكشف API ←الأسئلة الشائعة
ماذا تُرجع Narwhal من SEC EDGAR؟
تُرجع Narwhal سجلات إفصاحات الشركات والقوائم المالية الموحدة وحاملي 5% أو أكثر المُبلَّغ عنهم في الجدولين 13D و13G.
كيف تعمل معرّفات شركات SEC؟
يجمع معرّف الشركة الأمريكية بين usa: ومفتاح الفهرس المركزي لدى SEC، مثل usa:0000789019. وتُقبل أيضاً أسماء الرموز المستعارة مثل usa:MSFT.
هل يحل التوحيد القياسي محل الإفصاح الرسمي؟
يبقى إفصاح SEC هو المرجع. توفر Narwhal سجلات JSON وأرقاماً موحدة لتستخدمها في تطبيقك.
بيانات الإفصاح الوصفية
تُرجع Narwhal معرّفات الإفصاحات وتواريخها وأنواعها وعناوينها وروابطها الرسمية.
بنود القوائم القياسية
تُوحَّد البيانات المالية XBRL في 77 بنداً متاحة في كل حساب.
مفتاح API واحد
الوصول إلى API الإفصاحات من Narwhal عبر REST وMCP.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.