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

السوق

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

GET /market/summary/?index=TASI

Free

احصل على قيمة مؤشر السوق وحجم التداول واتجاه السوق العام.

مسار API

https://api.sahmk.sa/api/v1/market/summary/?index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "timestamp": "2026-08-12T12:20:00+00:00",
  "index_value": 10844.12,
  "index_change": 10.94,
  "index_change_percent": 0.1,
  "total_volume": 256387075,
  "advancing": 141,
  "declining": 112,
  "unchanged": 17,
  "market_mood": "Bullish"
}

GET /market/gainers/?limit=1&index=TASI

Free

احصل على قائمة الأسهم الأكثر ارتفاعاً، مرتبة حسب نسبة الارتفاع.

مسار API

https://api.sahmk.sa/api/v1/market/gainers/?limit=1&index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

limitnumber

عدد النتائج المطلوبة. الافتراضي 10، والحد الأقصى 50

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "gainers": [
    {
      "symbol": "6040",
      "name": "شركة تبوك للتنمية الزراعية",
      "name_en": "Tabuk Agriculture Development C",
      "price": 9.13,
      "change": 0.83,
      "change_percent": 10.0,
      "volume": 4846179,
      "updated_at": "2026-08-12T13:00:00+00:00"
    }
  ],
  "count": 1
}

GET /market/losers/?limit=1&index=TASI

Free

احصل على قائمة الأسهم الأكثر انخفاضاً، مرتبة حسب نسبة الانخفاض.

مسار API

https://api.sahmk.sa/api/v1/market/losers/?limit=1&index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

limitnumber

عدد النتائج المطلوبة. الافتراضي 10، والحد الأقصى 50

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "losers": [
    {
      "symbol": "4011",
      "name": "شركة لازوردي للمجوهرات",
      "name_en": "L'azurde Company for Jewelry SJSC",
      "price": 10.43,
      "change": -0.47,
      "change_percent": -4.31,
      "volume": 369026,
      "updated_at": "2026-08-12T13:00:00+00:00"
    }
  ],
  "count": 1
}

GET /market/volume/?limit=1&index=TASI

Free

احصل على قائمة الأسهم الأكثر تداولاً من حيث حجم التداول (عدد الأسهم المتداولة).

مسار API

https://api.sahmk.sa/api/v1/market/volume/?limit=1&index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

limitnumber

عدد النتائج المطلوبة. الافتراضي 10، والحد الأقصى 50

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "stocks": [
    {
      "symbol": "6015",
      "name": "شركة أمريكانا للمطاعم العالمية بي إل سي - شركة أجنبية",
      "name_en": "AMERICANA",
      "price": 2.38,
      "change": 0.07,
      "change_percent": 3.03,
      "volume": 22562421,
      "updated_at": "2026-08-12T13:00:00+00:00"
    }
  ],
  "count": 1
}

GET /market/value/?limit=1&index=TASI

Free

احصل على قائمة الأسهم الأعلى من حيث قيمة التداول بالريال السعودي.

مسار API

https://api.sahmk.sa/api/v1/market/value/?limit=1&index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

limitnumber

عدد النتائج المطلوبة. الافتراضي 10، والحد الأقصى 50

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "stocks": [
    {
      "symbol": "2380",
      "name": "شركة رابغ للتكرير والبتروكيماويات",
      "name_en": "Rabigh Refining and Petrochemic",
      "price": 17.6,
      "change": 0.51,
      "change_percent": 2.98,
      "volume": 14502060,
      "value": 257478357.3,
      "updated_at": "2026-08-12T13:00:00+00:00"
    }
  ],
  "count": 1
}

GET /market/sectors/?index=TASI

Free

احصل على بيانات أداء قطاعات السوق وإحصاءاتها، بما في ذلك نسب التغير وأحجام التداول.

مسار API

https://api.sahmk.sa/api/v1/market/sectors/?index=TASI

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
indexstring
TASINOMU

الافتراضي: TASI

data_modestring
realtimedelayed

عند عدم تحديد القيمة، يُستخدم الوضع الافتراضي للباقة

200 OKapplication/json
{
  "index": "TASI",
  "is_delayed": false,
  "sectors": [
    {
      "sector_name": "Insurance",
      "sector_name_ar": "التأمين",
      "change_percent": 1.49,
      "avg_change_percent": 0.02,
      "volume": 9819397,
      "num_stocks": 26
    }
  ],
  "count": 20
}
عرض الأخطاء الخاصة بهذا المسار (عند إدخال مؤشر غير صالح)
json
{
  "error": {
    "code": "INVALID_INDEX",
    "message": "Invalid index 'XYZ'. Supported values: TASI, NOMU."
  }
}

آخر تحديث في