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

# 读取股票研究结果

> 读取同一批股票研究 Run，不再调用 Provider，也不产生新的 Charge。

使用同一 Workspace 和仍允许来源 Endpoint 的 Key 访问带签名的 `result_url`。响应保留归一输出和实际 Charge；`pending` 不触发新执行。


## OpenAPI

````yaml /openapi.zh.json get /v1/solutions/finance/stock_research/result
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: 一个 API Key，无需合同，按次付费，即可调用批量采购的付费 API。每个响应包含 x-request-id；所有错误正文采用统一结构。
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/finance/stock_research/result:
    get:
      tags:
        - Solutions
      summary: 读取股票研究结果
      description: >-
        使用股票研究调用返回的 result_url 读取同一批 Run 的归一输出、业务 result_status 和合计费用。HTTP 200
        仍可能包含 result_status=pending。此认证读取不创建 Run、不调用 Provider，也不恢复兜底。GET
        /v1/runs/:id 仍返回单个 Run 的原生数据。结果上下文带签名、绑定 Workspace，并对每个 Run 检查当前 Key 策略。
      operationId: finance-stock-research-result
      parameters:
        - name: token
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 16384
            description: result_url 中返回的不透明结果上下文。保持原样，并使用有权读取所列全部 Run 的 API Key 认证。
          required: true
      responses:
        '200':
          description: >-
            财务金额保留币种；比率与增长率保持原始小数（0.3 表示 30%）。宏观利率与股价 day_change_percent
            是百分数。缺失字段为 null。Run completed_at 是取数时间，不能代替观察日期。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StockResearchResult'
        '400':
          description: ValidationFailed
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenEncoded'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
      security:
        - bearer: []
