> ## 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.

# Ticker Trend Data

> Retrieve trending data for specific tickers, including rank and change. Returns aggregated trend scores and activity levels across different time intervals.

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "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
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json Response (401 Unauthorized) theme={null}
  {
      "ok": false,
      "errors": [
          {
              "id": "hbiGJjhsSpnfhM8aBePyTB",
              "code": "auth_failed",
              "value": "authentication failed"
          }
      ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml /openapi/ticker-trends-api_api.spec.yml GET /api/v1/trending-tickers
openapi: 3.0.0
info:
  contact: {}
  description: >-
    This REST API provides endpoints to search for trending tickers and get
    ticker details.
  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:
    get:
      tags:
        - Ticker Trends
      summary: Get Ticker Trend Data
      description: >-
        Retrieve trending data for specific tickers, including rank and change.
        Returns aggregated trend scores and activity levels across different
        time intervals.
      operationId: get-ticker-trend-data
      parameters:
        - description: >-
            Time interval for aggregating trend data. Supported values: 10m (10
            minutes), 1h (1 hour), 1d (1 day). Required.
          in: query
          name: interval
          required: true
          schema:
            type: string
        - description: >-
            Comma-separated list of stock ticker symbols (e.g., AAPL,MSFT,TSLA)
            to retrieve trend data for. Required.
          in: query
          name: tickers
          required: true
          schema:
            type: string
        - description: >-
            Data source filter for trend calculation. Supported values: all (all
            sources combined), clickstream (user interaction data), logo (logo
            request data). Required.
          in: query
          name: source
          required: true
          schema:
            type: string
        - description: >-
            Time window for trend analysis. Optional custom timeframe
            specification for filtering results by specific date ranges.
          in: query
          name: timeframe
          schema:
            type: string
        - description: >-
            Page number for pagination. Zero-indexed (0 = first page, 1 = second
            page, etc.). Default: 0
          in: query
          name: page
          schema:
            type: integer
        - description: 'Number of results per page. Default: 1000. Maximum: 1000'
          in: query
          name: pagesize
          schema:
            type: integer
      responses:
        '200':
          description: Trending data with engagement metrics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpapi.tickerTrendAPIResponse'
        '400':
          description: >-
            Bad request - missing or invalid required parameters (interval,
            tickers, or source)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpapi.tickerTrendAPIResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    httpapi.tickerTrendAPIResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/httpapi.tickerTrendData'
          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
    httpapi.tickerTrendData:
      properties:
        exchange:
          example: NASDAQ
          type: string
        metrics:
          items:
            $ref: '#/components/schemas/httpapi.tickerTrendMetrics'
          type: array
        ticker:
          example: AAPL
          type: string
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    httpapi.tickerTrendMetrics:
      properties:
        count:
          example: 1523
          type: integer
        count_mavg:
          example: 1245.67
          type: number
        market_count_average:
          example: 92.1
          type: number
        scaled_count:
          example: 98.5
          type: number
        scaled_count_mavg:
          example: 87.3
          type: number
        time_bucket:
          example: '2024-01-09T10:00:00Z'
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - unsupported_message_type
        - database_query_error
        - 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
      type: string
      x-enum-varnames:
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````