القسم الحالي: التحليلات

التحليلات

قارن النسب والمؤشرات المالية للشركات المدرجة وحلّلها باستخدام خدمات API المخصصة للتحليل المالي والمقارنات.

GET /analytics/ratios/{symbol}/

Starter+

احصل على النسب والمؤشرات المالية لسهم معين.

مسار API

https://api.sahmk.sa/api/v1/analytics/ratios/1120/?history=latest&period=quarterly&metrics=extended

المعاملات

(*) مطلوب

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

رمز السهم

historystring
latest3y5y10ymax

الافتراضي: latest

periodstring
annualquarterly

الافتراضي: annual

metricsstring
coreextended

الافتراضي: core

metastring
minimalextended

الافتراضي: minimal

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

  • Free: لا تتوفر خدمة التحليلات المالية.
  • Starter: أحدث النسب المالية السنوية فقط، باستخدام history=latest وperiod=annual وmetrics=core.
  • Pro/Business: جميع خيارات النسب المالية، بما في ذلك الفترات التاريخية (history)، والقوائم السنوية وربع السنوية (period)، والمؤشرات الأساسية والموسعة (metrics).
  • Enterprise: إمكانيات تحليل مالي وصلاحيات وصول مخصصة وفقاً للاتفاقية.
200 OKapplication/json
{
  "symbol": "1120",
  "ratios": [
    {
      "report_date": "2026-06-30",
      "statement_period": "quarterly",
      "fiscal_year": 2026,
      "fiscal_quarter": 2,
      "ratios": {
        "roe": 4.6,
        "roa": 0.66,
        "net_margin": 64.42,
        "revenue_growth_yoy": 13.35,
        "net_income_growth_yoy": 14.0,
        "asset_turnover": 0.0103
      },
      "key_metrics": {
        "total_revenue": 10884480000.0,
        "net_income": 7012137000.0,
        "operating_cash_flow": 10379536000.0,
        "total_assets": 1054772497000.0,
        "stockholders_equity": 152416762000.0
      }
    }
  ],
  "meta": {
    "period": "quarterly",
    "metrics": "extended",
    "warnings": [
      "Some metrics unavailable"
    ]
  }
}

GET /analytics/compare/

Starter+

قارن النسب والمؤشرات المالية لعدة شركات باستخدام أحدث البيانات المتاحة لكل شركة.

مسار API

https://api.sahmk.sa/api/v1/analytics/compare/?symbols=1120&metrics=extended

المعاملات

(*) مطلوب

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

رموز الأسهم مفصولة بفواصل

metricsstring
coreextended

الافتراضي: core

metastring
minimalextended

الافتراضي: minimal

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

  • Starter: مقارنة ما يصل إلى 3 شركات باستخدام المؤشرات المالية الأساسية (core) فقط.
  • Pro: مقارنة ما يصل إلى 10 شركات باستخدام المؤشرات المالية الأساسية (core) أو الموسعة (extended).
  • Business: مقارنة ما يصل إلى 20 شركة باستخدام المؤشرات المالية الأساسية (core) أو الموسعة (extended).
  • Enterprise: حدود مخصصة لعدد الشركات وإمكانيات المقارنة وفقاً للاتفاقية.
200 OKapplication/json
{
  "results": [
    {
      "symbol": "1120",
      "company_name": "مصرف الراجحي",
      "sector_name": "Banks",
      "sector_name_ar": "البنوك",
      "market_id": "TASI",
      "market_cap": 384600000000.0,
      "current_price": 64.05,
      "ratios": {
        "roe": 9.48,
        "roa": 1.37,
        "net_margin": 67.49,
        "asset_turnover": 0.0203
      },
      "key_metrics": {
        "total_revenue": 21412480000.0,
        "net_income": 14452137000.0,
        "total_assets": 1054772497000.0,
        "stockholders_equity": 152416762000.0
      }
    }
  ],
  "count": 1,
  "meta": {
    "period": "annual",
    "metrics": "extended",
    "warnings": [
      "Some metrics unavailable"
    ]
  }
}

إرشادات التكامل

تتضمن البيانات الوصفية الافتراضية الحقول الأساسية فقط: meta.period وmeta.metrics وmeta.warnings.

للحصول على معلومات إضافية، استخدم meta=extended. وتشمل هذه المعلومات:

  • بيانات النسب المالية: coverage وperiods_available وquality وpartial_context.
  • نتائج المقارنة: coverage لكل شركة.

تختلف الحقول المتاحة داخل كائن ratios بحسب البيانات والمؤشرات المتوفرة، لذلك يُفضّل أن يتعامل التطبيق مع هذه الحقول بشكل ديناميكي بدلاً من الاعتماد على قائمة ثابتة منها.

آخر تحديث في