التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←إفصاحات الشركات الكورية وقوائمها المالية من DART مباشرة، مع إبقاء المبالغ بالوون كما وردت في الإفصاح.
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
--header "Authorization: Bearer $NARWHAL_API_KEY"/v1/companies/{company_id}/filingsإفصاحات الشركة، الأحدث أولًا، مع رابط لكل نسخة رسمية.
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
typeاختياريفئة الإفصاح، مثل annual.
/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.
/v1/companies/{company_id}/holdersالملاك بنسبة 5% أو أكثر، مع النسبة المبلغ عنها وعدد الأسهم والإفصاح الذي يبلغ عنها.
company_idمطلوبمعرّف شركة مثل usa:0000789019، أو اسم مستعار للرمز مثل usa:MSFT.
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←استقبل webhook عند نشر إفصاح وتحقق منه.
اقرأ الدليل ←تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←إفصاحات الولايات المتحدة المباشرة والبيانات المالية XBRL الموحدة من SEC EDGAR
استكشف API ←إفصاحات اليابان وقوائمها المالية، مباشرة
استكشف API ←قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات
استكشف API ←البيانات المالية للشركات التايوانية من TWSE OpenAPI وبيانات TPEx المفتوحة على data.gov.tw
استكشف API ←التقارير السنوية لشركات من 26 دولة في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية
استكشف API ←التقارير السنوية للمصدرين في الأسواق المنظمة بالمملكة المتحدة
استكشف API ←نعم. نحو نصف الشركات المدرجة محمَّل، ويجري إضافة المزيد.
تغطية القوائم في كوريا سنوية وربع سنوية فقط.
نعم. تقارير DART الخاصة بـ 5% مشمولة.
DART هو نظام الإفصاح لدى هيئة الإشراف المالي في كوريا.
تبقى المبالغ المالية بالوون كما وردت في الإفصاح.
نحو نصف الشركات المدرجة محمَّل.
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.