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

# Pesquisa de ações

> Consulte finanças, avaliação, projeções, preços, filtros e dados macroeconômicos pelo FinancialDatasets.

Escolha uma ação e seu período ou modo. Cada solicitação cria um Run; valores ausentes permanecem `null`. Índices financeiros usam frações e taxas macroeconômicas usam porcentagens. Leia `result_status` e `charge_usd` separadamente. Use `action: screen` com `describe_filters: true` para consultar os campos aceitos antes de filtrar. A saída nativa do Provider permanece no Run.


## OpenAPI

````yaml /openapi.pt.json post /v1/solutions/finance/stock_research
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas
    adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro
    contém o mesmo envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/finance/stock_research:
    post:
      tags:
        - Solutions
      summary: Pesquisa de ações
      description: >-
        Consulte dados de empresas, demonstrações financeiras, segmentos,
        métricas financeiras atuais ou históricas, resultados, projeções da
        empresa, preços, notícias, resultados de filtros e dados macroeconômicos
        pelo FinancialDatasets. Cada solicitação corresponde a um Endpoint e um
        Run. Os campos ausentes permanecem null; moeda, períodos e datas de
        origem são preservados separadamente. Os índices usam frações e as taxas
        macroeconômicas usam porcentagens. Campos não aceitos e solicitações
        acima de max_charge_usd são rejeitados antes de criar um Run. Um
        result_url assinado e autenticado permite ler os mesmos Runs sem outro
        Charge. A saída nativa do Provider permanece em GET /v1/runs/:id.
      operationId: finance-stock-research
      parameters:
        - name: idempotency-key
          in: header
          schema:
            type: string
            minLength: 1
            description: >-
              Gere um novo valor exclusivo (de preferência um UUID aleatório)
              para cada consulta independente, mesmo com os mesmos parâmetros no
              mesmo dia. Recupere a mesma execução com a chave e os parâmetros
              originais para obter o Run original sem outra cobrança. Alterar os
              parâmetros de execução com a mesma chave retorna 409; alterar
              task_id ou metadata não inicia um novo Run. As chaves opacas
              existentes continuam válidas para recuperação.
          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: >-
                        Padrão auto: seleciona o primeiro provedor de dados
                        elegível na ordem de preferência da Glasser. Um provedor
                        de dados nomeado precisa ser compatível com a
                        solicitação e permitido pela sua Key; ele não usa
                        fallback para outro provedor de dados. Os valores
                        disponíveis estão listados abaixo.
                    - 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: >-
                    Somente para metrics/prices/macro; o padrão é snapshot.
                    history exige os parâmetros de período ou data da ação
                    correspondente.
                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: >-
                    Somente para screen: true consulta gratuitamente os campos,
                    aliases, operadores e categorias de empresas disponíveis;
                    nesse modo, filters e limit são rejeitados.
                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: >-
                        String decimal exata em USD (mínimo de 2, máximo de 6
                        casas decimais, uma única grafia canônica). Faça a soma
                        com aritmética decimal ou multiplique por 10^6 — nunca
                        use números de ponto flutuante.
                    - type: 'null'
                task_id:
                  anyOf:
                    - type: string
                      description: >-
                        Agrupe Runs relacionados, incluindo o fallback
                        automático, em uma única Task. Reutilize uma string
                        estável e filtre a lista de Runs por task para
                        recuperá-los.
                    - 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 rastreamento opcionais, retornados no Run e
                        disponíveis como filtros. Eles nunca são enviados ao
                        provedor de dados nem afetam o roteamento, o preço ou a
                        idempotência.


                        - Até 20 chaves: letras minúsculas, dígitos e
                        sublinhados; comece com uma letra; no máximo 40
                        caracteres.

                        - Valores: strings de 1–500 caracteres.

                        - user_id: o ID opaco do seu usuário final, nunca o
                        endereço de e-mail ou o nome dele.


                        Entradas inválidas são descartadas integralmente, não
                        truncadas. A solicitação continua, e o Run retorna os
                        campos que foram armazenados.
                    - type: 'null'
              required:
                - action
              additionalProperties: false
              description: >-
                Uma operação do FinancialDatasets por solicitação. Campos não
                utilizados são rejeitados antes da cobrança. Dados vazios ainda
                podem gerar cobrança. Não há conversão de moedas, estimativa de
                valores ausentes ou paginação automática.
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/StockResearchResult'
        '202':
          description: Success
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/StockResearchResult'
        '400':
          description: ValidationFailed | IdempotencyKeyRequired
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '402':
          description: InsufficientBalance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsufficientBalanceEncoded'
        '403':
          description: EndpointNotPermitted | Forbidden
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/EndpointNotPermittedEncoded'
                  - $ref: '#/components/schemas/ForbiddenEncoded'
        '409':
          description: IdempotencyConflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdempotencyConflictEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
        '503':
          description: ServiceUnavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableEncoded'
      security:
        - bearer: []
