بيانات قائمة اتجاهات رموز التداول

استرجِع قائمة برموز الأسهم الرائجة استنادًا إلى مقاييس مختلفة. تُعيد أوراقًا مالية مرتبة حسب درجة الرواج عبر فترات زمنية مختلفة.

GET /api/v1/trending-tickers/list

جلب قائمة رموز الأسهم الرائجة

cURL

curl --request GET \
  --url 'https://api.example.com/api/v1/trending-tickers/list?token='

استجابة (200 OK)

{
  "ok": true,
  "data": [
    {
      "security": {
        "ticker": "RVLV",
        "name": "Revolve Gr",
        "exchange": "NYSE"
      },
      "count": 2344,
      "pct_chg": 23340
    }
  ]
}

استجابة (200 OK)

{
  "ok": true,
  "data": [
    {
      "security": {
        "ticker": "RVLV",
        "name": "Revolve Gr",
        "exchange": "NYSE"
      },
      "count": 2344,
      "pct_chg": 23340
    }
  ]
}

استجابة (400 طلب غير صالح)

{
    "ok": false,
    "errors": [
        {
            "id": "hbiGJjhsSpnfhM8aBePyTB",
            "code": "400",
            "value": "Bad Request"
        }
    ]
}

استجابة (500 خطأ داخلي في الخادم)

{
    "ok": false,
    "errors": [
        {
            "id": "hbiGJjhsSpnfhM8aBePyTB",
            "code": "500",
            "value": "Something went wrong"
        }
    ]
}

التفويضات

token · string · query · مطلوب

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

interval · string · مطلوب

مهمل. استخدم timeframe بدلاً منه. فترة زمنية لتجميع بيانات الاتجاه.

tickers · string

قائمة اختيارية من رموز التداول مفصولة بفواصل لتصفية النتائج. إذا لم تُحدَّد، يتم إرجاع جميع رموز الأسهم الرائجة.

source · string · مطلوب

عامل تصفية مصدر البيانات لحساب الاتجاه. القيم المدعومة: all (جميع المصادر مجتمعة)، clickstream (بيانات تفاعلات المستخدمين)، logo (بيانات طلبات الشعار). مطلوب.

timeframe · string

الفترة الزمنية لتجميع الاتجاه. القيم المدعومة: ‎10m‎ (10 دقائق)، ‎1h‎ (ساعة واحدة)، ‎1d‎ (يوم واحد). القيمة الافتراضية: ‎1d‎

time_from · string

عامل تصفية وقت البدء بتنسيق 24 ساعة (مثلًا: 09:15، 14:30). استخدمه مع date_from لتحديد نطاقات زمنية دقيقة.

time_to · string

عامل تصفية لوقت الانتهاء بتنسيق 24 ساعة (مثل 16:00، 22:30). استخدمه مع date_to لتحديد نطاقات زمنية دقيقة.

date_from · string

عامل تصفية لتاريخ البدء بتنسيق ISO 8601 (مثل 2024-12-30، 2024-01-15). استخدمه مع time_from لتحديد نطاقات زمنية دقيقة.

date_to · string

مرشح تاريخ الانتهاء بتنسيق ISO 8601 (مثل 2024-12-30، 2024-01-31). استخدمه مع time_to لتحديد نطاقات زمنية دقيقة.

page · integer

رقم الصفحة لأغراض التجزئة (pagination). يبدأ العد من الصفر (0 = الصفحة الأولى، 1 = الصفحة الثانية، إلخ). القيمة الافتراضية: 0

pagesize · integer

عدد النتائج في كل صفحة. القيمة الافتراضية: 1000. الحد الأقصى: 1000

الاستجابة

200

application/json

قائمة مرتَّبة لأكثر رموز الأسهم رواجًا مع درجات التفاعل

data · object[]

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

ok · boolean

مثال:

true