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

# Análisis de acciones

> Consulta finanzas, valoración, previsiones, precios, filtros y datos macroeconómicos mediante FinancialDatasets.

Elige una acción y su período o modo. Cada solicitud crea un Run; los valores ausentes permanecen en `null`. Las razones financieras son fracciones y las tasas macroeconómicas son porcentajes. Lee `result_status` y `charge_usd` por separado. Usa `action: screen` con `describe_filters: true` para consultar los campos admitidos antes de filtrar. La salida nativa del Provider permanece en el Run.


## OpenAPI

````yaml /openapi.es.json post /v1/solutions/finance/stock_research
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Una API Key, sin contrato, con pago por llamada, para APIs de pago
    adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de
    error incluye el mismo sobre.
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: Análisis de acciones
      description: >-
        Consulta datos de empresas, estados financieros, segmentos, métricas
        financieras actuales o históricas, resultados, previsiones de la
        empresa, precios, noticias, resultados de filtros y datos
        macroeconómicos mediante FinancialDatasets. Cada solicitud corresponde a
        un Endpoint y un Run. Los campos ausentes permanecen en null; se
        conservan por separado la moneda, los períodos y las fechas de origen.
        Las razones se expresan como fracciones y las tasas macroeconómicas como
        porcentajes. Los campos no admitidos y las solicitudes que superan
        max_charge_usd se rechazan antes de crear un Run. Un result_url firmado
        y autenticado permite leer los mismos Runs sin otro Charge. La salida
        nativa del Provider permanece en GET /v1/runs/:id.
      operationId: finance-stock-research
      parameters:
        - name: idempotency-key
          in: header
          schema:
            type: string
            minLength: 1
            description: >-
              Genere un valor único nuevo (preferiblemente un UUID aleatorio)
              para cada consulta independiente, incluso con los mismos
              parámetros el mismo día. Recupere la misma ejecución con su clave
              y parámetros originales para obtener el Run original sin otro
              cargo. Cambiar los parámetros de ejecución con la misma clave
              devuelve 409; cambiar task_id o metadata no inicia un Run nuevo.
              Las claves opacas existentes siguen siendo válidas para
              recuperación.
          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: >-
                        Auto predeterminado: selecciona el primer proveedor de
                        datos elegible según el orden de preferencia de Glasser.
                        Un proveedor de datos especificado debe admitir la
                        solicitud y estar permitido por tu API Key; no recurre a
                        otro proveedor de datos. Los valores disponibles se
                        muestran a continuación.
                    - 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: >-
                    Solo para metrics/prices/macro; el valor predeterminado es
                    snapshot. history requiere los parámetros de período o fecha
                    correspondientes a la acción.
                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: >-
                    Solo para screen: true consulta gratis los campos, alias,
                    operadores y etiquetas de empresas disponibles; en este modo
                    se rechazan filters y limit.
                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: >-
                        Cadena decimal exacta en USD (mínimo 2 y máximo 6
                        decimales, una única escritura canónica). Suma con
                        aritmética decimal o escala por 10^6; nunca uses números
                        de coma flotante.
                    - type: 'null'
                task_id:
                  anyOf:
                    - type: string
                      description: >-
                        Agrupa los Runs relacionados, incluido el fallback
                        automático, en un solo Task. Reutiliza una cadena
                        estable y filtra la lista de Runs por task para
                        recuperarlos.
                    - 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: >-
                        Campos de seguimiento opcionales, devueltos en el Run y
                        disponibles como filtros. Nunca se envían al proveedor
                        de datos ni afectan al enrutamiento, Price o la
                        idempotencia.


                        - Hasta 20 claves: letras minúsculas, dígitos y guiones
                        bajos; deben comenzar con una letra y tener como máximo
                        40 caracteres.

                        - Valores: cadenas de 1–500 caracteres.

                        - user_id: el ID opaco de tu usuario final, nunca su
                        dirección de correo electrónico ni su nombre.


                        Las entradas no válidas se descartan por completo, no se
                        truncan. La solicitud continúa y el Run devuelve los
                        campos que se almacenaron.
                    - type: 'null'
              required:
                - action
              additionalProperties: false
              description: >-
                Una operación de FinancialDatasets por solicitud. Los campos no
                utilizados se rechazan antes del cobro. Los datos vacíos pueden
                generar un cargo. No se convierten monedas, no se estiman
                valores ausentes ni se pagina automáticamente.
        required: true
      responses:
        '200':
          description: Éxito
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/StockResearchResult'
        '202':
          description: Éxito
          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: Abre este Run en la consola. Requiere pertenecer al Workspace.
        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 o RUNNING: todavía está en curso. COMPLETED: hay una
            respuesta del proveedor de datos disponible, incluidas las
            respuestas que no son 2xx. FAILED: consulta `failure`. STOPPED:
            detenido antes del dispatch. Consulta charge_usd por separado de
            status.
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: >-
            Motivo por el que falló el Run. Solo es distinto de null cuando
            status es 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: Marca de tiempo UTC ISO-8601
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: Marca de tiempo UTC ISO-8601
              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: >-
            Cuerpo completo de gran tamaño del proveedor de datos, entregado
            como archivo JSON. Glasser aplica un límite de recursos de 32 MiB al
            cuerpo capturado y al archivo serializado. body_field identifica el
            campo sustituido; output es null o se omite provider_response.error.
            Los enlaces de descarga caducan como máximo en una hora. Get Run con
            autenticación renueva la URL mientras el archivo esté disponible,
            durante 7 días. Las lecturas y descargas no ejecutan ni cobran otro
            Run. Si state es link_pending, consulta el mismo Run para preparar
            el enlace sin otra ejecución ni otro cargo. La URL concede acceso
            temporal de lectura: compártela solo con los destinatarios
            previstos.
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    Estado HTTP devuelto por el proveedor de datos. Compruébalo
                    incluso cuando el Run esté COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Solo es distinto de null cuando status es COMPLETED.


            - Para respuestas 2xx, output contiene JSON nativo del proveedor de
            datos (con cualquier estructura) o null si el cuerpo está vacío.

            - Para respuestas que no son 2xx, error contiene el cuerpo del error
            del proveedor de datos y output es null.


            Los campos sensibles se eliminan de ambos cuerpos.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, con
                una única representación canónica). Suma con aritmética decimal
                o escala por 10^6; nunca uses números de coma flotante.
            - type: 'null'
          description: >-
            Cargo histórico total de los Runs enumerados, incluidos los
            repetidos o leídos. Es null hasta que todos se liquiden. No es gasto
            nuevo de la solicitud actual; request_charge lo informa por
            separado. Los fallos también pueden tener cargo.
        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: >-
            Base del cargo de un único Run, o null para un total de varios Runs.
            Consulta runs[].charge_basis para cada cargo.
        stoppable:
          type: boolean
          description: >-
            Indica si actualmente se puede aceptar una solicitud de detención.
            Esto no garantiza que el Run pueda detenerse antes del dispatch.
        stop_requested_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
          description: >-
            Momento en que se solicitó la detención. El Run puede continuar si
            el dispatch ya había comenzado.
        created_at:
          type: string
          description: Marca de tiempo UTC ISO-8601
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              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: >-
            Tus campos de seguimiento almacenados. Úsalos para filtrar Runs.
            Nunca se envían al proveedor de datos ni afectan al enrutamiento,
            Price o la idempotencia.


            - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben
            comenzar por una letra; como máximo 40 caracteres.

            - Valores: cadenas de 1–500 caracteres.

            - user_id: el ID opaco de tu usuario final, nunca su dirección de
            correo electrónico ni su nombre.
        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: >-
            Aparece como máximo una vez por Run, en la primera entrega de
            algunos Runs completados. Después de usar este resultado en la
            tarea, envía una reseña como indica instruction y continúa. Es
            opcional; nunca afecta al Run ni a su cargo.
        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: Abre este Run en la consola. Requiere pertenecer al Workspace.
              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 o RUNNING: todavía está en curso. COMPLETED: hay una
                  respuesta del proveedor de datos disponible, incluidas las
                  respuestas que no son 2xx. FAILED: consulta `failure`.
                  STOPPED: detenido antes del dispatch. Consulta charge_usd por
                  separado de status.
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Motivo por el que falló el Run. Solo es distinto de null
                  cuando status es 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: Marca de tiempo UTC ISO-8601
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: Marca de tiempo UTC ISO-8601
                    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: >-
                  Cuerpo completo de gran tamaño del proveedor de datos,
                  entregado como archivo JSON. Glasser aplica un límite de
                  recursos de 32 MiB al cuerpo capturado y al archivo
                  serializado. body_field identifica el campo sustituido; output
                  es null o se omite provider_response.error. Los enlaces de
                  descarga caducan como máximo en una hora. Get Run con
                  autenticación renueva la URL mientras el archivo esté
                  disponible, durante 7 días. Las lecturas y descargas no
                  ejecutan ni cobran otro Run. Si state es link_pending,
                  consulta el mismo Run para preparar el enlace sin otra
                  ejecución ni otro cargo. La URL concede acceso temporal de
                  lectura: compártela solo con los destinatarios previstos.
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          Estado HTTP devuelto por el proveedor de datos.
                          Compruébalo incluso cuando el Run esté 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: >-
                      Cadena decimal exacta en USD (mínimo 2 y máximo 6
                      decimales, con una única representación canónica). Suma
                      con aritmética decimal o escala por 10^6; nunca uses
                      números de coma flotante.
                  - type: 'null'
                description: >-
                  Cargo final como cadena decimal exacta en USD. Es null
                  mientras está QUEUED o RUNNING. Un Run FAILED puede tener un
                  cargo distinto de cero según el Price del Endpoint.
              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: >-
                  Cláusula de Price utilizada para calcular el cargo. Es null
                  antes de la liquidación o cuando no se realizó ningún intento
                  con el proveedor de datos.
              stoppable:
                type: boolean
                description: >-
                  Indica si actualmente se puede aceptar una solicitud de
                  detención. Esto no garantiza que el Run pueda detenerse antes
                  del dispatch.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
                description: >-
                  Momento en que se solicitó la detención. El Run puede
                  continuar si el dispatch ya había comenzado.
              created_at:
                type: string
                description: Marca de tiempo UTC ISO-8601
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    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: >-
                  Tus campos de seguimiento almacenados. Úsalos para filtrar
                  Runs. Nunca se envían al proveedor de datos ni afectan al
                  enrutamiento, Price o la idempotencia.


                  - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos;
                  deben comenzar por una letra; como máximo 40 caracteres.

                  - Valores: cadenas de 1–500 caracteres.

                  - user_id: el ID opaco de tu usuario final, nunca su dirección
                  de correo electrónico ni su nombre.
            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: >-
                    Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales,
                    una única escritura canónica). Suma con aritmética decimal o
                    escala por 10^6; nunca uses números de coma flotante.
                - type: 'null'
              description: >-
                Cargo solo de los Runs creados por esta solicitud. Los Runs
                repetidos y las lecturas gratuitas añaden cero. Es null mientras
                un Run nuevo siga sin liquidar o se desconozca su origen de
                admisión. No es el total histórico de charge_usd o
                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: >-
            Evidencia de admisión y cargo de la solicitud actual. Conserve
            created_run_ids durante el trabajo del usuario y cuente cada Run
            liquidado una sola vez. Cambiar task_id no convierte una repetición
            idempotente en un Run nuevo. Leer un resultado tiene cargo cero y
            listas de admisión vacías.
        result_url:
          type: string
          description: >-
            Ruta de URL autenticada y de solo lectura para consultar este
            resultado normalizado y el cargo total. Úsala con el origen de la
            API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue
            devolviendo el Run nativo e individual.
      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: >-
        Los importes financieros conservan su moneda; las razones y el
        crecimiento conservan las fracciones originales (0.3 significa 30%). Las
        tasas macroeconómicas y day_change_percent son porcentajes. Los campos
        ausentes son null. completed_at del Run es la hora de consulta, nunca un
        sustituto de la fecha de observación.
    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.