القسم الحالي: الأسهم

الأسهم

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

GET /quote/{symbol}/

Free

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

مسار API

https://api.sahmk.sa/api/v1/quote/2222/?identifier=أرامكو

المعاملات

(*) مطلوب

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

رمز السهم

identifierstring

اسم الشركة أو أحد أسمائها البديلة

data_modestring
realtimedelayed

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

استخدم رمز السهم عند تشابه الأسماء أو تعذّر تحديد الشركة المطلوبة بدقة.

توفر البيانات حسب الباقة:

  • Free / Starter: أسعار متأخرة بنحو 15 دقيقة.
  • Pro وما فوق: أسعار لحظية.
200 OKapplication/json
{
  "symbol": "2222",
  "name": "أرامكو السعودية",
  "name_en": "Saudi Arabian Oil Co",
  "price": 26.6,
  "change": 0.0,
  "change_percent": 0.0,
  "open": 26.6,
  "high": 26.68,
  "low": 26.52,
  "previous_close": 26.6,
  "volume": 6601208,
  "value": 175637052.96,
  "trade_count": 8330,
  "bid": 26.6,
  "bid_size": 9181,
  "ask": 26.62,
  "ask_size": 38155,
  "liquidity": {
    "inflow_value": 99498351.21,
    "inflow_volume": 3739041,
    "inflow_trades": 4858,
    "outflow_value": 76138701.51,
    "outflow_volume": 2862167,
    "outflow_trades": 3472,
    "net_value": 23359649.699999988
  },
  "auction": {
    "phase": "opening",
    "price": 26.58,
    "price_updated_at": "2026-10-07T06:31:01+00:00",
    "volume": 11646,
    "volume_updated_at": "2026-10-07T06:31:01+00:00",
    "symbol_state": null,
    "symbol_session": "pre-open"
  },
  "updated_at": "2026-08-12T12:20:00+00:00",
  "is_delayed": false,
  "resolved_instrument": {
    "input": "أرامكو",
    "symbol": "2222",
    "name": "أرامكو",
    "match_type": "alias_exact",
    "confidence": "high"
  }
}

السعر الاسترشادي خلال المزاد

  • يتوفر حقل auction في استجابة سعر السهم الواحد، وطلب أسعار عدة أسهم، وقناة الأسهم عبر WebSocket.
  • تكون قيمة الحقل null خارج فترتي مزاد الافتتاح والإغلاق، وكذلك عند استخدام باقة توفر بيانات متأخرة.
  • يبقى price سعر آخر صفقة رسمية، ويظل updated_at وقت تلك الصفقة، دون أن تتغير قيمتهما نتيجة تحديثات المزاد.
  • يشير auction.phase إلى نوع المزاد: opening لمزاد الافتتاح وclosing لمزاد الإغلاق.
عرض تفاصيل خطأ عدم توفر بيانات الأسعار مؤقتاً
json
{
  "error": {
    "code": "PRICE_DATA_TEMPORARILY_UNAVAILABLE",
    "message": "Price data for '2222' is temporarily unavailable. Please retry shortly."
  }
}

GET /quotes/

Starter+

احصل على أسعار وبيانات التداول لعدة أسهم من خلال طلب واحد. تتوفر هذه الخدمة ضمن باقة Starter وما فوق.

للباقة المجانية: يمكنك استخدام GET /quote/{symbol}/ لطلب بيانات سهم واحد في كل مرة.

مسار API

https://api.sahmk.sa/api/v1/quotes/?symbols=2222,1120

المعاملات

(*) مطلوب

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

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

identifiersstring

أسماء الشركات مفصولة بفواصل

data_modestring
realtimedelayed

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

استخدم أحد المعاملين symbols أو identifiers فقط، وليس كليهما.

200 OKapplication/json
{
  "quotes": [
    {
      "symbol": "2222",
      "name": "أرامكو السعودية",
      "name_en": "Saudi Arabian Oil Co",
      "price": 26.6,
      "change": 0.0,
      "change_percent": 0.0,
      "open": 26.6,
      "high": 26.68,
      "low": 26.52,
      "previous_close": 26.6,
      "volume": 6601208,
      "value": 175637052.96,
      "trade_count": 8330,
      "bid": 26.6,
      "ask": 26.62,
      "bid_size": 9181,
      "ask_size": 38155,
      "liquidity": {
        "inflow_value": 99498351.21,
        "inflow_volume": 3739041,
        "inflow_trades": 4858,
        "outflow_value": 76138701.51,
        "outflow_volume": 2862167,
        "outflow_trades": 3472,
        "net_value": 23359649.699999988
      },
      "net_liquidity": 23359649.699999988,
      "auction": {
        "phase": "opening",
        "price": 26.58,
        "price_updated_at": "2026-10-07T06:31:01+00:00",
        "volume": 11646,
        "volume_updated_at": "2026-10-07T06:31:01+00:00",
        "symbol_state": null,
        "symbol_session": "pre-open"
      },
      "updated_at": "2026-09-23T01:03:00+03:00",
      "is_delayed": false
    },
    {
      "symbol": "1120",
      "name": "مصرف الراجحي",
      "name_en": "Al Rajhi Banking & Investment Corp SJSC",
      "price": 64.05,
      "change": -0.05,
      "change_percent": -0.08,
      "open": 64.1,
      "high": 64.3,
      "low": 63.7,
      "previous_close": 64.1,
      "volume": 3775688,
      "value": 241832816.4,
      "trade_count": 4120,
      "bid": 63.95,
      "ask": 64.05,
      "bid_size": 15,
      "ask_size": 43300,
      "liquidity": {
        "inflow_value": 80000000,
        "inflow_volume": 1250000,
        "inflow_trades": 1800,
        "outflow_value": 127806410.94999999,
        "outflow_volume": 2525688,
        "outflow_trades": 2320,
        "net_value": -47806410.94999999
      },
      "net_liquidity": -47806410.94999999,
      "auction": null,
      "updated_at": "2026-09-23T01:03:00+03:00",
      "is_delayed": false
    }
  ],
  "count": 2,
  "max_symbols": 50,
  "requested_count": 2
}

حدود طلب الأسعار المتعددة

يمكن طلب بيانات ما يصل إلى 50 سهماً في الطلب الواحد. إذا تجاوز العدد هذا الحد، فستتم معالجة أول 50 سهماً فقط، وستتضمن الاستجابة الحقل truncated: true ورسالة تحذيرية في الحقل warning .

التعرّف على الشركات من أسمائها ورموزها

عند استخدام المعامل identifiers ، تتضمن الاستجابة أيضاً كائن resolution الذي يوضح عدد الشركات المطلوبة requested_count، وعدد الشركات التي تم التعرّف عليها resolved_count، والأسماء الملتبسة ambiguous، والأسماء التي لم يتم العثور عليها not_found.

هل تحتاج إلى رموز الأسهم؟ استخدم GET /companies/

ملاحظات سريعة: استخدم معاملات المسار عند طلب بيانات مورد واحد، مثل /quote/{symbol}/، ومعاملات الاستعلام لتصفية النتائج، مثل /events/?symbol=2222&limit=20. وللتعرف على أخطاء HTTP وAPI الشائعة، راجع قسم رموز الأخطاء.

آخر تحديث في