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

# Stock research

> Read company financials, valuation, guidance, prices, screening results and macro data from FinancialDatasets.

Choose an action and its period or mode. Each request creates one Run; missing values remain `null`. Financial ratios are fractions, while macro rates are percentages. Read `result_status` and `charge_usd` separately. Use `describe_filters: true` with `action: screen` to discover supported filters before screening. Provider-native output remains on the Run.


## OpenAPI

````yaml /openapi.json post /v1/solutions/finance/stock_research
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    One key, no contract, pay per call, across paid APIs bought wholesale. Every
    response carries x-request-id; every error body carries the same envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/finance/stock_research:
    post:
      tags:
        - Solutions
      summary: Stock research
      description: >-
        Read company facts, financial statements, segments, current or
        historical financial metrics, earnings, guidance, prices, news, screener
        matches and macro data through FinancialDatasets. Each request maps to
        one Endpoint and one Run. Missing fields remain null; currency,
        reporting periods and source dates remain separate. Ratios are
        fractions; macro rates are percentages. Unsupported fields and requests
        exceeding max_charge_usd fail before a Run. A signed authenticated
        result_url reads the same Runs without another Charge. Provider-native
        output remains on GET /v1/runs/:id.
      operationId: finance-stock-research
      parameters:
        - name: idempotency-key
          in: header
          schema:
            type: string
            minLength: 1
            description: >-
              Generate a new unique value (prefer a random UUID) for each
              independent lookup, even with identical parameters on the same
              day. Retry the same intended execution with its original key and
              parameters to retrieve the original Run without another Charge.
              Changing execution parameters with the same key returns 409;
              changing task_id or metadata does not start a new Run. Existing
              opaque keys remain valid for recovery.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                action:
                  type: string
                  enum:
                    - company
                    - income
                    - balance_sheet
                    - cash_flow
                    - segments
                    - metrics
                    - earnings
                    - guidance
                    - prices
                    - news
                    - screen
                    - macro
                provider:
                  anyOf:
                    - type: string
                      enum:
                        - auto
                        - financialdatasets
                      description: >-
                        Default auto: select the first eligible Provider in
                        Glasser's preference order. A named Provider must
                        support the request and be allowed by your Key; it does
                        not fall back to another Provider. Available values are
                        listed below.
                    - type: 'null'
                ticker:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^[A-Za-z0-9.-]{1,12}$
                    - type: 'null'
                cik:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{1,10}$
                    - type: 'null'
                period:
                  anyOf:
                    - type: string
                      enum:
                        - annual
                        - quarterly
                        - ttm
                    - type: 'null'
                mode:
                  anyOf:
                    - type: string
                      enum:
                        - snapshot
                        - history
                    - type: 'null'
                  description: >-
                    metrics/prices/macro only; defaults to snapshot. History
                    requires the action-specific period or date inputs.
                statement:
                  anyOf:
                    - type: string
                      enum:
                        - all
                        - income
                        - balance_sheet
                        - cash_flow
                    - type: 'null'
                macro:
                  anyOf:
                    - type: string
                      enum:
                        - interest_rates
                        - inflation
                        - yield_curve
                        - banks
                        - inflation_series
                    - type: 'null'
                bank:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 200
                    - type: 'null'
                series:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 200
                    - type: 'null'
                limit:
                  anyOf:
                    - type: integer
                      minimum: 1
                      maximum: 100
                    - type: 'null'
                cursor:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 2000
                    - type: 'null'
                interval:
                  anyOf:
                    - type: string
                      enum:
                        - day
                        - week
                        - month
                        - year
                    - type: 'null'
                start_date:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                end_date:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                metric_name:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 200
                    - type: 'null'
                filters:
                  anyOf:
                    - type: array
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                            minLength: 1
                            maxLength: 80
                          operator:
                            type: string
                            enum:
                              - gt
                              - lt
                              - gte
                              - lte
                              - eq
                              - in
                          value:
                            anyOf:
                              - type: number
                              - type: string
                                minLength: 1
                                maxLength: 200
                              - type: array
                                items:
                                  type: string
                                  minLength: 1
                                  maxLength: 200
                                maxItems: 100
                        required:
                          - field
                          - operator
                          - value
                        additionalProperties: false
                      minItems: 1
                      maxItems: 20
                    - type: 'null'
                describe_filters:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                  description: >-
                    screen only: true reads available fields, aliases, operators
                    and company labels for free; filters and limit are then
                    rejected.
                report_period:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                report_period_gte:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                report_period_lte:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                report_period_gt:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                report_period_lt:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                filing_date:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                filing_date_gte:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                filing_date_lte:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                filing_date_gt:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                filing_date_lt:
                  anyOf:
                    - type: string
                      minLength: 1
                      pattern: ^\d{4}-\d{2}-\d{2}$
                    - type: 'null'
                max_charge_usd:
                  anyOf:
                    - type: string
                      pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                      description: >-
                        Exact USD decimal string (min 2, max 6 decimals, one
                        canonical spelling). Sum with decimal arithmetic or
                        scale by 10^6 — never floats.
                    - type: 'null'
                task_id:
                  anyOf:
                    - type: string
                      description: >-
                        Group related Runs, including automatic fallback, under
                        one Task. Reuse a stable string and filter the Runs list
                        by task to retrieve them.
                    - type: 'null'
                metadata:
                  anyOf:
                    - anyOf:
                        - type: object
                          additionalProperties:
                            type: string
                            minLength: 1
                            maxLength: 500
                          maxProperties: 20
                          propertyNames:
                            type: string
                            pattern: ^[a-z][a-z0-9_]{0,39}$
                        - {}
                      description: >-
                        Optional tracking fields, returned on the Run and
                        available as filters. They never go to the Provider or
                        affect routing, Price, or idempotency.


                        - Up to 20 keys: lowercase letters, digits, and
                        underscores; start with a letter; at most 40 characters.

                        - Values: strings of 1–500 characters.

                        - user_id: your End user's opaque ID, never their email
                        address or name.


                        Invalid entries are dropped whole, not truncated. The
                        request continues, and the Run returns the fields that
                        were stored.
                    - type: 'null'
              required:
                - action
              additionalProperties: false
              description: >-
                One FinancialDatasets operation per request. Unused fields are
                rejected before charging. Empty data can still be charged. No
                currency conversion, estimated missing values or automatic
                pagination.
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/StockResearchResult'
        '202':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/StockResearchResult'
        '400':
          description: ValidationFailed | IdempotencyKeyRequired
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '402':
          description: InsufficientBalance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsufficientBalanceEncoded'
        '403':
          description: EndpointNotPermitted | Forbidden
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/EndpointNotPermittedEncoded'
                  - $ref: '#/components/schemas/ForbiddenEncoded'
        '409':
          description: IdempotencyConflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdempotencyConflictEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
        '503':
          description: ServiceUnavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableEncoded'
      security:
        - bearer: []
