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

استردّ بيانات الاتجاهات الشائعة لرموز أسهم محددة، بما في ذلك الترتيب والتغيّر. تُرجع هذه العملية درجات اتجاه مجمَّعة ومستويات النشاط عبر فترات زمنية مختلفة.

GET /api/v1/trending-tickers

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

cURL

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

استجابة (200 OK)

{
  "ok": true,
  "data": [
    {
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "metrics": [
        {
          "time_bucket": "2025-12-30T11:00:00Z",
          "count": 36,
          "count_mavg": 738,
          "scaled_count": 0.008905160240828991,
          "scaled_count_mavg": 0.18255577981472015,
          "market_count_average": 0.8544670939445496
        }
      ]
    }
  ]
}

استجابة (200 OK)

{
  "ok": true,
  "data": [
    {
      "ticker": "AAPL",
      "exchange": "NASDAQ",
      "metrics": [
        {
          "time_bucket": "2025-12-30T11:00:00Z",
          "count": 36,
          "count_mavg": 738,
          "scaled_count": 0.008905160240828991,
          "scaled_count_mavg": 0.18255577981472015,
          "market_count_average": 0.8544670939445496
        }
      ]
    }
  ]
}

استجابة (401 Unauthorized)

{
    "ok": false,
    "errors": [
        {
            "id": "hbiGJjhsSpnfhM8aBePyTB",
            "code": "auth_failed",
            "value": "authentication failed"
        }
    ]
}

التفويضات

token · string · query · مطلوب

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

interval · string · مطلوب

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

tickers · string · مطلوب

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

source · string · مطلوب

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

timeframe · string

نطاق زمني لتحليل الاتجاهات. يمكن تحديد إطار زمني مخصص اختياريًا لتصفية النتائج حسب نطاقات تاريخية محددة.

page · integer

رقم الصفحة لأغراض ترقيم الصفحات (pagination). يبدأ الفهرس من الصفر (0 = الصفحة الأولى، 1 = الصفحة الثانية، وهكذا). القيمة الافتراضية: 0

pagesize · integer

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

الاستجابة

200

application/json

بيانات الرواج مع مقاييس التفاعل

data · object[]

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

ok · boolean

مثال:

true