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

# Get historical results for a date



## OpenAPI

````yaml /api-reference/openapi.json get /premade-strategies/{strategyId}/historical-data
openapi: 3.0.0
info:
  title: Noonum API
  version: 1.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create, read, update, and delete your own investment strategies, browse
    public premade strategies, run semantic search, and call supporting utility
    endpoints.
servers:
  - url: https://api.noonum.ai/v1
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and delete your own investment strategies.
  - name: PremadeStrategies
    description: Read public premade strategies and find the ones closest to an objective.
  - name: Helper
    description: >-
      Supporting endpoints for company lookup, objective editing, and health
      checks.
  - name: Benchmarks
    description: Read benchmark data.
  - name: Portfolios
    description: Create, read, update, and delete your portfolios.
  - name: Backtest
    description: Backtest a portfolio without saving it.
paths:
  /premade-strategies/{strategyId}/historical-data:
    parameters:
      - name: strategyId
        in: path
        required: true
        schema:
          type: string
        description: UUID of the user strategy
    get:
      tags:
        - PremadeStrategies
      summary: Get historical results for a date
      operationId: app.api.v1.premade_strategies.get_historical_data
      parameters:
        - name: date
          in: query
          required: true
          schema:
            type: string
            format: date
            example: '2024-01-31'
          description: Date to retrieve data for.
        - name: includeReasoning
          in: query
          required: false
          description: When true, include the reasoning text for each company.
          schema:
            type: boolean
            default: false
        - name: scoringMinMarketCap
          in: query
          required: false
          description: >-
            Minimum market cap (USD) for conviction score calculation. Companies
            below this threshold receive a convictionScore of 0.
          schema:
            type: number
            default: 500000000
      responses:
        '200':
          description: Companies in the strategy as of the requested date.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: A company produced by a strategy run.
                  properties:
                    id:
                      type: string
                      format: uuid
                      example: b544d95b-43a6-4a50-a326-90552b05c551
                    symbol:
                      type: string
                      example: TSLA
                    name:
                      type: string
                      example: Tesla, Inc.
                    isin:
                      type: string
                      example: US88160R1014
                      nullable: true
                    figi:
                      type: string
                      example: BBG000N9MNX3
                      nullable: true
                      description: >-
                        Bloomberg Financial Instrument Global Identifier (FIGI)
                        for the listing.
                    exchange:
                      type: string
                      example: NASDAQ
                    market:
                      type: string
                      example: us
                      nullable: true
                    mic:
                      type: string
                      example: XNAS
                      nullable: true
                      description: >-
                        ISO 10383 operating market identifier code for the
                        listing exchange.
                    sector:
                      type: string
                      example: Consumer Cyclical
                      nullable: true
                    industry:
                      type: string
                      example: Auto - Manufacturers
                      nullable: true
                    marketCap:
                      type: number
                      example: 902298200000
                      nullable: true
                    volAvg:
                      type: number
                      format: float
                      example: 1250000
                      nullable: true
                    linguisticBeta:
                      type: number
                      format: float
                      example: 0.12002
                    marketBuzz:
                      type: number
                      format: float
                      example: 0.406
                    reasoning:
                      type: string
                      nullable: true
                      description: >-
                        Why the company was included. Present only when
                        `includeReasoning` is `true`.
                    convictionScore:
                      type: number
                      format: float
                      example: 0.75
                      nullable: true
                      description: >-
                        Conviction score between 0 and 1 that combines market
                        buzz and linguistic beta. A higher score indicates a
                        stronger thematic signal on both dimensions.
                    active:
                      type: boolean
                      example: true
                      description: Whether the company is currently active.
                  required:
                    - id
                    - symbol
                    - name
                    - isin
                    - exchange
                    - market
                    - sector
                    - industry
                    - marketCap
                    - volAvg
                    - linguisticBeta
                    - marketBuzz
                    - active
        '404':
          description: No data exists for this strategy on the given date.
        '409':
          description: >-
            The data is not ready yet because generation is still running or has
            failed.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````