> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datos de la lista de tendencias de tickers

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "ok": true,
    "data": [
      {
        "security": {
          "ticker": "RVLV",
          "name": "Revolve Gr",
          "exchange": "NYSE"
        },
        "count": 2344,
        "pct_chg": 23340
      }
    ]
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json Response (400 Bad Request) theme={null}
  {
      "ok": false,
      "errors": [
          {
              "id": "hbiGJjhsSpnfhM8aBePyTB",
              "code": "400",
              "value": "Bad Request"
          }
      ]
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json Response (500 Internal Server Error) theme={null}
  {
      "ok": false,
      "errors": [
          {
              "id": "hbiGJjhsSpnfhM8aBePyTB",
              "code": "500",
              "value": "Something went wrong"
          }
      ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml es/openapi/ticker-trends-api.spec.yml GET /api/v1/trending-tickers/list
openapi: 3.0.0
info:
  contact: {}
  description: >-
    توفر واجهة برمجة التطبيقات REST نقاط نهاية للبحث عن رموز الأسهم الرائجة
    والحصول على تفاصيل رمز التداول.
  termsOfService: http://swagger.io/terms/
  title: TickerTrends API
  version: 2.1.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v1/trending-tickers/list:
    get:
      tags:
        - Ticker Trends
      summary: جلب قائمة رموز الأسهم الرائجة
      description: >-
        استرجِع قائمة برموز الأسهم الرائجة استنادًا إلى مقاييس مختلفة. تُعيد
        أوراقًا مالية مرتبة حسب درجة الرواج عبر فترات زمنية مختلفة.
      operationId: get-ticker-trend-list-data
      parameters:
        - description: مهمل. استخدم timeframe بدلاً منه. فترة زمنية لتجميع بيانات الاتجاه.
          in: query
          name: interval
          required: true
          schema:
            type: string
        - description: >-
            قائمة اختيارية من رموز التداول مفصولة بفواصل لتصفية النتائج. إذا لم
            تُحدَّد، يتم إرجاع جميع رموز الأسهم الرائجة.
          in: query
          name: tickers
          schema:
            type: string
        - description: |-
            عامل تصفية مصدر البيانات لحساب الاتجاه. القيم المدعومة:
            all (جميع المصادر مجتمعة)،
            clickstream (بيانات تفاعلات المستخدمين)،
            logo (بيانات طلبات الشعار).
            مطلوب.
          in: query
          name: source
          required: true
          schema:
            type: string
        - description: >-
            الفترة الزمنية لتجميع الاتجاه. القيم المدعومة: ‎10m‎ (10 دقائق)،
            ‎1h‎ (ساعة واحدة)، ‎1d‎ (يوم واحد). القيمة الافتراضية: ‎1d‎
          in: query
          name: timeframe
          schema:
            type: string
        - description: >-
            عامل تصفية وقت البدء بتنسيق 24 ساعة (مثلًا: 09:15، 14:30). استخدمه
            مع date_from لتحديد نطاقات زمنية دقيقة.
          in: query
          name: time_from
          schema:
            type: string
        - description: >-
            عامل تصفية لوقت الانتهاء بتنسيق 24 ساعة (مثل 16:00، 22:30). استخدمه
            مع date_to لتحديد نطاقات زمنية دقيقة.
          in: query
          name: time_to
          schema:
            type: string
        - description: >-
            عامل تصفية لتاريخ البدء بتنسيق ISO 8601 (مثل 2024-12-30،
            2024-01-15). استخدمه مع time_from لتحديد نطاقات زمنية دقيقة.
          in: query
          name: date_from
          schema:
            type: string
        - description: >-
            مرشح تاريخ الانتهاء بتنسيق ISO 8601 (مثل 2024-12-30، 2024-01-31).
            استخدمه مع time_to لتحديد نطاقات زمنية دقيقة.
          in: query
          name: date_to
          schema:
            type: string
        - description: >-
            رقم الصفحة لأغراض التجزئة (pagination). يبدأ العد من الصفر (0 =
            الصفحة الأولى، 1 = الصفحة الثانية، إلخ). القيمة الافتراضية: 0
          in: query
          name: page
          schema:
            type: integer
        - description: 'عدد النتائج في كل صفحة. القيمة الافتراضية: 1000. الحد الأقصى: 1000'
          in: query
          name: pagesize
          schema:
            type: integer
      responses:
        '200':
          description: قائمة مرتَّبة لأكثر رموز الأسهم رواجًا مع درجات التفاعل
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.TrendingTickersListAPIResponse'
        '400':
          description: >-
            طلب غير صالح - معامل source مفقود أو غير صالح، أو تنسيق
            التاريخ/الوقت غير صالح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.TrendingTickersListAPIResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    models.TrendingTickersListAPIResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/models.TrendingTickersListData'
          type: array
        ok:
          example: true
          type: boolean
      type: object
    bzhttp.Resp:
      properties:
        data:
          additionalProperties: true
          type: object
        errors:
          items:
            $ref: '#/components/schemas/bzhttp.Error'
          type: array
        ok:
          type: boolean
      type: object
    models.TrendingTickersListData:
      properties:
        count:
          example: 1523
          type: integer
        pct_chg:
          example: 15
          type: integer
        security:
          $ref: '#/components/schemas/models.Security'
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    models.Security:
      properties:
        exchange:
          example: NASDAQ
          type: string
        name:
          example: Apple Inc
          type: string
        ticker:
          example: AAPL
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - json_unmarshaling_error
        - no_data_found
        - no_matching_endpoint
        - bad_request
        - db_error
        - internal_server_error
        - auth_failed
        - forbidden
        - failed_dependency
        - service_unavailable
        - upstream_api_error
        - unsupported_message_type
        - database_query_error
      type: string
      x-enum-varnames:
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````