جميع واجهات API

API القوائم المالية للشركات وكبار المساهمين

احصل على إفصاحات الشركات والقوائم المالية الموحدة وحاملي 5% أو أكثر عبر Narwhal، بمفتاح API واحد لـ REST وMCP.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
جارٍ التحقق97.84% uptime, last 30 أيام295 ms زمن الاستجابة المعتاد

الطلب الأول

ابحث عن شركة

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?q=microsoft" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "results": [
    {
      "id": "usa:0000789019",
      "name": "Microsoft Corp",
      "country": "USA",
      "registry": "usa",
      "status": "active",
      "exchange": "XNAS",
      "code": "MSFT",
      "matched": "name"
    }
  ]
}

نقاط النهاية

GETسرد الشركات/v1/companies

ابحث عن الشركات بالاسم واحصل على معرّفاتها. استخدم المعرّف في كل الطلبات الأخرى.

المعلمات

  • qاختياري

    نص البحث، مثل اسم شركة.

حقول الاستجابة

  • listings (on a company)حقل

    معرّفات إدراج الأسهم المرتبطة بالشركة، مثل XNAS:MSFT، لاستخدامها مع مسارات الأسهم. يُربط الإدراج بمطابقة تامة للبورصة والرمز النشط اليوم، وليس بالاسم أبدًا. القائمة الفارغة تعني عدم وجود إدراج.

المرجع الكامل ‏←
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.
  • اليابانأكثر من 3,800 شركة، سنوي ونصف سنوي.
  • كوريانحو نصف الشركات المدرجة حتى الآن.
  • تايواننحو 1,980 شركة. تقارير النصف الأول من 2026.
  • الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةنحو 3,200 شركة في 26 دولة، سنوي فقط.
  • المملكة المتحدةنحو 800 شركة في الأسواق المنظمة، سنوي فقط.

المصادر

واجهات API ذات صلة

تحليل القوائم المالية للشركات عبر API

القوائم الموحدة وفترات التقرير والإصدارات التاريخية

استكشف API ‏←

API إفصاحات الشركات للقوائم والسجلات

قوائم الإفصاحات والسجلات الفردية وأحدث الإفصاحات عبر الشركات

استكشف API ‏←

API كبار المساهمين في الشركات

حاملو 5% أو أكثر من إفصاحات الملكية

استكشف API ‏←

الأسئلة الشائعة

هل يمكنني استخدام رمز السهم بدل معرّف الشركة؟

نعم. استخدم معرّفاً مثل usa:0000789019 أو اسماً مستعاراً مقبولاً للرمز مثل usa:MSFT.

هل يمكنني تلقي إشعارات عند نشر إفصاح؟

يمكن لكل حساب إعداد webhooks تُخطرك عند نشر إفصاح.

هل تُحوَّل المبالغ المالية أو يُعاد تدريجها؟

المبالغ نصوص عشرية بعملة الإفصاح نفسها، دون تحويل أو تقسيم إلى ملايين. تُحذف البنود المفقودة، وتبقى الأصفار المُبلَّغ عنها أصفاراً.

كيف أنتقل من الشركة إلى إدراج سهمها؟

للشركة قائمة بمعرّفات إدراج أسهمها. استخدم أيًّا منها مع مسارات الأسهم للحصول على الأسعار والسجل التاريخي وتوزيعات الأرباح وتجزئة الأسهم والتقييم. يحمل إدراج السهم معرّف الشركة، فيمكنك الانتقال في الاتجاهين.

سجلات الإفصاح

اقرأ تواريخ الإفصاحات وأنواعها وعناوينها، مع روابط إلى النسخ الرسمية.

البيانات المالية الموحدة

استخدم 77 بنداً قياسياً عبر قوائم الدخل والميزانيات العمومية والتدفق النقدي والسهم الواحد والأسهم.

كبار الحاملين

احصل على حاملي 5% أو أكثر في الولايات المتحدة واليابان وكوريا.