الأشرطة التاريخية

يسترجع بيانات الشموع السعرية التاريخية OHLCV (سعر الافتتاح، الأعلى، الأدنى، الإغلاق، الحجم) للأوراق المالية المحددة. يُرجِع بيانات أسعار مجمَّعة استنادًا إلى الفاصل الزمني المحدَّد. يدعم رموز تداول متعددة ونطاقات زمنية متنوعة بما في ذلك التواريخ النسبية.

GET /api/v2/bars

البيانات التاريخية لأشرطة الأسعار

cURL

curl --request GET \
  --url 'https://api.example.com/api/v2/bars?token='

استجابة (200 OK)

[
  {
    "symbol": "AAPL",
    "interval": 7200,
    "candles": [
      {
        "time": "1765202400000",
        "open": 278.11,
        "high": 279.6693,
        "low": 277.05,
        "close": 277.335,
        "volume": "9174901",
        "dateTime": "2025-12-08T09:00:00.000-05:00"
      },
      {
        "time": "1765209600000",
        "open": 277.335,
        "high": 277.88,
        "low": 276.7,
        "close": 277.33,
        "volume": "6501561",
        "dateTime": "2025-12-08T11:00:00.000-05:00"
      },
      {
        "time": "1765987200000",
        "open": 274.6,
        "high": 275.07,
        "low": 272.28,
        "close": 273.38,
        "volume": "7179965",
        "dateTime": "2025-12-17T11:00:00.000-05:00"
      },
      {
        "time": "1766073600000",
        "open": 272,
        "high": 273.164,
        "low": 269.94,
        "close": 272.4,
        "volume": "8374648",
        "dateTime": "2025-12-18T11:00:00.000-05:00"
      },
      {
        "time": "1766080800000",
        "open": 272.37,
        "high": 272.96,
        "low": 270.5,
        "close": 270.865,
        "volume": "6415588",
        "dateTime": "2025-12-18T13:00:00.000-05:00"
      },
      {
        "time": "1767636000000",
        "open": 267.57,
        "high": 267.89,
        "low": 266.14,
        "close": 266.61,
        "volume": "5846734",
        "dateTime": "2026-01-05T13:00:00.000-05:00"
      }
    ]
  }
]

استجابة (200 OK)

[
  {
    "symbol": "AAPL",
    "interval": 7200,
    "candles": [
      {
        "time": "1765202400000",
        "open": 278.11,
        "high": 279.6693,
        "low": 277.05,
        "close": 277.335,
        "volume": "9174901",
        "dateTime": "2025-12-08T09:00:00.000-05:00"
      },
      {
        "time": "1765209600000",
        "open": 277.335,
        "high": 277.88,
        "low": 276.7,
        "close": 277.33,
        "volume": "6501561",
        "dateTime": "2025-12-08T11:00:00.000-05:00"
      },
      {
        "time": "1765987200000",
        "open": 274.6,
        "high": 275.07,
        "low": 272.28,
        "close": 273.38,
        "volume": "7179965",
        "dateTime": "2025-12-17T11:00:00.000-05:00"
      },
      {
        "time": "1766073600000",
        "open": 272,
        "high": 273.164,
        "low": 269.94,
        "close": 272.4,
        "volume": "8374648",
        "dateTime": "2025-12-18T11:00:00.000-05:00"
      },
      {
        "time": "1766080800000",
        "open": 272.37,
        "high": 272.96,
        "low": 270.5,
        "close": 270.865,
        "volume": "6415588",
        "dateTime": "2025-12-18T13:00:00.000-05:00"
      },
      {
        "time": "1767636000000",
        "open": 267.57,
        "high": 267.89,
        "low": 266.14,
        "close": 266.61,
        "volume": "5846734",
        "dateTime": "2026-01-05T13:00:00.000-05:00"
      }
    ]
  }
]

التفويضات

token · string · query · مطلوب

معلمات الاستعلام

symbols · string · مطلوب

قائمة من رموز تداول الأسهم مفصولة بفواصل (مثل: AAPL,MSFT,TSLA). حقل مطلوب.

from · string · مطلوب

تاريخ/وقت البداية لـ bars. الصيغ المدعومة: YYYY-MM-DD، ‏YYYY-MM-DDTHH:MM:SS، ‏YTD ‏(منذ بداية السنة)، أو قيم نسبية مثل 1MONTH/1m/1M، ‏1WEEK/1w/1W، ‏1DAY/1d/1D. هذا الحقل مطلوب.

to · string

تاريخ/وقت الانتهاء للبيانات الشريطية (bars). التنسيق: YYYY-MM-DD أو YYYY-MM-DDTHH:MM:SS. القيمة الافتراضية هي التاريخ/الوقت الحالي إذا لم يُحدَّد.

interval · string

الفاصل الزمني لتجميع شموع الأسعار. القيم المدعومة: 1m (دقيقة واحدة)، 5m (5 دقائق)، 15m (15 دقيقة)، 30m (30 دقيقة)، 1h (ساعة واحدة)، 1d (يوم واحد)، 1w (أسبوع واحد)، 1M (شهر واحد). القيمة الافتراضية: 1d

session · string

عامل تصفية لجلسة التداول. القيم المدعومة: ANY (جميع الجلسات)، PRE_MARKET (تداول ما قبل الافتتاح)، REGULAR (ساعات التداول العادية)، AFTER_MARKET (تداول ما بعد الإغلاق). القيمة الافتراضية: ANY

الاستجابة

200

application/json

مصفوفة لبيانات المخططات تتضمن أشرطة OHLCV لكل رمز

candles · object[]

إظهار السمات الفرعية

interval · integer

symbol · string