components:
  schemas:
    StockResearchResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: Open this Run in the console. Requires Workspace membership.
        provider:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]*$
        endpoint:
          type: string
          pattern: ^\/.+$
        endpoint_version:
          type: integer
          exclusiveMinimum: 0
        status:
          type: string
          enum:
            - QUEUED
            - RUNNING
            - COMPLETED
            - FAILED
            - STOPPED
          description: >-
            QUEUED or RUNNING: still in progress. COMPLETED: a Provider response
            is available, including non-2xx responses. FAILED: read failure.
            STOPPED: stopped before dispatch. Read charge_usd separately from
            status.
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: Why the Run failed. Non-null only when status is FAILED.
        input:
          anyOf:
            - type: object
            - type: array
              items:
                type: object
        output:
          anyOf:
            - anyOf:
                - type: object
                  properties:
                    ticker:
                      anyOf:
                        - type: string
                        - type: 'null'
                    cik:
                      anyOf:
                        - type: string
                        - type: 'null'
                    name:
                      anyOf:
                        - type: string
                        - type: 'null'
                    industry:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sector:
                      anyOf:
                        - type: string
                        - type: 'null'
                    exchange:
                      anyOf:
                        - type: string
                        - type: 'null'
                    location:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_code:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_sector:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_industry:
                      anyOf:
                        - type: string
                        - type: 'null'
                    is_active:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    sec_filings_url:
                      anyOf:
                        - type: string
                        - type: 'null'
                    market_cap:
                      anyOf:
                        - type: number
                        - type: 'null'
                    currency:
                      anyOf:
                        - type: string
                        - type: 'null'
                  required:
                    - ticker
                    - cik
                    - name
                    - industry
                    - sector
                    - exchange
                    - location
                    - sic_code
                    - sic_sector
                    - sic_industry
                    - is_active
                    - sec_filings_url
                    - market_cap
                    - currency
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          consolidated_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cost_of_revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividends_per_common_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share_diluted:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ebit:
                            anyOf:
                              - type: number
                              - type: 'null'
                          gross_profit:
                            anyOf:
                              - type: number
                              - type: 'null'
                          income_tax_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          interest_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_common_stock:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_discontinued_operations:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_non_controlling_interests:
                            anyOf:
                              - type: number
                              - type: 'null'
                          nonoperating_income_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          preferred_dividends_impact:
                            anyOf:
                              - type: number
                              - type: 'null'
                          research_and_development:
                            anyOf:
                              - type: number
                              - type: 'null'
                          revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          selling_general_and_administrative_expenses:
                            anyOf:
                              - type: number
                              - type: 'null'
                          weighted_average_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          weighted_average_shares_diluted:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - consolidated_income
                          - cost_of_revenue
                          - dividends_per_common_share
                          - earnings_per_share
                          - earnings_per_share_diluted
                          - ebit
                          - gross_profit
                          - income_tax_expense
                          - interest_expense
                          - net_income
                          - net_income_common_stock
                          - net_income_discontinued_operations
                          - net_income_non_controlling_interests
                          - nonoperating_income_expense
                          - operating_expense
                          - operating_income
                          - preferred_dividends_impact
                          - research_and_development
                          - revenue
                          - selling_general_and_administrative_expenses
                          - weighted_average_shares
                          - weighted_average_shares_diluted
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accumulated_other_comprehensive_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cash_and_equivalents:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          deferred_revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          deposit_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          goodwill_and_intangible_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          inventory:
                            anyOf:
                              - type: number
                              - type: 'null'
                          investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          outstanding_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          property_plant_and_equipment:
                            anyOf:
                              - type: number
                              - type: 'null'
                          retained_earnings:
                            anyOf:
                              - type: number
                              - type: 'null'
                          shareholders_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tax_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tax_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          trade_and_non_trade_payables:
                            anyOf:
                              - type: number
                              - type: 'null'
                          trade_and_non_trade_receivables:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - accumulated_other_comprehensive_income
                          - cash_and_equivalents
                          - current_assets
                          - current_debt
                          - current_investments
                          - current_liabilities
                          - deferred_revenue
                          - deposit_liabilities
                          - goodwill_and_intangible_assets
                          - inventory
                          - investments
                          - non_current_assets
                          - non_current_debt
                          - non_current_investments
                          - non_current_liabilities
                          - outstanding_shares
                          - property_plant_and_equipment
                          - retained_earnings
                          - shareholders_equity
                          - tax_assets
                          - tax_liabilities
                          - total_assets
                          - total_debt
                          - total_liabilities
                          - trade_and_non_trade_payables
                          - trade_and_non_trade_receivables
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          business_acquisitions_and_disposals:
                            anyOf:
                              - type: number
                              - type: 'null'
                          capital_expenditure:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_in_cash_and_equivalents:
                            anyOf:
                              - type: number
                              - type: 'null'
                          depreciation_and_amortization:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividends_and_other_cash_distributions:
                            anyOf:
                              - type: number
                              - type: 'null'
                          effect_of_exchange_rate_changes:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ending_cash_balance:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow:
                            anyOf:
                              - type: number
                              - type: 'null'
                          investment_acquisitions_and_disposals:
                            anyOf:
                              - type: number
                              - type: 'null'
                          issuance_or_purchase_of_equity_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          issuance_or_repayment_of_debt_securities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_financing:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_investing:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_operations:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          property_plant_and_equipment:
                            anyOf:
                              - type: number
                              - type: 'null'
                          share_based_compensation:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - business_acquisitions_and_disposals
                          - capital_expenditure
                          - change_in_cash_and_equivalents
                          - depreciation_and_amortization
                          - dividends_and_other_cash_distributions
                          - effect_of_exchange_rate_changes
                          - ending_cash_balance
                          - free_cash_flow
                          - investment_acquisitions_and_disposals
                          - issuance_or_purchase_of_equity_shares
                          - issuance_or_repayment_of_debt_securities
                          - net_cash_flow_from_financing
                          - net_cash_flow_from_investing
                          - net_cash_flow_from_operations
                          - net_income
                          - property_plant_and_equipment
                          - share_based_compensation
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          statement:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metric:
                            anyOf:
                              - type: string
                              - type: 'null'
                          dimension:
                            anyOf:
                              - type: string
                              - type: 'null'
                          label:
                            anyOf:
                              - type: string
                              - type: 'null'
                          value:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - statement
                          - metric
                          - dimension
                          - label
                          - value
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          asset_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          book_value_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          book_value_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cash_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          days_sales_outstanding:
                            anyOf:
                              - type: number
                              - type: 'null'
                          debt_to_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          debt_to_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividend_yield:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ebitda_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value_to_ebitda_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value_to_revenue_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_yield:
                            anyOf:
                              - type: number
                              - type: 'null'
                          gross_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          interest_coverage:
                            anyOf:
                              - type: number
                              - type: 'null'
                          inventory_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          market_cap:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_cash_flow_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_cycle:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_income_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          payout_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          peg_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_book_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_earnings_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_sales_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          quick_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          receivables_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_invested_capital:
                            anyOf:
                              - type: number
                              - type: 'null'
                          revenue_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          stock_price:
                            anyOf:
                              - type: number
                              - type: 'null'
                          working_capital_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - asset_turnover
                          - book_value_growth
                          - book_value_per_share
                          - cash_ratio
                          - current_ratio
                          - days_sales_outstanding
                          - debt_to_assets
                          - debt_to_equity
                          - dividend_yield
                          - earnings_growth
                          - earnings_per_share
                          - earnings_per_share_growth
                          - ebitda_growth
                          - enterprise_value
                          - enterprise_value_to_ebitda_ratio
                          - enterprise_value_to_revenue_ratio
                          - free_cash_flow_growth
                          - free_cash_flow_per_share
                          - free_cash_flow_yield
                          - gross_margin
                          - interest_coverage
                          - inventory_turnover
                          - market_cap
                          - net_margin
                          - operating_cash_flow_ratio
                          - operating_cycle
                          - operating_income_growth
                          - operating_margin
                          - payout_ratio
                          - peg_ratio
                          - price_to_book_ratio
                          - price_to_earnings_ratio
                          - price_to_sales_ratio
                          - quick_ratio
                          - receivables_turnover
                          - return_on_assets
                          - return_on_equity
                          - return_on_invested_capital
                          - revenue_growth
                          - stock_price
                          - working_capital_turnover
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_window:
                            anyOf:
                              - type: string
                              - type: 'null'
                          quarterly:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                          annual:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                          ttm:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - source_type
                          - filing_window
                          - quarterly
                          - annual
                          - ttm
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metric_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          low:
                            anyOf:
                              - type: number
                              - type: 'null'
                          high:
                            anyOf:
                              - type: number
                              - type: 'null'
                          point_estimate:
                            anyOf:
                              - type: number
                              - type: 'null'
                          prior_value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          unit:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          change_direction:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          raw_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - ticker
                          - metric_name
                          - period_text
                          - period_type
                          - report_date
                          - low
                          - high
                          - point_estimate
                          - prior_value
                          - unit
                          - currency
                          - change_direction
                          - source_url
                          - source_text
                          - raw_text
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          observed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          time_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price:
                            anyOf:
                              - type: number
                              - type: 'null'
                          open:
                            anyOf:
                              - type: number
                              - type: 'null'
                          high:
                            anyOf:
                              - type: number
                              - type: 'null'
                          low:
                            anyOf:
                              - type: number
                              - type: 'null'
                          close:
                            anyOf:
                              - type: number
                              - type: 'null'
                          volume:
                            anyOf:
                              - type: number
                              - type: 'null'
                          day_change:
                            anyOf:
                              - type: number
                              - type: 'null'
                          day_change_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - observed_at
                          - price_date
                          - time_text
                          - price
                          - open
                          - high
                          - low
                          - close
                          - volume
                          - day_change
                          - day_change_percent
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source:
                            anyOf:
                              - type: string
                              - type: 'null'
                          published_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - ticker
                          - title
                          - url
                          - source
                          - published_at
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          sector:
                            anyOf:
                              - type: string
                              - type: 'null'
                          industry:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metrics:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                value:
                                  anyOf:
                                    - anyOf:
                                        - type: number
                                        - type: string
                                    - type: 'null'
                              required:
                                - name
                                - value
                              additionalProperties: false
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - sector
                          - industry
                          - metrics
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          observation_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          bank:
                            anyOf:
                              - type: string
                              - type: 'null'
                          name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          series:
                            anyOf:
                              - type: string
                              - type: 'null'
                          value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          rate_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_1m_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_12m_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tenor:
                            anyOf:
                              - type: string
                              - type: 'null'
                          yield_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - observation_date
                          - bank
                          - name
                          - series
                          - value
                          - rate_percent
                          - change_1m_percent
                          - change_12m_percent
                          - tenor
                          - yield_percent
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    fields:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                          group:
                            type: string
                          values:
                            type: array
                            items:
                              type: string
                        required:
                          - name
                          - group
                          - values
                        additionalProperties: false
                    operators:
                      type: array
                      items:
                        type: string
                    aliases:
                      type: array
                      items:
                        type: object
                        properties:
                          alias:
                            type: string
                          field:
                            type: string
                        required:
                          - alias
                          - field
                        additionalProperties: false
                  required:
                    - fields
                    - operators
                    - aliases
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          unit:
                            anyOf:
                              - type: string
                              - type: 'null'
                          frequency:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - id
                          - name
                          - description
                          - unit
                          - frequency
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
            - type: 'null'
        response_file:
          type: object
          properties:
            body_field:
              type: string
              enum:
                - output
                - provider_response.error
            state:
              type: string
              enum:
                - available
                - link_pending
                - expired
                - unavailable
            download_url:
              anyOf:
                - type: string
                - type: 'null'
            link_expires_at:
              anyOf:
                - type: string
                  description: ISO-8601 UTC timestamp
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            bytes:
              type: integer
              minimum: 0
            sha256:
              type: string
            content_type:
              type: string
              enum:
                - application/json
          required:
            - body_field
            - state
            - download_url
            - link_expires_at
            - file_expires_at
            - bytes
            - sha256
            - content_type
          additionalProperties: false
          description: >-
            Complete large Provider body, delivered as a JSON file. Glasser
            applies a 32 MiB runtime resource guard to captured bodies and
            serialized files. body_field identifies the replaced field; output
            is null or provider_response.error is omitted. Download URLs expire
            after at most one hour. Authenticated Get Run refreshes the URL
            while the file is available, for 7 days. Reads and downloads do not
            execute or charge another Run. If state is link_pending, read the
            same Run to prepare the link without another execution or charge.
            The URL grants temporary read access: share it only with intended
            recipients.
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    HTTP status returned by the Provider. Check this even when
                    the Run is COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Non-null only when status is COMPLETED.


            - For 2xx responses, output contains Provider-native JSON (any
            shape), or null for an empty body.

            - For non-2xx responses, error contains the Provider's error body
            and output is null.


            Sensitive fields are removed from both bodies.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                Exact USD decimal string (min 2, max 6 decimals, one canonical
                spelling). Sum with decimal arithmetic or scale by 10^6 — never
                floats.
            - type: 'null'
          description: >-
            Historical total Charge of the listed Runs, including replayed or
            read Runs. Null until all listed Runs settle. This is not new
            spending by the current request; request_charge reports that
            separately. Failures can also be charged.
        charge_basis:
          anyOf:
            - type: object
              properties:
                clause:
                  type: string
                  enum:
                    - rule
                    - NO_RESULT
                    - PROVIDER_ERROR
                    - TIMED_OUT
                    - INTERNAL
                quantity:
                  anyOf:
                    - type: integer
                      minimum: 0
                    - type: 'null'
              required:
                - clause
                - quantity
              additionalProperties: false
            - type: 'null'
          description: >-
            Single-Run charge basis, or null for a multi-Run total. Read
            runs[].charge_basis for each charge.
        stoppable:
          type: boolean
          description: >-
            Whether a stop request can currently be accepted. This does not
            guarantee that the Run can stop before dispatch.
        stop_requested_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
          description: >-
            When a stop was requested. The Run can still continue if dispatch
            had already started.
        created_at:
          type: string
          description: ISO-8601 UTC timestamp
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
        task_id:
          anyOf:
            - type: string
            - type: 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
            minLength: 1
            maxLength: 500
          maxProperties: 20
          propertyNames:
            type: string
            pattern: ^[a-z][a-z0-9_]{0,39}$
          description: >-
            Your stored tracking fields. Use them to filter Runs. They never go
            to the Provider or affect routing, Price, or idempotency.


            - Up to 20 keys: lowercase letters, digits, and underscores; start
            with a letter; at most 40 characters.

            - Values: strings of 1–500 characters.

            - user_id: your End user's opaque ID, never their email address or
            name.
        review_invitation:
          type: object
          properties:
            run_id:
              type: string
            ratings:
              type: array
              items:
                type: string
                enum:
                  - exceeds_expectations
                  - meets_expectations
                  - partially_meets_expectations
                  - does_not_meet_expectations
                  - unable_to_assess
            instruction:
              type: string
          required:
            - run_id
            - ratings
            - instruction
          additionalProperties: false
          description: >-
            Present at most once per Run, on the first delivery of some
            completed Runs. After you use this result for the task, submit a
            review as the instruction says, then continue. Optional; it never
            affects the Run or its charge.
        action:
          type: string
          enum:
            - company
            - income
            - balance_sheet
            - cash_flow
            - segments
            - metrics
            - earnings
            - guidance
            - prices
            - news
            - screen
            - macro
        result_status:
          type: string
          enum:
            - success
            - no_result
            - error
            - pending
        error:
          anyOf:
            - type: object
              properties:
                code:
                  type: string
                message:
                  type: string
              required:
                - code
                - message
              additionalProperties: false
            - type: 'null'
        runs:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              run_url:
                type: string
                description: Open this Run in the console. Requires Workspace membership.
              provider:
                type: string
                pattern: ^[a-z0-9][a-z0-9-]*$
              endpoint:
                type: string
                pattern: ^\/.+$
              endpoint_version:
                type: integer
                exclusiveMinimum: 0
              status:
                type: string
                enum:
                  - QUEUED
                  - RUNNING
                  - COMPLETED
                  - FAILED
                  - STOPPED
                description: >-
                  QUEUED or RUNNING: still in progress. COMPLETED: a Provider
                  response is available, including non-2xx responses. FAILED:
                  read failure. STOPPED: stopped before dispatch. Read
                  charge_usd separately from status.
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: Why the Run failed. Non-null only when status is FAILED.
              input:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              output:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              response_file:
                type: object
                properties:
                  body_field:
                    type: string
                    enum:
                      - output
                      - provider_response.error
                  state:
                    type: string
                    enum:
                      - available
                      - link_pending
                      - expired
                      - unavailable
                  download_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                  link_expires_at:
                    anyOf:
                      - type: string
                        description: ISO-8601 UTC timestamp
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  bytes:
                    type: integer
                    minimum: 0
                  sha256:
                    type: string
                  content_type:
                    type: string
                    enum:
                      - application/json
                required:
                  - body_field
                  - state
                  - download_url
                  - link_expires_at
                  - file_expires_at
                  - bytes
                  - sha256
                  - content_type
                additionalProperties: false
                description: >-
                  Complete large Provider body, delivered as a JSON file.
                  Glasser applies a 32 MiB runtime resource guard to captured
                  bodies and serialized files. body_field identifies the
                  replaced field; output is null or provider_response.error is
                  omitted. Download URLs expire after at most one hour.
                  Authenticated Get Run refreshes the URL while the file is
                  available, for 7 days. Reads and downloads do not execute or
                  charge another Run. If state is link_pending, read the same
                  Run to prepare the link without another execution or charge.
                  The URL grants temporary read access: share it only with
                  intended recipients.
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          HTTP status returned by the Provider. Check this even
                          when the Run is COMPLETED.
                    required:
                      - http_status
                    additionalProperties: false
                  - type: 'null'
              charge_usd:
                anyOf:
                  - type: string
                    pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                    description: >-
                      Exact USD decimal string (min 2, max 6 decimals, one
                      canonical spelling). Sum with decimal arithmetic or scale
                      by 10^6 — never floats.
                  - type: 'null'
                description: >-
                  Final charge as an exact USD decimal string. Null while QUEUED
                  or RUNNING. A FAILED Run can have a non-zero charge under the
                  Endpoint's Price.
              charge_basis:
                anyOf:
                  - type: object
                    properties:
                      clause:
                        type: string
                        enum:
                          - rule
                          - NO_RESULT
                          - PROVIDER_ERROR
                          - TIMED_OUT
                          - INTERNAL
                      quantity:
                        anyOf:
                          - type: integer
                            minimum: 0
                          - type: 'null'
                    required:
                      - clause
                      - quantity
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Price clause used to calculate the charge. Null before
                  settlement or when no Provider attempt was made.
              stoppable:
                type: boolean
                description: >-
                  Whether a stop request can currently be accepted. This does
                  not guarantee that the Run can stop before dispatch.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
                description: >-
                  When a stop was requested. The Run can still continue if
                  dispatch had already started.
              created_at:
                type: string
                description: ISO-8601 UTC timestamp
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
              task_id:
                anyOf:
                  - type: string
                  - type: 'null'
              metadata:
                type: object
                additionalProperties:
                  type: string
                  minLength: 1
                  maxLength: 500
                maxProperties: 20
                propertyNames:
                  type: string
                  pattern: ^[a-z][a-z0-9_]{0,39}$
                description: >-
                  Your stored tracking fields. Use them to filter Runs. They
                  never go to the Provider or affect routing, Price, or
                  idempotency.


                  - Up to 20 keys: lowercase letters, digits, and underscores;
                  start with a letter; at most 40 characters.

                  - Values: strings of 1–500 characters.

                  - user_id: your End user's opaque ID, never their email
                  address or name.
            required:
              - id
              - run_url
              - provider
              - endpoint
              - endpoint_version
              - status
              - failure
              - input
              - output
              - provider_response
              - charge_usd
              - charge_basis
              - stoppable
              - stop_requested_at
              - created_at
              - started_at
              - completed_at
              - task_id
              - metadata
            additionalProperties: false
        request_charge:
          type: object
          properties:
            charge_usd:
              anyOf:
                - type: string
                  pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                  description: >-
                    Exact USD decimal string (min 2, max 6 decimals, one
                    canonical spelling). Sum with decimal arithmetic or scale by
                    10^6 — never floats.
                - type: 'null'
              description: >-
                Charge for Runs created by this request only. Replayed Runs and
                free reads add zero. Null while a newly created Run is unsettled
                or its admission source is unknown. This is not the historical
                total in charge_usd or runs[].charge_usd.
            created_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
            replayed_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
            unknown_run_ids:
              type: array
              items:
                type: string
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
                format: uuid
          required:
            - charge_usd
            - created_run_ids
            - replayed_run_ids
            - unknown_run_ids
          additionalProperties: false
          description: >-
            Request-scoped admission and Charge evidence. Record created_run_ids
            across the user's work, then count each settled Run once. Changing
            task_id does not turn an idempotent replay into a new Run. A result
            read has zero Charge and empty admission lists.
        result_url:
          type: string
          description: >-
            Authenticated, read-only URL path for polling this normalized result
            and total charge. Use with the API origin. Does not create Runs or
            resume fallback. GET /v1/runs/:id still returns the native,
            individual Run.
      required:
        - id
        - run_url
        - provider
        - endpoint
        - endpoint_version
        - status
        - failure
        - input
        - output
        - provider_response
        - charge_usd
        - charge_basis
        - stoppable
        - stop_requested_at
        - created_at
        - started_at
        - completed_at
        - task_id
        - metadata
        - action
        - result_status
        - error
        - runs
        - result_url
      additionalProperties: false
      description: >-
        Financial amounts retain currency; ratios and growth are unchanged
        fractions (0.3 means 30%). Macro rates and price day_change_percent are
        percentages. Missing fields are null. Run completed_at is retrieval
        time, never a substitute for an observation date.
    ValidationFailedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    IdempotencyKeyRequiredEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - idempotency_key_required
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    UnauthorizedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    InsufficientBalanceEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - insufficient_balance
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    EndpointNotPermittedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - endpoint_not_permitted
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ForbiddenEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    IdempotencyConflictEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - idempotency_conflict
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    RateLimitedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limited
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ServiceUnavailableEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - service_unavailable
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

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