جميع واجهات API

API الميزانية العمومية للمركز المالي للشركة

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

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

الطلب الأول

احصل على الميزانية العمومية

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=balance" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "cash": "20935000000",
      "total_assets": "758376000000",
      "total_liabilities": "315989000000",
      "total_equity": "442387000000"
    }
  ]
}

نقاط النهاية

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.

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

  • cashحقل

    النقد والاستثمارات قصيرة الأجل القابلة للتحويل بسهولة إلى نقد؛ وبالنسبة إلى البنوك: النقد والمبالغ المستحقة من البنوك الأخرى.

  • short_term_investmentsحقل

    الاستثمارات قصيرة الأجل والأوراق المالية القابلة للتداول.

  • long_term_investmentsحقل

    الاستثمارات المعروضة ضمن الأصول طويلة الأجل في الميزانية العمومية.

  • receivablesحقل

    المبالغ المستحقة على العملاء وغيرهم والمصنفة أصولاً متداولة.

  • inventoryحقل

    البضائع المحتفظ بها للبيع، والأعمال قيد التنفيذ، والمواد أو المستلزمات المستخدمة في الإنتاج.

  • total_current_assetsحقل

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

  • working_capitalحقل

    يُحسب بطرح الخصوم المتداولة من الأصول المتداولة؛ ويُعلَّم على أنه قيمة مشتقة.

  • ppe_netحقل

    الأصول الملموسة المستخدمة في النشاط، بعد خصم الإهلاك المتراكم وخسائر انخفاض القيمة.

  • goodwillحقل

    الأصل المعترف به عندما تتجاوز تكلفة الاستحواذ على نشاط تجاري القيمة العادلة لصافي أصوله القابلة للتحديد.

  • intangiblesحقل

    الأصول غير المادية المعترف بها في الميزانية العمومية، باستثناء الشهرة.

  • total_assetsحقل

    إجمالي القيمة الدفترية للأصول المعترف بها في الميزانية العمومية.

  • total_current_liabilitiesحقل

    الالتزامات المصنفة متداولة، وتُسدَّد عادةً خلال دورة التشغيل أو خلال سنة واحدة.

  • accounts_payableحقل

    المبالغ المستحقة للموردين وغيرهم والمصنفة التزامات متداولة.

  • deferred_revenueحقل

    الإيرادات المؤجلة والتزامات العقود.

  • short_term_debtحقل

    الاقتراضات المستحقة خلال سنة، شاملة الجزء المتداول من الدين طويل الأجل.

  • long_term_debtحقل

    الاقتراضات المستحقة بعد أكثر من سنة، دون الجزء المتداول.

  • lease_liabilitiesحقل

    الالتزامات الناشئة عن عقود الإيجار، وتُستثنى من إجمالي الدين.

  • total_debtحقل

    القروض قصيرة الأجل وطويلة الأجل معًا، دون التزامات الإيجار.

  • net_debtحقل

    يُحسب بطرح النقد من إجمالي الدين، دون التزامات الإيجار؛ ويُعلَّم على أنه قيمة مشتقة.

  • total_liabilitiesحقل

    إجمالي القيمة الدفترية للالتزامات المعترف بها في الميزانية العمومية.

  • retained_earningsحقل

    الأرباح المتراكمة المحتجزة بعد التوزيعات، أو الخسائر المتراكمة.

  • equity_parentحقل

    حصص الملكية العائدة إلى مالكي الشركة الأم.

  • noncontrolling_interestحقل

    حصة الملكية في الشركات التابعة العائدة إلى مالكين غير الشركة الأم.

  • temporary_equityحقل

    الحصص غير المسيطرة القابلة للاسترداد والأسهم الممتازة القابلة للاسترداد، وتُعرض بين الخصوم وحقوق الملكية.

  • total_equityحقل

    إجمالي حصص الملكية في الشركة، شاملًا الحصص غير المسيطرة.

  • total_liabilities_and_equityحقل

    المجموع الكلي للخصوم وحقوق الملكية المعروض في الميزانية العمومية.

  • depositsحقل

    المبالغ التي أودعها العملاء لدى بنك.

  • loansحقل

    قروض البنوك وسلفها للعملاء، صافية من مخصصات خسائر الائتمان.

المرجع الكامل ‏←

حالات الاستخدام

حمّل بيانات الشركات لسنوات

تصفح سجلًا تاريخيًا طويلًا واستأنف إذا توقفت المهمة.

اقرأ الدليل ‏←

التحديث وفق جدول زمني

اجلب الإفصاحات والأرقام الجديدة كل يوم بسكربت صغير.

اقرأ الدليل ‏←

ابقَ ضمن حدودك

خزّن الردود مؤقتًا وتعامل مع أخطاء 429 دون فقدان أي طلب.

اقرأ الدليل ‏←

اسأل وكيلًا ذكيًا عن شركة

امنح وكيل LLM صلاحية قراءة الإفصاحات والبيانات المالية عبر MCP.

اقرأ الدليل ‏←

التغطية

  • الولايات المتحدةالإفصاحات والقوائم المالية. السجل التاريخي منذ 2009.
  • اليابانأكثر من 3,800 شركة، سنوي ونصف سنوي.
  • كوريانحو نصف الشركات المدرجة حتى الآن.
  • تايواننحو 1,980 شركة. تقارير النصف الأول من 2026.
  • الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبيةنحو 3,200 شركة في 26 دولة، سنوي فقط.
  • المملكة المتحدةنحو 800 شركة في الأسواق المنظمة، سنوي فقط.

المصادر

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

API قائمة الدخل لأرباح الشركة

الإيرادات والتكاليف والأرباح من إفصاحات الشركات

استكشف API ‏←

بيانات التدفق النقدي لحركة نقد الشركات

التدفقات النقدية التشغيلية والاستثمارية والتمويلية مع تدفقات خارجة ذات إشارة

استكشف API ‏←

EPS API لأرباح السهم وتوزيعاته

الأرباح وتوزيعات الأرباح وأعداد الأسهم للفئة العادية الرئيسية

استكشف API ‏←

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

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

استكشف API ‏←

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

هل يشمل إجمالي الدين التزامات الإيجار؟

تُستثنى التزامات الإيجار من إجمالي الدين ومن حساب صافي الدين.

ماذا يحدث عند غياب بند من الميزانية العمومية؟

يُترك البند غير المُبلَّغ عنه خارج الاستجابة. ويبقى الصفر المُبلَّغ عنه صراحة في الإفصاح صفراً.

بأي عملة تأتي مبالغ الميزانية العمومية؟

يحتفظ كل مبلغ بعملة الإفصاح كنص عشري. لا تحوّله Narwhal ولا تقسمه إلى ملايين.

رأس المال العامل

تُحسب بطرح الالتزامات المتداولة من الأصول المتداولة، وتُوسم بأنها مشتقة.

صافي الدين

تُحسب بطرح النقد من إجمالي الدين، دون عقود الإيجار.

التزامات الإيجار

يُبلَّغ عنه بشكل منفصل ويُستثنى من إجمالي الدين.