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

البيانات المالية

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

GET /financials/{symbol}/

Starter+

نقطة النهاية

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

المعاملات

(*) مطلوب

المعاملالنوعمثال
symbol *string1120
type stringall
period stringquarterly
history stringlatest
metrics stringextended
result stringseries
limit integer4 (max 20)

type: القيم المتاحة income وbalance وcashflow وall. period: القيم المتاحة annual وquarterly وauto. history: القيم المتاحة 1y و3y و5y و10y وmax. metrics: القيم المتاحة core وextended. result: القيم المتاحة series وlatest. العلامات الاختيارية: limit: الافتراضي 4 (والحد الأقصى 20). include_future_placeholders=1, include_partial=1.

ملاحظات السلوك

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

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

  • Starter: قوائم سنوية؛ اطلب period=annual صراحةً. تدعم خيارات السجل حتى 3 سنوات، ويحافظ الطلب دون خيارات على الاستجابة الموسعة القديمة ذات الصفوف الأربعة.
  • 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
    }
  ],
  "reporting": {
    "reporting_cadence": "quarterly",
    "quarterly_income_convention": "mixed"
  }
}

آخر تحديث في