القسم الحالي: البيانات التاريخية

البيانات التاريخية

استخدم بيانات OHLCV التاريخية — الافتتاح والأعلى والأدنى والإغلاق والحجم — للتحليل الفني والاختبارات التاريخية.

GET /historical/{symbol}/

Starter+

احصل على بيانات الأسعار التاريخية لسهم.

نقطة النهاية

https://api.sahmk.sa/api/v1/historical/2222/?interval=1d&from=2024-01-01&to=2026-01-01&limit=1&offset=0

المعاملات

(*) مطلوب

المعاملالنوعمثال
symbol *string2222, TASI, or NOMU
from string2024-01-01
to string2026-01-01
interval string1d
limit integer1
offset integer0

symbol: يقبل رمز سهم أو رمز المؤشر TASI أو NOMU. from: القيمة الافتراضية قبل نحو 30 يوماً. to: القيمة الافتراضية هي اليوم. interval: 1d, 1w, 1m, 30m, 60m (الافتراضي 1d). limit: الافتراضي 500 والحد الأقصى 2000. offset: الافتراضي 0.

البيانات المتاحة حسب الباقة:

  • Free: لا تتوفر بيانات تاريخية
  • Starter: 1d, 1w, 1m
  • Pro: فترات Starter بالإضافة إلى 60m حتى 90 يوماً
  • Business: فترات Starter بالإضافة إلى 30m حتى 6 أشهر، بالإضافة إلى 60m حتى سنة واحدة
  • Enterprise: يتوفر افتراضياً ما تتيحه باقة Business، ويمكن الاتفاق على مدد احتفاظ وفترات وخيارات تسليم مخصصة

إذا تجاوزت الفترة أو النطاق الزمني المطلوب حدود باقتك، فستعيد API الخطأ 403 PLAN_LIMIT.

هل تحتاج إلى سير عمل عملي لبيانات اليوم الواحد؟ راجع بيانات اليوم الواحد مع سهمك (SDK + MCP).

200 OKapplication/json
{
  "symbol": "2222",
  "interval": "1d",
  "source": "historical_eod",
  "is_intraday": false,
  "is_final": true,
  "partial": false,
  "latest_bar_at": "2024-01-01",
  "from": "2024-01-01",
  "to": "2026-01-01",
  "limit": 1,
  "offset": 0,
  "total": 500,
  "count": 1,
  "has_more": true,
  "data": [
    {
      "date": "2024-01-01",
      "open": 33.0,
      "high": 33.15,
      "low": 32.9,
      "close": 33.05,
      "volume": 12123324,
      "adjusted_close": 33.05,
      "trade_count": null
    }
  ]
}

صيغة صف الشمعة

  • 30m/60m تستخدم الصفوف طابعاً زمنياً بصيغة ISO في date وتتضمن is_final, partial، و trade_count. number_of_trades اسم بديل مؤقت لنفس القيمة.
  • 1d/1w/1m تستخدم الصفوف تاريخاً في date وتتضمن trade_count عندما تتوفر أعداد صفقات الإغلاق.
  • Weekly and monthly trade_count هي مجموع أعداد الصفقات اليومية المتاحة في الأسبوع وفق ISO أو في الشهر الميلادي.
  • adjusted_close يطابق close للسجلات اللاحقة لمارس 2024 ولسجلات اليوم الواحد.
  • ما دام has_more يساوي true، فاطلب الصفحة التالية باستخدام offset + limit.

آخر تحديث في