# 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 REST Core Data API
  version: 1.0.0
extends: openapi/twelvedata-core-data-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: 5
- target: $.paths['/eod'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest end-of-day closing price
      effect: read
      questions:
      - What did this stock close at on the last trading day?
      - Where can I get the official end-of-day close for an instrument?
      instructions:
      - text: Get the latest end-of-day close for {symbol}.
        slots:
          symbol: query.symbol
      - text: Fetch yesterday's closing price and metadata for {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/quote'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a real-time quote with daily stats
      effect: read
      questions:
      - Can I get open, high, low, volume and the 52-week range for a symbol in one call?
      - How much has this instrument changed in price today?
      instructions:
      - text: Get a real-time quote for {symbol} at the {interval} interval.
        slots:
          symbol: query.symbol
          interval: query.interval
      - text: Show the 52-week range and today's change for {symbol} using {interval} bars.
        slots:
          symbol: query.symbol
          interval: query.interval
      method: generated
      generated: '2026-10-01'
- target: $.paths['/price'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest real-time trading price
      effect: read
      questions:
      - What is the current trading price of this ticker right now?
      - Is there a lightweight call that returns only the last price for a symbol?
      instructions:
      - text: Get the current price of {symbol}.
        slots:
          symbol: query.symbol
      - text: Tell me what {symbol} is trading at right now, price only.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/market_movers/{market}'].get
  update:
    x-apievangelist-phrasing:
      intent: List today's top gainers and losers
      effect: read
      questions:
      - Which stocks are the biggest gainers and losers today?
      - What are the top movers by percentage change in the crypto market?
      instructions:
      - text: Show today's top gainers and losers in the {market} market.
        slots:
          market: path.market
      - text: List the biggest percentage movers for {market}.
        slots:
          market: path.market
      method: generated
      generated: '2026-10-01'
- target: $.paths['/market_state'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether exchanges are open or closed
      effect: read
      questions:
      - Is the stock exchange open right now?
      - Which exchanges are currently closed for trading?
      instructions:
      - text: Check whether {exchange} is open right now.
        slots:
          exchange: query.exchange
      - text: Show the open or closed state of every exchange.
      method: generated
      generated: '2026-10-01'