حمّل بيانات الشركات لسنوات
تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.
اقرأ الدليل ←جميع واجهات API
MOPS API لإفصاحات تايوان وقوائمها
احصل على القوائم المالية لنحو 1,980 شركة مدرجة في TWSE وTPEx في تايوان. يغطي API حالياً التقارير النصف سنوية لعام 2026.
الطلب الأول
احصل على البيانات المالية النصف سنوية
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية
{
"id": "twn:2330",
"currency": "TWD",
"semiannual": [
{
"fy": 2026,
"fh": 1,
"end": "2026-06-30",
"derived": [],
"revenue": "2404483690000",
"net_income": "1279041690000",
"total_assets": "9375654727000"
}
],
"as_of": "2026-10-24"
}نقاط النهاية
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.
المرجع الكامل ←
حالات الاستخدام
التحديث وفق جدول زمني
اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.
اقرأ الدليل ←ابقَ ضمن حدودك
خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.
اقرأ الدليل ←اسأل وكيلًا ذكيًا عن شركة
امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.
اقرأ الدليل ←التغطية
- تايواننحو 1,980 شركة. تقارير النصف الأول من 2026.
المصادر
- تايوانالشركات المدرجة في TWSE وTPEx
واجهات API ذات صلة
ESEF API للإفصاحات السنوية للشركات
التقارير السنوية لشركات من 26 دولة في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية
استكشف API ←تقارير الشركات المدرجة في بريطانيا عبر API التقارير المالية للشركات البريطانية
التقارير السنوية للمصدرين في الأسواق المنظمة بالمملكة المتحدة
استكشف API ←تغطية EDINET API متاحة الآن
إفصاحات اليابان وقوائمها المالية، مباشرة
استكشف API ←تغطية DART API متاحة الآن
إفصاحات كوريا وقوائمها المالية، مباشرة
استكشف API ←API إفصاحات الشركات للقوائم والسجلات
قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات
استكشف API ←الأسئلة الشائعة
كيف تعمل معرّفات الشركات التايوانية؟
يجمع معرّف الشركة التايوانية بين twn: ورمز السهم، مثل twn:2330.
ما التواريخ التي تغطيها الميزانيات العمومية؟
تصدر الميزانيات العمومية في تاريخ كل تقرير.
هل تشمل البيانات حاملي 5% أو أكثر في تايوان؟
لا. حاملو 5% أو أكثر غير مشمولين في تايوان.
TWSE OpenAPI وبيانات TPEx المفتوحة
نستخدم OpenAPI لبورصة تايوان (TWSE) وبيانات بورصة تايبيه (TPEx) المفتوحة على data.gov.tw بموجب Taiwan Open Government Data Licence v1.0. تعكس هذه المصادر إفصاحات MOPS.
أرقام النصف السنوي
أرقام الدخل والسهم الواحد تراكمية منذ بداية السنة للنصف السنوي (period=semiannual). ستأتي الأرقام السنوية مع التقارير السنوية.
الدولار التايواني الصحيح
المبالغ النقدية بالدولار التايواني الصحيح، مضروبة من قيم المصدر المعطاة بالآلاف. أرقام السهم الواحد مثل EPS قيم عشرية ولا تُضرب.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.