جميع واجهات API

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

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

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

الطلب الأول

احصل على البيانات المالية للشركة

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "net_income": "133749000000",
      "total_assets": "758376000000",
      "operating_cash_flow": "182935000000",
      "eps_diluted": "17.95"
    }
  ]
}

نقاط النهاية

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.

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

  • fyحقل

    السنة المالية المرتبطة بفترة التقرير

  • fqحقل

    الربع المالي، عند الاقتضاء

  • fhحقل

    النصف السنوي المالي، عند الاقتضاء

  • endحقل

    تاريخ نهاية فترة التقرير

  • derivedحقل

    يشير إلى الأرقام المحسوبة من القيم المُبلَّغ عنها

  • currencyحقل

    عملة الإفصاح، دون تحويل

المرجع الكامل ‏←
GETاحصل على البيانات المالية كما وردت في إفصاح/v1/filings/{filing_id}/financials/as-reported

الأرقام كما أبلغ عنها إفصاح واحد تمامًا، قبل التوحيد.

المعلمات

  • filing_idمطلوب

    معرّف إفصاح، مثل usa:0000320193:0000320193-25-000079.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

التغطية

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

المصادر

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

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

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

استكشف API ‏←

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

الأصول والالتزامات وحقوق الملكية وبنود الميزانية العمومية المشتقة

استكشف API ‏←

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

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

استكشف API ‏←

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

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

استكشف API ‏←

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

هل البنود القياسية الـ 77 كلها متاحة في كل حساب؟

جميع البنود القياسية وعددها 77 متاحة في كل حساب. تحذف الاستجابة أي بند مفقود من الإفصاح.

ماذا تعني الأرقام المُبلَّغ عنها أول مرة والاستعلامات بتاريخ محدد؟

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

هل يمكن لسلسلة واحدة أن تجمع بين القوائم الموحدة والمنفردة؟

لا. تستخدم Narwhal الأرقام الموحدة عند توفرها، ولا تخلط أبداً بين الأرقام الموحدة والمنفردة داخل سلسلة واحدة. البنود المشتقة موسومة.

السجل التاريخي الكامل

كل سنة ينشرها السجل، سنوية وربع سنوية، وتُسلَّم مباشرة.

أول إفصاح

الأرقام كما قُدمت أول مرة، قبل إعادة التصنيف والتعديل.

بتاريخ محدد

الأرقام المعروفة في تاريخ سابق.