Equity Rank Projection API

openapi: 3.2.0
info:
  title: Equity Rank Com Projection API
  version: 0.1.0
  description: 'Operations tagged projection across 2 of this provider''s published API definitions: openapi.json, equity-rank-com-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Projection
paths:
  /api/projection/{ticker}:
    get:
      tags:
      - Projection
      summary: Get Projected Fair Value Range
      description: 'Return bear/base/bull projected fair value model scenarios for a ticker.


        - horizon: 1, 3, or 5 years only. Any other value returns 400.

        - Missing financial data returns data_complete=false with partial info.

        - Never returns 500 on legitimate data gaps.


        Model scenarios only. Not a price forecast or investment advice.'
      operationId: get_projected_fair_value_range_api_projection__ticker__get
      security:
      - HTTPBearer: []
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
          description: US equity ticker, e.g. NVDA
          title: Ticker
        description: US equity ticker, e.g. NVDA
      - name: horizon
        in: query
        required: false
        schema:
          type: integer
          maximum: 5
          minimum: 1
          description: 'Model horizon in years. Accepted values: 1, 3, 5.'
          default: 3
          title: Horizon
        description: 'Model horizon in years. Accepted values: 1, 3, 5.'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectionResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ProjectionResult:
      properties:
        ticker:
          type: string
          title: Ticker
        horizon_years:
          type: integer
          title: Horizon Years
        data_complete:
          type: boolean
          title: Data Complete
        bear:
          anyOf:
          - $ref: '#/components/schemas/ProjectionScenario'
          - type: 'null'
        base:
          anyOf:
          - $ref: '#/components/schemas/ProjectionScenario'
          - type: 'null'
        bull:
          anyOf:
          - $ref: '#/components/schemas/ProjectionScenario'
          - type: 'null'
        projected_fair_value_range_low:
          anyOf:
          - type: number
          - type: 'null'
          title: Projected Fair Value Range Low
        projected_fair_value_range_high:
          anyOf:
          - type: number
          - type: 'null'
          title: Projected Fair Value Range High
        method_notes:
          items:
            type: string
          type: array
          title: Method Notes
          default: []
        disclaimer:
          type: string
          title: Disclaimer
          default: 'Projected Fair Value Range — Model Scenarios Only


            This section presents algorithmic model scenarios — not price targets, price forecasts, or investment recommendations. Scenarios are generated by applying Equity Rank''s valuation models to projected future fundamentals under bear, base, and bull growth assumptions. Inputs include analyst consensus EPS growth estimates and are disclosed for each scenario. Actual market prices are determined by factors that no model can fully capture and may differ materially from these estimates. All financial models contain assumptions that may be incorrect. This output is for informational and educational purposes only. Equity Rank is not a registered investment adviser. Consult a licensed financial advisor before making any investment decision.'
      type: object
      required:
      - ticker
      - horizon_years
      - data_complete
      title: ProjectionResult
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProjectionScenario:
      properties:
        label:
          type: string
          title: Label
        projected_fair_value:
          type: number
          title: Projected Fair Value
        assumed_growth_rate:
          type: number
          title: Assumed Growth Rate
        model_fair_value_differential_pct:
          anyOf:
          - type: number
          - type: 'null'
          title: Model Fair Value Differential Pct
        assumptions_note:
          type: string
          title: Assumptions Note
      type: object
      required:
      - label
      - projected_fair_value
      - assumed_growth_rate
      - assumptions_note
      title: ProjectionScenario
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- openapi.json
- equity-rank-com-openapi.yml