components:
  schemas:
    StockResearchResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: Abra este Run no console. Requer associação ao 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 ou RUNNING: ainda em andamento. COMPLETED: uma resposta do
            provedor de dados está disponível, incluindo respostas não 2xx.
            FAILED: consulte `failure`. STOPPED: interrompido antes do despacho.
            Leia charge_usd separadamente 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 da falha do Run. Não nulo somente quando status é 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: carimbo de data e hora UTC ISO-8601
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: carimbo de data e hora 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: >-
            Corpo completo e de grande tamanho do provedor de dados, entregue
            como arquivo JSON. O Glasser aplica um limite de recursos de 32 MiB
            ao corpo capturado e ao arquivo serializado. body_field identifica o
            campo substituído; output é null ou provider_response.error é
            omitido. Os links de download expiram em no máximo uma hora. Get Run
            com autenticação renova a URL enquanto o arquivo estiver disponível,
            por 7 dias. Leituras e downloads não executam nem cobram outro Run.
            Se state for link_pending, leia o mesmo Run para preparar o link sem
            outra execução ou cobrança. A URL concede acesso temporário de
            leitura: compartilhe-a apenas com os destinatários pretendidos.
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    Status HTTP retornado pelo provedor de dados. Verifique-o
                    mesmo quando o Run estiver COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Não nulo somente quando status é COMPLETED.


            - Para respostas 2xx, output contém JSON nativo do provedor de dados
            (qualquer estrutura) ou nulo para um corpo vazio.

            - Para respostas não 2xx, error contém o corpo de erro do provedor
            de dados e output é nulo.


            Os campos confidenciais são removidos de ambos os corpos.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                String decimal exata em USD (mínimo de 2 e máximo de 6 casas
                decimais, com uma única grafia canônica). Some usando aritmética
                decimal ou multiplique por 10^6 — nunca use números de ponto
                flutuante.
            - type: 'null'
          description: >-
            Cobrança histórica total dos Runs listados, incluindo os
            reproduzidos ou lidos. É null até que todos sejam liquidados. Não é
            uma nova despesa da solicitação atual; request_charge a informa
            separadamente. Falhas também podem ser cobradas.
        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 de cobrança de um único Run ou nulo para um total de vários
            Runs. Leia runs[].charge_basis para cada cobrança.
        stoppable:
          type: boolean
          description: >-
            Indica se uma solicitação de interrupção pode ser aceita no momento.
            Isso não garante que o Run possa ser interrompido antes do despacho.
        stop_requested_at:
          anyOf:
            - type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            - type: 'null'
          description: >-
            Momento em que uma interrupção foi solicitada. O Run ainda pode
            continuar se o despacho já tiver começado.
        created_at:
          type: string
          description: carimbo de data e hora UTC ISO-8601
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: carimbo de data e hora UTC ISO-8601
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: carimbo de data e hora 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: >-
            Seus campos de acompanhamento armazenados. Use-os para filtrar Runs.
            Eles nunca são enviados ao provedor de dados nem afetam o
            roteamento, o Price ou a idempotência.


            - Até 20 chaves: letras minúsculas, dígitos e sublinhados; comece
            com uma letra; no máximo 40 caracteres.

            - Valores: strings de 1–500 caracteres.

            - user_id: o ID opaco do seu usuário final, nunca o endereço de
            e-mail ou o nome dele.
        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 no máximo uma vez por Run, na primeira entrega de alguns
            Runs concluídos. Depois de usar este resultado na tarefa, envie uma
            avaliação conforme indicado em instruction e continue. É opcional;
            nunca afeta o Run nem a cobrança.
        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: Abra este Run no console. Requer associação ao 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 ou RUNNING: ainda em andamento. COMPLETED: uma resposta
                  do provedor de dados está disponível, incluindo respostas não
                  2xx. FAILED: consulte `failure`. STOPPED: interrompido antes
                  do despacho. Leia charge_usd separadamente 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 da falha do Run. Não nulo somente quando status é
                  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: carimbo de data e hora UTC ISO-8601
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: carimbo de data e hora 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: >-
                  Corpo completo e de grande tamanho do provedor de dados,
                  entregue como arquivo JSON. O Glasser aplica um limite de
                  recursos de 32 MiB ao corpo capturado e ao arquivo
                  serializado. body_field identifica o campo substituído; output
                  é null ou provider_response.error é omitido. Os links de
                  download expiram em no máximo uma hora. Get Run com
                  autenticação renova a URL enquanto o arquivo estiver
                  disponível, por 7 dias. Leituras e downloads não executam nem
                  cobram outro Run. Se state for link_pending, leia o mesmo Run
                  para preparar o link sem outra execução ou cobrança. A URL
                  concede acesso temporário de leitura: compartilhe-a apenas com
                  os destinatários pretendidos.
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          Status HTTP retornado pelo provedor de dados.
                          Verifique-o mesmo quando o Run estiver 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: >-
                      String decimal exata em USD (mínimo de 2 e máximo de 6
                      casas decimais, com uma única grafia canônica). Some
                      usando aritmética decimal ou multiplique por 10^6 — nunca
                      use números de ponto flutuante.
                  - type: 'null'
                description: >-
                  Cobrança final como uma string decimal exata em USD. Nulo
                  enquanto estiver QUEUED ou RUNNING. Um Run FAILED pode ter uma
                  cobrança diferente de zero conforme o Price do 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 usada para calcular a cobrança. Nulo antes
                  da liquidação ou quando nenhuma tentativa com o provedor de
                  dados foi feita.
              stoppable:
                type: boolean
                description: >-
                  Indica se uma solicitação de interrupção pode ser aceita no
                  momento. Isso não garante que o Run possa ser interrompido
                  antes do despacho.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  - type: 'null'
                description: >-
                  Momento em que uma interrupção foi solicitada. O Run ainda
                  pode continuar se o despacho já tiver começado.
              created_at:
                type: string
                description: carimbo de data e hora UTC ISO-8601
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora UTC ISO-8601
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: carimbo de data e hora 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: >-
                  Seus campos de acompanhamento armazenados. Use-os para filtrar
                  Runs. Eles nunca são enviados ao provedor de dados nem afetam
                  o roteamento, o Price ou a idempotência.


                  - Até 20 chaves: letras minúsculas, dígitos e sublinhados;
                  comece com uma letra; no máximo 40 caracteres.

                  - Valores: strings de 1–500 caracteres.

                  - user_id: o ID opaco do seu usuário final, nunca o endereço
                  de e-mail ou o nome dele.
            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: >-
                    String decimal exata em USD (mínimo de 2, máximo de 6 casas
                    decimais, uma única grafia canônica). Faça a soma com
                    aritmética decimal ou multiplique por 10^6 — nunca use
                    números de ponto flutuante.
                - type: 'null'
              description: >-
                Cobrança apenas dos Runs criados por esta solicitação. Runs
                reproduzidos e leituras gratuitas acrescentam zero. É null
                enquanto um novo Run não estiver liquidado ou sua origem de
                admissão for desconhecida. Não é o total histórico de charge_usd
                ou 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: >-
            Evidência de admissão e cobrança da solicitação atual. Preserve
            created_run_ids durante o trabalho do usuário e conte cada Run
            liquidado uma única vez. Alterar task_id não transforma uma
            reprodução idempotente em um novo Run. A leitura de resultado tem
            cobrança zero e listas de admissão vazias.
        result_url:
          type: string
          description: >-
            Caminho de URL autenticado e somente leitura para consultar este
            resultado normalizado e a cobrança total. Use com a origem da API.
            Não cria Runs nem retoma o fallback. GET /v1/runs/:id ainda retorna
            o 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: >-
        Os valores financeiros mantêm a moeda; índices e crescimento preservam
        as frações originais (0.3 significa 30%). As taxas macroeconômicas e
        day_change_percent são porcentagens. Campos ausentes são null.
        completed_at do Run é o horário da consulta, nunca um substituto para a
        data de observação.
    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.