# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Massive Com Financials API
  version: 1.0.0
extends: openapi/massive-com-financials-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/stocks/financials/v1/balance-sheets'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a company's balance sheets
      effect: read
      questions:
      - What are a company's total assets, liabilities and equity?
      - Can I get quarterly balance sheets for a fiscal year?
      instructions:
      - text: Get balance sheets for {tickers}.
        slots:
          tickers: query.tickers
      - text: Show the balance sheet for CIK {cik} in fiscal year {fiscal_year}.
        slots:
          cik: query.cik
          fiscal_year: query.fiscal_year
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stocks/financials/v1/cash-flow-statements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a company's cash flow statements
      effect: read
      questions:
      - How much operating cash flow did a company generate?
      - Can I get trailing twelve-month cash flows rather than quarterly?
      instructions:
      - text: Get cash flow statements for {tickers}.
        slots:
          tickers: query.tickers
      - text: Show {timeframe} cash flows for {tickers}.
        slots:
          timeframe: query.timeframe
          tickers: query.tickers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stocks/financials/v1/income-statements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a company's income statements
      effect: read
      questions:
      - What were a company's revenue and net income last quarter?
      - Can I see income statement line items for a fiscal quarter?
      instructions:
      - text: Get income statements for {tickers}.
        slots:
          tickers: query.tickers
      - text: Show the income statement for {tickers} in fiscal quarter {fiscal_quarter} of {fiscal_year}.
        slots:
          tickers: query.tickers
          fiscal_quarter: query.fiscal_quarter
          fiscal_year: query.fiscal_year
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stocks/financials/v1/ratios'].get
  update:
    x-apievangelist-phrasing:
      intent: Screen stocks by financial ratios
      effect: read
      questions:
      - What is a stock's P/E, price-to-book and debt-to-equity ratio?
      - Which stocks have a dividend yield above 4 percent?
      - Can I screen for companies with high return on equity and low leverage?
      instructions:
      - text: Get financial ratios for {ticker}.
        slots:
          ticker: query.ticker
      - text: Find stocks with a P/E below {price_to_earnings_lt}.
        slots:
          price_to_earnings_lt: query.price_to_earnings.lt
      - text: List companies with market cap above {market_cap_gt} and dividend yield above {dividend_yield_gt}.
        slots:
          market_cap_gt: query.market_cap.gt
          dividend_yield_gt: query.dividend_yield.gt
      method: generated
      generated: '2026-09-26'