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

الصفقات

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

GET /market/trades/{symbol}/

Pro+

احصل على أحدث الصفقات المنفذة لسهم واحد، مرتبة من الأحدث إلى الأقدم.

مسار API

https://api.sahmk.sa/api/v1/market/trades/2222/?limit=1

المعاملات

(*) مطلوب

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

رمز السهم

limitinteger

الافتراضي: 50، والحد الأقصى: 200

200 OKapplication/json
{
  "symbol": "2222",
  "updated_at": "2026-08-12T12:19:10+00:00",
  "count": 1,
  "events": [
    {
      "trade_seq": 204505,
      "event_time": "2026-08-12T12:19:10+00:00",
      "price": 26.6,
      "quantity": 20,
      "value": 532.0,
      "side": "buy"
    }
  ],
  "summary": {
    "event_count": 1,
    "trade_quantity": 20,
    "trade_value": 532.0,
    "latest_event_time": "2026-08-12T12:19:10+00:00"
  }
}
عرض الأخطاء الخاصة بهذا المسار
json
{
  "error": {
    "code": "INVALID_SYMBOL",
    "message": "Stock symbol '9999' not found."
  }
}

{
  "error": {
    "code": "INVALID_LIMIT",
    "message": "limit must be a valid integer."
  }
}

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

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

آخر تحديث في