القسم الحالي: البيانات التاريخية والفواصل اللحظية

البيانات التاريخية والفواصل اللحظية

احصل على بيانات الأسعار التاريخية والفواصل اللحظية (OHLCV)، التي تشمل أسعار الافتتاح والأعلى والأدنى والإغلاق وحجم التداول، عبر فواصل زمنية بالدقائق أو على أساس يومي وأسبوعي وشهري، لاستخدامها في التحليل الفني واختبار استراتيجيات التداول باستخدام البيانات التاريخية.

GET /historical/{symbol}/

Starter+

احصل على بيانات الأسعار التاريخية والفواصل اللحظية للسهم، بما في ذلك أسعار الافتتاح والأعلى والأدنى والإغلاق وحجم التداول (OHLCV).

مسار API

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

المعاملات

(*) مطلوب

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

رمز السهم أو TASI أو NOMU

fromstring

تاريخ البداية بصيغة YYYY-MM-DD

الافتراضي: قبل نحو 30 يوماً

tostring

تاريخ النهاية بصيغة YYYY-MM-DD

الافتراضي: اليوم

intervalstring
1min5min15min30min60min1d1w1mo

الفاصل الزمني الافتراضي: 1d. تُدعم أيضاً القيم السابقة 30m بوصفها بديلاً لـ30min، و60m بوصفها بديلاً لـ60min، و1m بوصفها بديلاً لـ1mo. ويشير 1m إلى شهر واحد، وليس دقيقة واحدة.

limitinteger

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

offsetinteger

الافتراضي: 0. عدد الشموع التي يتم تجاوزها من بداية النتائج المرتبة زمنياً من الأقدم إلى الأحدث.

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

  • Free: لا تتوفر بيانات الأسعار التاريخية.
  • Starter: الفواصل اليومية (1d) والأسبوعية (1w) والشهرية (1mo).
  • Pro: جميع فواصل Starter، بالإضافة إلى فواصل 15 و30 و60 دقيقة، ببيانات تمتد حتى 90 يوماً تقويمياً لكل فاصل.
  • Business: جميع فواصل Pro، بالإضافة إلى فاصل 5 دقائق ببيانات تمتد حتى 90 يوماً تقويمياً. كما تتوفر بيانات تاريخية ممتدة لفواصل 15 و30 دقيقة حتى 6 أشهر تقويمية، ولفاصل 60 دقيقة حتى سنة تقويمية واحدة.
  • Enterprise: فواصل زمنية مخصصة، بما في ذلك فاصل الدقيقة الواحدة (1min) عند تفعيله، مع تحديد عمق البيانات التاريخية وفقاً للاتفاقية.

إذا طلبت فاصلاً زمنياً مدعوماً لكنه غير متاح ضمن باقتك، أو حددت نطاقاً زمنياً يتجاوز الحد المسموح به، فستُرجع الواجهة الخطأ 403 PLAN_LIMIT.أما عند إدخال قيمة غير مدعومة للفاصل الزمني، فستُرجع الخطأ 400.قد تختلف بداية توفر البيانات من سهم إلى آخر، وقد تكون الفترة التاريخية المتاحة أقصر من الحد الأقصى المسموح به في الباقة.تُحدَّث الشموع على الفواصل اللحظية خلال جلسات التداول بشكل لحظي، بينما تحدد حدود التغطية التاريخية المدة التي يمكنك استرجاع بياناتها.

هل ترغب في التعرف على كيفية استخدام الفواصل اللحظية عملياً؟ راجع دليل استخدام الفواصل اللحظية مع سهمك (SDK + MCP).

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

صيغة بيانات الشموع السعرية

الفواصل اللحظية (1min، 5min، 15min، 30min، 60min):

تتضمن كل شمعة طابعاً زمنياً بصيغة ISO في الحقل date، بالإضافة إلى الحقول turnover وtrade_count وis_final وpartial.

في فاصلَي 30min و60min، يتوفر الحقل number_of_trades مؤقتاً بوصفه اسماً بديلاً للحقل trade_count، ويحمل القيمة نفسها.

الفواصل اليومية والأسبوعية والشهرية (1d، 1w، 1mo):

يحتوي الحقل date على التاريخ فقط، دون الوقت، وتتضمن البيانات الحقل turnover. ويتوفر الحقل trade_count عند توفر عدد الصفقات في بيانات نهاية اليوم.

بالنسبة للفواصل الأسبوعية والشهرية، يُحسب trade_count بجمع أعداد الصفقات اليومية المتاحة خلال الأسبوع وفق معيار ISO، أو خلال الشهر الميلادي.

التوافق مع القيم السابقة:

تظل القيم 30m و60m و1m مدعومة بوصفها بدائل لـ30min و60min و1mo على التوالي. ويشير 1m إلى الفاصل الشهري، وليس فاصل الدقيقة الواحدة.

سعر الإغلاق المعدّل:

تتطابق قيمة adjusted_close مع close في السجلات اللاحقة لشهر مارس 2024، وكذلك في بيانات الفواصل اللحظية.

الانتقال بين صفحات النتائج:

عندما تكون قيمة has_more هي true، يمكنك طلب الصفحة التالية بزيادة offset بمقدار limit.

آخر تحديث في