components:
  schemas:
    StockResearchResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: 在控制台打开 Run，需要工作空间成员权限。
        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 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取
            failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: Run 失败原因，仅在 status 为 FAILED 时非 null。
        input:
          anyOf:
            - type: object
            - type: array
              items:
                type: object
        output:
          anyOf:
            - anyOf:
                - type: object
                  properties:
                    ticker:
                      anyOf:
                        - type: string
                        - type: 'null'
                    cik:
                      anyOf:
                        - type: string
                        - type: 'null'
                    name:
                      anyOf:
                        - type: string
                        - type: 'null'
                    industry:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sector:
                      anyOf:
                        - type: string
                        - type: 'null'
                    exchange:
                      anyOf:
                        - type: string
                        - type: 'null'
                    location:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_code:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_sector:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sic_industry:
                      anyOf:
                        - type: string
                        - type: 'null'
                    is_active:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    sec_filings_url:
                      anyOf:
                        - type: string
                        - type: 'null'
                    market_cap:
                      anyOf:
                        - type: number
                        - type: 'null'
                    currency:
                      anyOf:
                        - type: string
                        - type: 'null'
                  required:
                    - ticker
                    - cik
                    - name
                    - industry
                    - sector
                    - exchange
                    - location
                    - sic_code
                    - sic_sector
                    - sic_industry
                    - is_active
                    - sec_filings_url
                    - market_cap
                    - currency
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          consolidated_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cost_of_revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividends_per_common_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share_diluted:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ebit:
                            anyOf:
                              - type: number
                              - type: 'null'
                          gross_profit:
                            anyOf:
                              - type: number
                              - type: 'null'
                          income_tax_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          interest_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_common_stock:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_discontinued_operations:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income_non_controlling_interests:
                            anyOf:
                              - type: number
                              - type: 'null'
                          nonoperating_income_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_expense:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          preferred_dividends_impact:
                            anyOf:
                              - type: number
                              - type: 'null'
                          research_and_development:
                            anyOf:
                              - type: number
                              - type: 'null'
                          revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          selling_general_and_administrative_expenses:
                            anyOf:
                              - type: number
                              - type: 'null'
                          weighted_average_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          weighted_average_shares_diluted:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - consolidated_income
                          - cost_of_revenue
                          - dividends_per_common_share
                          - earnings_per_share
                          - earnings_per_share_diluted
                          - ebit
                          - gross_profit
                          - income_tax_expense
                          - interest_expense
                          - net_income
                          - net_income_common_stock
                          - net_income_discontinued_operations
                          - net_income_non_controlling_interests
                          - nonoperating_income_expense
                          - operating_expense
                          - operating_income
                          - preferred_dividends_impact
                          - research_and_development
                          - revenue
                          - selling_general_and_administrative_expenses
                          - weighted_average_shares
                          - weighted_average_shares_diluted
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accumulated_other_comprehensive_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cash_and_equivalents:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          deferred_revenue:
                            anyOf:
                              - type: number
                              - type: 'null'
                          deposit_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          goodwill_and_intangible_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          inventory:
                            anyOf:
                              - type: number
                              - type: 'null'
                          investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_investments:
                            anyOf:
                              - type: number
                              - type: 'null'
                          non_current_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          outstanding_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          property_plant_and_equipment:
                            anyOf:
                              - type: number
                              - type: 'null'
                          retained_earnings:
                            anyOf:
                              - type: number
                              - type: 'null'
                          shareholders_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tax_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tax_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_debt:
                            anyOf:
                              - type: number
                              - type: 'null'
                          total_liabilities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          trade_and_non_trade_payables:
                            anyOf:
                              - type: number
                              - type: 'null'
                          trade_and_non_trade_receivables:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - accumulated_other_comprehensive_income
                          - cash_and_equivalents
                          - current_assets
                          - current_debt
                          - current_investments
                          - current_liabilities
                          - deferred_revenue
                          - deposit_liabilities
                          - goodwill_and_intangible_assets
                          - inventory
                          - investments
                          - non_current_assets
                          - non_current_debt
                          - non_current_investments
                          - non_current_liabilities
                          - outstanding_shares
                          - property_plant_and_equipment
                          - retained_earnings
                          - shareholders_equity
                          - tax_assets
                          - tax_liabilities
                          - total_assets
                          - total_debt
                          - total_liabilities
                          - trade_and_non_trade_payables
                          - trade_and_non_trade_receivables
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          business_acquisitions_and_disposals:
                            anyOf:
                              - type: number
                              - type: 'null'
                          capital_expenditure:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_in_cash_and_equivalents:
                            anyOf:
                              - type: number
                              - type: 'null'
                          depreciation_and_amortization:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividends_and_other_cash_distributions:
                            anyOf:
                              - type: number
                              - type: 'null'
                          effect_of_exchange_rate_changes:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ending_cash_balance:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow:
                            anyOf:
                              - type: number
                              - type: 'null'
                          investment_acquisitions_and_disposals:
                            anyOf:
                              - type: number
                              - type: 'null'
                          issuance_or_purchase_of_equity_shares:
                            anyOf:
                              - type: number
                              - type: 'null'
                          issuance_or_repayment_of_debt_securities:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_financing:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_investing:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_cash_flow_from_operations:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_income:
                            anyOf:
                              - type: number
                              - type: 'null'
                          property_plant_and_equipment:
                            anyOf:
                              - type: number
                              - type: 'null'
                          share_based_compensation:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - business_acquisitions_and_disposals
                          - capital_expenditure
                          - change_in_cash_and_equivalents
                          - depreciation_and_amortization
                          - dividends_and_other_cash_distributions
                          - effect_of_exchange_rate_changes
                          - ending_cash_balance
                          - free_cash_flow
                          - investment_acquisitions_and_disposals
                          - issuance_or_purchase_of_equity_shares
                          - issuance_or_repayment_of_debt_securities
                          - net_cash_flow_from_financing
                          - net_cash_flow_from_investing
                          - net_cash_flow_from_operations
                          - net_income
                          - property_plant_and_equipment
                          - share_based_compensation
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          statement:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metric:
                            anyOf:
                              - type: string
                              - type: 'null'
                          dimension:
                            anyOf:
                              - type: string
                              - type: 'null'
                          label:
                            anyOf:
                              - type: string
                              - type: 'null'
                          value:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - statement
                          - metric
                          - dimension
                          - label
                          - value
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          asset_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          book_value_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          book_value_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          cash_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          current_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          days_sales_outstanding:
                            anyOf:
                              - type: number
                              - type: 'null'
                          debt_to_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          debt_to_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          dividend_yield:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          earnings_per_share_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          ebitda_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value_to_ebitda_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          enterprise_value_to_revenue_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_per_share:
                            anyOf:
                              - type: number
                              - type: 'null'
                          free_cash_flow_yield:
                            anyOf:
                              - type: number
                              - type: 'null'
                          gross_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          interest_coverage:
                            anyOf:
                              - type: number
                              - type: 'null'
                          inventory_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          market_cap:
                            anyOf:
                              - type: number
                              - type: 'null'
                          net_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_cash_flow_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_cycle:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_income_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          operating_margin:
                            anyOf:
                              - type: number
                              - type: 'null'
                          payout_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          peg_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_book_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_earnings_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          price_to_sales_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          quick_ratio:
                            anyOf:
                              - type: number
                              - type: 'null'
                          receivables_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_assets:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_equity:
                            anyOf:
                              - type: number
                              - type: 'null'
                          return_on_invested_capital:
                            anyOf:
                              - type: number
                              - type: 'null'
                          revenue_growth:
                            anyOf:
                              - type: number
                              - type: 'null'
                          stock_price:
                            anyOf:
                              - type: number
                              - type: 'null'
                          working_capital_turnover:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - asset_turnover
                          - book_value_growth
                          - book_value_per_share
                          - cash_ratio
                          - current_ratio
                          - days_sales_outstanding
                          - debt_to_assets
                          - debt_to_equity
                          - dividend_yield
                          - earnings_growth
                          - earnings_per_share
                          - earnings_per_share_growth
                          - ebitda_growth
                          - enterprise_value
                          - enterprise_value_to_ebitda_ratio
                          - enterprise_value_to_revenue_ratio
                          - free_cash_flow_growth
                          - free_cash_flow_per_share
                          - free_cash_flow_yield
                          - gross_margin
                          - interest_coverage
                          - inventory_turnover
                          - market_cap
                          - net_margin
                          - operating_cash_flow_ratio
                          - operating_cycle
                          - operating_income_growth
                          - operating_margin
                          - payout_ratio
                          - peg_ratio
                          - price_to_book_ratio
                          - price_to_earnings_ratio
                          - price_to_sales_ratio
                          - quick_ratio
                          - receivables_turnover
                          - return_on_assets
                          - return_on_equity
                          - return_on_invested_capital
                          - revenue_growth
                          - stock_price
                          - working_capital_turnover
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_window:
                            anyOf:
                              - type: string
                              - type: 'null'
                          quarterly:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                          annual:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                          ttm:
                            anyOf:
                              - type: object
                                properties:
                                  revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_revenue:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  estimated_earnings_per_share:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  earnings_per_share_diluted:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  eps_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  eps_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_surprise:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  revenue_surprise_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  gross_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  operating_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_margin:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  net_income:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  free_cash_flow:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                  revenue_growth_ratio:
                                    anyOf:
                                      - type: number
                                      - type: 'null'
                                required:
                                  - revenue
                                  - estimated_revenue
                                  - earnings_per_share
                                  - estimated_earnings_per_share
                                  - earnings_per_share_diluted
                                  - eps_surprise
                                  - eps_surprise_ratio
                                  - revenue_surprise
                                  - revenue_surprise_ratio
                                  - gross_margin
                                  - operating_margin
                                  - net_margin
                                  - net_income
                                  - free_cash_flow
                                  - revenue_growth_ratio
                                additionalProperties: false
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - source_type
                          - filing_window
                          - quarterly
                          - annual
                          - ttm
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metric_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          low:
                            anyOf:
                              - type: number
                              - type: 'null'
                          high:
                            anyOf:
                              - type: number
                              - type: 'null'
                          point_estimate:
                            anyOf:
                              - type: number
                              - type: 'null'
                          prior_value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          unit:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          change_direction:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          raw_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - ticker
                          - metric_name
                          - period_text
                          - period_type
                          - report_date
                          - low
                          - high
                          - point_estimate
                          - prior_value
                          - unit
                          - currency
                          - change_direction
                          - source_url
                          - source_text
                          - raw_text
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          observed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          time_text:
                            anyOf:
                              - type: string
                              - type: 'null'
                          price:
                            anyOf:
                              - type: number
                              - type: 'null'
                          open:
                            anyOf:
                              - type: number
                              - type: 'null'
                          high:
                            anyOf:
                              - type: number
                              - type: 'null'
                          low:
                            anyOf:
                              - type: number
                              - type: 'null'
                          close:
                            anyOf:
                              - type: number
                              - type: 'null'
                          volume:
                            anyOf:
                              - type: number
                              - type: 'null'
                          day_change:
                            anyOf:
                              - type: number
                              - type: 'null'
                          day_change_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - ticker
                          - currency
                          - observed_at
                          - price_date
                          - time_text
                          - price
                          - open
                          - high
                          - low
                          - close
                          - volume
                          - day_change
                          - day_change_percent
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          title:
                            anyOf:
                              - type: string
                              - type: 'null'
                          url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          source:
                            anyOf:
                              - type: string
                              - type: 'null'
                          published_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - ticker
                          - title
                          - url
                          - source
                          - published_at
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          ticker:
                            anyOf:
                              - type: string
                              - type: 'null'
                          currency:
                            anyOf:
                              - type: string
                              - type: 'null'
                          period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          fiscal_period:
                            anyOf:
                              - type: string
                              - type: 'null'
                          report_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filed_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          form_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          filing_url:
                            anyOf:
                              - type: string
                              - type: 'null'
                          accession_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          sector:
                            anyOf:
                              - type: string
                              - type: 'null'
                          industry:
                            anyOf:
                              - type: string
                              - type: 'null'
                          metrics:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                value:
                                  anyOf:
                                    - anyOf:
                                        - type: number
                                        - type: string
                                    - type: 'null'
                              required:
                                - name
                                - value
                              additionalProperties: false
                        required:
                          - ticker
                          - currency
                          - period
                          - fiscal_period
                          - report_date
                          - filing_date
                          - filed_at
                          - form_type
                          - filing_url
                          - accession_number
                          - sector
                          - industry
                          - metrics
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          observation_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          bank:
                            anyOf:
                              - type: string
                              - type: 'null'
                          name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          series:
                            anyOf:
                              - type: string
                              - type: 'null'
                          value:
                            anyOf:
                              - type: number
                              - type: 'null'
                          rate_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_1m_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          change_12m_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                          tenor:
                            anyOf:
                              - type: string
                              - type: 'null'
                          yield_percent:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - observation_date
                          - bank
                          - name
                          - series
                          - value
                          - rate_percent
                          - change_1m_percent
                          - change_12m_percent
                          - tenor
                          - yield_percent
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
                - type: object
                  properties:
                    fields:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                          group:
                            type: string
                          values:
                            type: array
                            items:
                              type: string
                        required:
                          - name
                          - group
                          - values
                        additionalProperties: false
                    operators:
                      type: array
                      items:
                        type: string
                    aliases:
                      type: array
                      items:
                        type: object
                        properties:
                          alias:
                            type: string
                          field:
                            type: string
                        required:
                          - alias
                          - field
                        additionalProperties: false
                  required:
                    - fields
                    - operators
                    - aliases
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          unit:
                            anyOf:
                              - type: string
                              - type: 'null'
                          frequency:
                            anyOf:
                              - type: string
                              - type: 'null'
                        required:
                          - id
                          - name
                          - description
                          - unit
                          - frequency
                        additionalProperties: false
                    next_cursor:
                      anyOf:
                        - type: string
                        - type: 'null'
                    has_more:
                      anyOf:
                        - type: boolean
                        - type: 'null'
                    pagination_supported:
                      type: boolean
                  required:
                    - items
                    - next_cursor
                    - has_more
                    - pagination_supported
                  additionalProperties: false
            - type: 'null'
        response_file:
          type: object
          properties:
            body_field:
              type: string
              enum:
                - output
                - provider_response.error
            state:
              type: string
              enum:
                - available
                - link_pending
                - expired
                - unavailable
            download_url:
              anyOf:
                - type: string
                - type: 'null'
            link_expires_at:
              anyOf:
                - type: string
                  description: ISO 8601 UTC 时间戳。
                  format: date-time
                - type: 'null'
            file_expires_at:
              type: string
              description: ISO 8601 UTC 时间戳。
              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: >-
            以 JSON 文件完整交付较大的 Provider 正文。Glasser 对接收的正文和序列化文件应用 32 MiB
            的运行时资源保护。body_field 指明被替代的字段；output 为 null，或省略
            provider_response.error。下载链接最多一小时后过期。在文件的 7 天可用期内，通过已认证的 Get Run
            刷新链接。读取和下载不会再次执行 Run 或重复收费。state 为 link_pending 时，读取同一 Run
            即可准备链接，不会再次执行或重复收费。链接授予临时读取权限，请仅与预期接收者分享。
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: |-
            仅在 status 为 COMPLETED 时非 null。

            - 2xx 响应：output 为任意结构的数据提供商原生 JSON；正文为空时为 null。
            - 非 2xx 响应：error 包含数据提供商错误正文，output 为 null。

            两种正文均会移除敏感字段。
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。
            - type: 'null'
          description: >-
            所列 Run 的历史费用总和，包括重放或读取的 Run。所有 Run 结算前为
            null。这不是当前请求的新增支出；request_charge 单独报告新增费用。失败也可能收费。
        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: 单个 Run 的计费依据；多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。
        stoppable:
          type: boolean
          description: 当前是否可接受停止请求。不保证能在分派前停止 Run。
        stop_requested_at:
          anyOf:
            - type: string
              description: ISO 8601 UTC 时间戳。
              format: date-time
            - type: 'null'
          description: 请求停止的时间。如果已开始分派，Run 仍可能继续。
        created_at:
          type: string
          description: ISO 8601 UTC 时间戳。
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: ISO 8601 UTC 时间戳。
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: ISO 8601 UTC 时间戳。
              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: |-
            已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。

            - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。
            - 值：长度为 1–500 的字符串。
            - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。
        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: >-
            每个 Run 至多出现一次，只在部分已完成 Run 的首次交付中出现。用完本次结果后，按 instruction
            提交评价，然后继续任务。可选；不影响 Run 及其费用。
        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: 在控制台打开 Run，需要工作空间成员权限。
              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 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx
                  响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: Run 失败原因，仅在 status 为 FAILED 时非 null。
              input:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              output:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              response_file:
                type: object
                properties:
                  body_field:
                    type: string
                    enum:
                      - output
                      - provider_response.error
                  state:
                    type: string
                    enum:
                      - available
                      - link_pending
                      - expired
                      - unavailable
                  download_url:
                    anyOf:
                      - type: string
                      - type: 'null'
                  link_expires_at:
                    anyOf:
                      - type: string
                        description: ISO 8601 UTC 时间戳。
                        format: date-time
                      - type: 'null'
                  file_expires_at:
                    type: string
                    description: ISO 8601 UTC 时间戳。
                    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: >-
                  以 JSON 文件完整交付较大的 Provider 正文。Glasser 对接收的正文和序列化文件应用 32 MiB
                  的运行时资源保护。body_field 指明被替代的字段；output 为 null，或省略
                  provider_response.error。下载链接最多一小时后过期。在文件的 7 天可用期内，通过已认证的 Get
                  Run 刷新链接。读取和下载不会再次执行 Run 或重复收费。state 为 link_pending 时，读取同一 Run
                  即可准备链接，不会再次执行或重复收费。链接授予临时读取权限，请仅与预期接收者分享。
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: 数据提供商返回的 HTTP 状态，即使 Run 为 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: >-
                      精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6
                      转为整数，不使用浮点数。
                  - type: 'null'
                description: >-
                  最终费用，精确的美元十进制字符串。QUEUED 或 RUNNING 时为 null。FAILED 状态的 Run
                  仍可能按接口定价产生非零费用。
              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: 计算费用所用的价格条款。结算前或未尝试调用数据提供商时为 null。
              stoppable:
                type: boolean
                description: 当前是否可接受停止请求。不保证能在分派前停止 Run。
              stop_requested_at:
                anyOf:
                  - type: string
                    description: ISO 8601 UTC 时间戳。
                    format: date-time
                  - type: 'null'
                description: 请求停止的时间。如果已开始分派，Run 仍可能继续。
              created_at:
                type: string
                description: ISO 8601 UTC 时间戳。
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: ISO 8601 UTC 时间戳。
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: ISO 8601 UTC 时间戳。
                    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: |-
                  已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。

                  - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。
                  - 值：长度为 1–500 的字符串。
                  - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。
            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: >-
                    精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6
                    转为整数，不使用浮点数。
                - type: 'null'
              description: >-
                仅计算当前请求新建 Run 的费用。重放 Run 与免费读取不增加费用。新建 Run 未结算或受理来源未知时为 null。这不是
                charge_usd 或 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: >-
            当前请求的受理与费用证据。在同一件用户工作中保存 created_run_ids，每个已结算 Run 只计一次费用。更换 task_id
            不会把幂等重放变成新 Run。读取结果的费用为零，受理列表为空。
        result_url:
          type: string
          description: >-
            通过认证读取规范化结果和总费用的只读 URL 路径，配合 API 服务地址使用。不创建 Run，也不恢复切换。GET
            /v1/runs/:id 仍返回原生单个 Run。
      required:
        - id
        - run_url
        - provider
        - endpoint
        - endpoint_version
        - status
        - failure
        - input
        - output
        - provider_response
        - charge_usd
        - charge_basis
        - stoppable
        - stop_requested_at
        - created_at
        - started_at
        - completed_at
        - task_id
        - metadata
        - action
        - result_status
        - error
        - runs
        - result_url
      additionalProperties: false
      description: >-
        财务金额保留币种；比率与增长率保持原始小数（0.3 表示 30%）。宏观利率与股价 day_change_percent 是百分数。缺失字段为
        null。Run completed_at 是取数时间，不能代替观察日期。
    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
    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
    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
    NotFoundEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            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
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

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