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

التحليلات

قارن نسب الشركات وحللها باستخدام نقاط نهاية تحليلية موجزة.

GET /analytics/ratios/{symbol}/

Starter+

النسب المالية لرمز واحد.

نقطة النهاية

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

المعاملات

(*) مطلوب

المعاملالنوعمثال
symbol *string1120
history string5y
period stringquarterly
metrics stringextended
meta stringextended

history: القيم latest و3y و5y و10y وmax (الافتراضي latest). period: القيم annual وquarterly (الافتراضي annual). metrics: القيم core وextended (الافتراضي core). meta: القيمة minimal افتراضياً أو extended.

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

  • Free: لا يتوفر وصول إلى التحليلات
  • Starter: أحدث بيانات + annual + 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+

قارن لقطات النسب بين عدة رموز.

نقطة النهاية

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

المعاملات

(*) مطلوب

المعاملالنوعمثال
symbols *string1120,1180,1010,2222
metrics stringextended
meta stringextended

symbols مطلوب كقيم مفصولة بفواصل (مثال 1120,1180,1010). metrics: القيمة core أو extended (الافتراضي core). meta: القيمة minimal افتراضياً أو extended.

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

  • 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).
  • مفاتيح النسب ديناميكية، لذا اعرض كائنات النسب ديناميكياً.

آخر تحديث في