القسم الحالي: القوائم المالية

القوائم المالية

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

GET /financials/{symbol}/

Starter+

مسار API

https://api.sahmk.sa/api/v1/financials/1120/?period=annual&history=1y&metrics=extended

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
* symbolstring

رمز السهم

typestring
incomebalancecashflowall

الافتراضي: all

periodstring
annualquarterlyauto

الافتراضي: annual

historystring
1y3y5y10ymax
metricsstring
coreextended
resultstring
serieslatest

الافتراضي: series

limitinteger

الافتراضي: 4، والحد الأقصى: 20

include_partialstring
01

الافتراضي: 0

include_future_placeholdersstring
01

الافتراضي: 0

ملاحظات حول آلية عمل الخدمة

  • عند استخدام period=auto، يُحدد نوع الفترة تلقائياً. إذا كانت أحدث سنة مالية متاحة مكتملة، تُستخدم القوائم السنوية (annual)، وإلا فتُستخدم القوائم ربع السنوية (quarterly).
  • يجب على مشتركي Starter تحديد period=annual صراحةً. وإذا أدت القيمة auto إلى اختيار القوائم ربع السنوية، فستُرجع الواجهة الخطأ 403 PLAN_LIMIT.
  • تعرض البيانات السنوية السنوات المالية المكتملة افتراضياً. ولتضمين بيانات السنة المالية الحالية غير المكتملة، استخدم include_partial=1، بما يشمل البيانات المتراكمة منذ بداية السنة عند توفرها.
  • عند اختيار quarterly، تُعرض أحدث الفترات ربع السنوية المتاحة افتراضياً.
  • عند استخدام result=latest، تُعرض أحدث فترة وفقاً لنوع القوائم المحدد أو المختار تلقائياً. وفي الوضع السنوي، تُعرض أحدث سنة مالية مكتملة، ما لم يُستخدم include_partial=1.
  • تبقى القيمة الافتراضية للمعامل period هي annual، حفاظاً على التوافق مع عمليات التكامل الحالية.
  • تُعاد القوائم المالية ضمن مصفوفات منفصلة، مثل income_statements لقوائم الدخل، وbalance_sheets لقوائم المركز المالي، وcash_flows لقوائم التدفقات النقدية.
  • تتضمن الاستجابة أيضاً رمز السهم (symbol)، ونوع الفترة المالية (statement_period)، ومعلومات توضح طبيعة البيانات (semantics)، بالإضافة إلى معلومات عن دورية التقارير المالية المنشورة وطريقة عرضها ضمن reporting.

البيانات المتاحة حسب الباقة:

  • Starter: القوائم المالية السنوية، مع ضرورة تحديد period=annual صراحةً. تتيح خيارات السجل التاريخي الوصول إلى بيانات تصل إلى 3 سنوات. وعند إرسال الطلب دون تحديد خيارات إضافية، تظل الاستجابة السابقة الموسعة المكونة من 4 سجلات متاحة للتوافق مع عمليات التكامل الحالية.
  • Pro/Business: القوائم المالية ربع السنوية، والبيانات المالية الموسعة، والفترات التاريخية 5y و10y وmax، مع إمكانية الوصول إلى جميع البيانات المتاحة ضمن الخدمة.
  • Enterprise: إمكانيات وصلاحيات مخصصة للوصول إلى البيانات المالية وفقاً للاتفاقية.

مثال على الاستجابة

200 OKapplication/json
{
  "symbol": "1120",
  "statement_period": "annual",
  "income_statements": [
    {
      "report_date": "2025-12-31",
      "statement_period": "annual",
      "fiscal_year": 2025,
      "quarters_reported": 4,
      "quarters_covered": 4,
      "is_full_year": true,
      "total_revenue": 39093965000.0,
      "gross_profit": 6730335.0,
      "operating_income": null,
      "net_income": 24791754000.0
    }
  ],
  "balance_sheets": [
    {
      "report_date": "2025-12-31",
      "statement_period": "annual",
      "fiscal_year": 2025,
      "quarters_reported": 4,
      "quarters_covered": 4,
      "is_full_year": true,
      "total_assets": 1043268297000.0,
      "total_liabilities": 900355952000.0,
      "stockholders_equity": 142912345000.0,
      "total_debt": null
    }
  ],
  "cash_flows": [
    {
      "report_date": "2025-12-31",
      "statement_period": "annual",
      "fiscal_year": 2025,
      "quarters_reported": 4,
      "quarters_covered": 4,
      "is_full_year": true,
      "operating_cash_flow": -22373072000.0,
      "investing_cash_flow": -1564467000.0,
      "financing_cash_flow": 36302349000.0,
      "free_cash_flow": null
    }
  ],
  "semantics": {
    "income": "annual_full_year",
    "cashflow": "annual_full_year",
    "balance": "year_end_snapshot"
  },
  "reporting": {
    "reporting_cadence": "quarterly",
    "quarterly_income_convention": "mixed"
  }
}

آخر تحديث في