API Evangelist conversational phrasing for Twelve Data Analysis API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twelve Data Analysis API
  version: 1.0.0
extends: openapi/twelvedata-analysis-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/analyst_ratings/light'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an analyst ratings snapshot for a stock
      effect: read
      questions:
      - What is the quick summary of analyst buy, hold and sell ratings on a stock outside the US?
      - Can I get a lightweight analyst ratings snapshot filtered by country?
      instructions:
      - text: Get the analyst ratings snapshot for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the latest analyst ratings snapshot for {symbol} listed in {country}.
        slots:
          symbol: query.symbol
          country: query.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analyst_ratings/us_equities'].get
  update:
    x-apievangelist-phrasing:
      intent: Get detailed analyst ratings for a US stock
      effect: read
      questions:
      - Which analyst firms have rated this US stock, and did they upgrade or downgrade it?
      - Can I filter US equity analyst ratings to only show upgrades or downgrades?
      instructions:
      - text: List the detailed US analyst ratings issued on {symbol}, firm by firm.
        slots:
          symbol: query.symbol
      - text: Show only {rating_change} rating actions by analyst firms on US stock {symbol}.
        slots:
          rating_change: query.rating_change
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/earnings_estimate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get analyst EPS estimates for a company
      effect: read
      questions:
      - What EPS are analysts expecting for this company next quarter and next year?
      - Where can I find consensus earnings per share forecasts for upcoming periods?
      instructions:
      - text: Get the analyst earnings per share estimates for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show projected quarterly and annual EPS for {symbol} on {exchange}.
        slots:
          symbol: query.symbol
          exchange: query.exchange
      method: generated
      generated: '2026-10-01'
- target: $.paths['/eps_revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: Track recent analyst EPS forecast revisions
      effect: read
      questions:
      - Have analysts raised or cut their EPS forecasts for this stock over the past week or month?
      - How many analysts revised their earnings estimate up versus down recently?
      instructions:
      - text: Show the recent EPS revisions for {symbol}.
        slots:
          symbol: query.symbol
      - text: Pull last week's and last month's upward and downward EPS revisions for {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/eps_trend'].get
  update:
    x-apievangelist-phrasing:
      intent: See how EPS estimates have trended over time
      effect: read
      questions:
      - How has the consensus EPS estimate for a company moved over the last 90 days?
      - What did analysts expect for earnings per share 7, 30 and 60 days ago?
      instructions:
      - text: Get the EPS estimate trend for {symbol}.
        slots:
          symbol: query.symbol
      - text: Compare current and past consensus EPS estimates for {symbol} traded in {country}.
        slots:
          symbol: query.symbol
          country: query.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/growth_estimates'].get
  update:
    x-apievangelist-phrasing:
      intent: Get consensus growth rate projections
      effect: read
      questions:
      - What growth rate do analysts project for this company over the next five years?
      - Can I see consensus earnings growth expectations for the current and next year?
      instructions:
      - text: Get the analyst growth estimates for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show consensus growth projections for {symbol} using ISIN {isin}.
        slots:
          symbol: query.symbol
          isin: query.isin
      method: generated
      generated: '2026-10-01'
- target: $.paths['/price_target'].get
  update:
    x-apievangelist-phrasing:
      intent: Get analyst price targets for a security
      effect: read
      questions:
      - What is the average analyst price target for this stock?
      - Which is the highest and lowest price target analysts have set?
      instructions:
      - text: Get the analyst price target range for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the high, low and average price targets for {symbol} on {mic_code}.
        slots:
          symbol: query.symbol
          mic_code: query.mic_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the average analyst recommendation
      effect: read
      questions:
      - Is the overall analyst consensus on this stock a strong buy, buy, hold or sell?
      - Does Twelve Data give a numerical recommendation score for a stock?
      instructions:
      - text: Get the consensus analyst recommendation and score for {symbol}.
        slots:
          symbol: query.symbol
      - text: Tell me whether analysts currently rate {symbol} a buy or a sell on average.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/revenue_estimate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get analyst revenue forecasts for a company
      effect: read
      questions:
      - What revenue are analysts forecasting for this company this quarter and this year?
      - Can I compare projected sales with last year's revenue for a stock?
      instructions:
      - text: Get the analyst revenue estimates for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show projected quarterly and annual revenue for {symbol} rounded to {dp} decimals.
        slots:
          symbol: query.symbol
          dp: query.dp
      method: generated
      generated: '2026-10-01'