SAHMK

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

WebSocket اللحظي - الصفقات

احصل على بث لحظي للصفقات المنفذة عبر قناة الصفقات. عند الاشتراك باستخدام رموز أسهم محددة، تتلقى أولاً رسالة تأكيد الاشتراك (subscribed)، ثم رسالة تحتوي على أحدث الصفقات (trades_snapshot) لكل سهم تمت إضافته إلى الاشتراك، تليها تحديثات الصفقات اللحظية (trade) فور ورودها.

WS /ws/v1/market/trades/

Pro+

قناة للبث اللحظي للصفقات المنفذة في السوق السعودي.

مسار WebSocket

wss://api.sahmk.sa/ws/v1/market/trades/?api_key=YOUR_API_KEY

يمكنك إضافة symbol=2222 إلى رابط الاتصال للاشتراك تلقائياً في تحديثات السهم عند إنشاء الاتصال.

رسالة تأكيد الاتصال

json
{
  "type": "connected",
  "channel": "trades",
  "plan": "pro",
  "delivery_profile": "standard",
  "limits": {
    "max_symbols_per_connection": 60,
    "max_symbols_per_call": 20,
    "snapshot_limit_max": 200
  },
  "message": "Connected to SAHMK real-time trades stream",
  "timestamp": "2026-07-28T09:31:58.197050+00:00"
}

أوامر الاشتراك والتحكم

json
{"action":"subscribe","symbols":["2222","1120"]}
{"action":"unsubscribe","symbols":["1120"]}
{"action":"snapshot","symbol":"2222","limit":50}
{"action":"ping"}
{"action":"subscribe","symbols":["*"]}

الأمر الأخير، الخاص بالاشتراك في جميع الأسهم، متاح لباقة Enterprise فقط.

عند طلب أحدث الصفقات باستخدام snapshot، يكون العدد الافتراضي 50 صفقة، والحد الأقصى 200 صفقة.

رسالة أحدث الصفقات (trades_snapshot)

رسالة WebSocketJSON
{
  "type": "trades_snapshot",
  "symbol": "2222",
  "updated_at": "2026-07-28T09:31:55+00:00",
  "count": 2,
  "events": [
    {
      "trade_seq": 204505,
      "event_time": "2026-07-28T09:31:55+00:00",
      "price": 26.3,
      "quantity": 40,
      "value": 1052.0,
      "side": "buy"
    },
    {
      "trade_seq": 204490,
      "event_time": "2026-07-28T09:31:47+00:00",
      "price": 26.3,
      "quantity": 5000,
      "value": 131500.0,
      "side": "sell"
    }
  ],
  "summary": {
    "event_count": 2,
    "trade_quantity": 5040,
    "trade_value": 132552.0,
    "latest_event_time": "2026-07-28T09:31:55+00:00"
  },
  "timestamp": "2026-07-28T09:31:58.300000+00:00"
}

رسالة الصفقة اللحظية (trade)

رسالة WebSocketJSON
{
  "type": "trade",
  "symbol": "2222",
  "trade_seq": 204520,
  "event_time": "2026-07-28T09:31:58+00:00",
  "price": 26.32,
  "quantity": 10,
  "value": 263.2,
  "side": "buy",
  "market_session": "REGULAR",
  "timestamp": "2026-07-28T09:31:58.774829+00:00"
}

الرقم التسلسلي للصفقة (trade_seq)

  • يُستخدم رمز السهم وتاريخ تنفيذ الصفقة المستخرج من event_time بتوقيت الرياض، إلى جانب الرقم التسلسلي trade_seq، لتحديد كل صفقة بشكل فريد.
  • قد يتكرر الرقم التسلسلي في جلسة تداول لاحقة.

أدلة ذات صلة

استخدام قناة الصفقات مع تطبيق WebSocket جاهز للاستخدام الفعلي.

آخر تحديث في

→ السابقالأسهم
التالي ←عمق السوق