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

الصفقات

احصل على أحدث صفقات رمز معين. راجع WebSocket اللحظي للتحديثات المتدفقة.

GET /market/trades/{symbol}/

Pro+

اجلب أحدث صفقات رمز واحد، مرتبة من الأحدث.

نقطة النهاية

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

المعاملات

(*) مطلوب

المعاملالنوعمثال
symbol *string2222
limit integer5

limit القيمة الافتراضية 50 (الحد الأقصى 200). تُرتب النتائج من الأحدث.

200 OKapplication/json
{
  "symbol": "2222",
  "updated_at": "2026-08-12T12:19:10+00:00",
  "count": 1,
  "events": [
    {
      "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."
  }
}

آخر تحديث في