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

# Get latest analytics for a list of symbols

> Returns analytics for any 1 to 12 symbols: per-symbol returns, risk, signals and fundamentals, plus analytics for the symbols as one list, such as market regime, breadth and sector mix. Nothing is saved. The server caches results for up to 10 minutes, or 1 minute when some symbols or data sources failed.

Operation ID: get__symbols_analytics.



## OpenAPI

````yaml /openapi/itoflow-public.openapi.json get /symbols/analytics
openapi: 3.1.0
info:
  description: >-
    All Itoflow APIs are experimental and may change without notice. Read-only
    operations marked interactive can be tried from the documentation; the
    others are reference-only.
  title: Itoflow Developer API
  version: 1.0.0
servers:
  - description: Itoflow API
    url: https://api.itoflow.ai
security: []
tags:
  - name: Account
  - name: Billing
  - name: Brokers
  - name: Chat
  - name: Connected MCP servers
  - name: GitHub
  - name: Market data
  - name: Monitors
  - name: Notifications
  - name: Portfolios
  - name: Risk runs
  - name: Sharing and data
  - name: Strategies
paths:
  /symbols/analytics:
    get:
      tags:
        - Market data
      summary: Get latest analytics for a list of symbols
      description: >-
        Returns analytics for any 1 to 12 symbols: per-symbol returns, risk,
        signals and fundamentals, plus analytics for the symbols as one list,
        such as market regime, breadth and sector mix. Nothing is saved. The
        server caches results for up to 10 minutes, or 1 minute when some
        symbols or data sources failed.


        Operation ID: get__symbols_analytics.
      operationId: get__symbols_analytics
      parameters:
        - description: >-
            Comma-separated symbols, 1 to 12, such as AAPL.US,MSFT.US. A ticker
            without an exchange means its US listing.
          in: query
          name: symbols
          required: true
          schema:
            description: >-
              Comma-separated symbols, 1 to 12, such as AAPL.US,MSFT.US. A
              ticker without an exchange means its US listing.
            example: AAPL.US,MSFT.US
            minLength: 1
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SymbolAnalyticsLatestResponse'
          description: Latest symbol analytics
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not 1 to 12 symbols
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Authentication required
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: None of the symbols had price data
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Analytics could not be computed; retry later
      security:
        - bearerAuth: []
components:
  schemas:
    SymbolAnalyticsLatestResponse:
      properties:
        as_of:
          description: Date of the latest close used, as YYYY-MM-DD.
          type: string
        cache:
          properties:
            hit:
              type: boolean
            ttl_seconds:
              type: number
          required:
            - hit
            - ttl_seconds
          type: object
        computed_at:
          description: When the snapshot was computed, in ISO 8601.
          type: string
        mode:
          enum:
            - latest
          type: string
        schema_version:
          enum:
            - 1
          type: number
        snapshot:
          $ref: '#/components/schemas/SymbolAnalyticsSnapshot'
      required:
        - as_of
        - computed_at
        - mode
        - schema_version
        - snapshot
      type: object
    Error:
      properties:
        available:
          description: Optional available amount or value
          type: string
        billing_action:
          $ref: '#/components/schemas/BillingAction'
        code:
          description: Machine-readable error code
          type: string
        currentVersion:
          description: Current server-side version, when relevant
          type: number
        details:
          description: Optional structured error details
        error:
          description: Error type or code
          type: string
        expectedVersion:
          description: Client-provided expected version, when relevant
          type: number
        message:
          description: Human-readable error message
          type: string
        requested:
          description: Optional requested amount or value
          type: string
        usage:
          description: Optional usage metadata for limit errors
      required:
        - error
      type: object
    SymbolAnalyticsSnapshot:
      properties:
        as_of:
          description: Date of the latest close used, as YYYY-MM-DD.
          type: string
        benchmark:
          description: Symbol used for beta and relative performance.
          type: string
        computed_for_symbols:
          description: The requested symbols that had price data.
          items:
            type: string
          type: array
        data_receipt:
          additionalProperties: {}
          description: Which inputs were fetched and which failed.
          type: object
        schema_version:
          type: integer
        symbols:
          additionalProperties:
            $ref: '#/components/schemas/SymbolAnalyticsSymbol'
          type: object
        watchlist:
          additionalProperties: {}
          description: >-
            Analytics for the symbols as one list: equal-weight index against
            the benchmark, sector breakdown, market regime, correlation and
            highlights.
          type: object
      required:
        - schema_version
        - as_of
        - computed_for_symbols
        - benchmark
        - symbols
        - watchlist
        - data_receipt
      type: object
    BillingAction:
      description: Action that resolves a billing-related rejection
      properties:
        href:
          type: string
        kind:
          enum:
            - upgrade
            - payment_method
            - spending_cap
            - billing
          type: string
        label:
          type: string
      required:
        - href
        - label
        - kind
      type: object
    SymbolAnalyticsSymbol:
      additionalProperties: {}
      description: >-
        Analytics for one symbol: returns, volatility, beta, 52-week range,
        signal z-scores, fundamentals, valuation, analyst and sector
        percentiles. A figure that cannot be computed is left out or null, never
        zero.
      properties:
        error:
          description: >-
            Why this symbol has no analytics, such as no_price_data. Absent when
            it has them.
          type:
            - string
            - 'null'
        last_close:
          type: number
        symbol:
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Itoflow access token issued for the Itoflow API.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.