# 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 Market Data API
  version: 1.0.0
extends: openapi/twelvedata-market-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: 6
- target: $.paths['/eod'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the end-of-day price for an instrument
      effect: read
      questions:
      - What was the closing price of this ETF on a specific date?
      - Can I get the official end-of-day close instead of a live price?
      instructions:
      - text: Get the end-of-day close for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show {symbol}'s closing price on {date}.
        slots:
          symbol: query.symbol
          date: query.date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/market_movers/{market}'].get
  update:
    x-apievangelist-phrasing:
      intent: List the day's top gaining and losing assets
      effect: read
      questions:
      - Which stocks are up the most since yesterday's close?
      - Can I list only the biggest losers above a minimum price?
      instructions:
      - text: Show the top movers in the {market} market.
        slots:
          market: path.market
      - text: List the top {direction} in {market} priced above {price_greater_than}.
        slots:
          direction: query.direction
          market: path.market
          price_greater_than: query.price_greater_than
      method: generated
      generated: '2026-10-01'
- target: $.paths['/price'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest market price for an instrument
      effect: read
      questions:
      - What is the last traded price of this ticker?
      - Can I include pre-market and after-hours trades in the latest price?
      instructions:
      - text: Get the latest price of {symbol}.
        slots:
          symbol: query.symbol
      - text: Show {symbol}'s latest price including extended hours set to {prepost}.
        slots:
          symbol: query.symbol
          prepost: query.prepost
      method: generated
      generated: '2026-10-01'
- target: $.paths['/quote'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a real-time quote with open, high, low and volume
      effect: read
      questions:
      - What are today's open, high, low and volume for a stock?
      - How far is this stock from its 52-week high?
      instructions:
      - text: Get a quote for {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the {interval} quote for {symbol} in the {timezone} timezone.
        slots:
          interval: query.interval
          symbol: query.symbol
          timezone: query.timezone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/time_series'].get
  update:
    x-apievangelist-phrasing:
      intent: Get historical price bars for an instrument
      effect: read
      questions:
      - How do I download a stock's daily price history?
      - Can I get split-adjusted intraday bars for a date range?
      instructions:
      - text: Get {interval} price history for {symbol}.
        slots:
          interval: query.interval
          symbol: query.symbol
      - text: Fetch {symbol} {interval} bars from {start_date} to {end_date}.
        slots:
          symbol: query.symbol
          interval: query.interval
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/time_series/cross'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cross-rate price history between two assets
      effect: read
      questions:
      - What has Apple's price looked like in Indian rupees over time?
      - Can I build a history for an exotic forex or crypto pair on the fly?
      instructions:
      - text: Get the {interval} cross rate of {base} priced in {quote}.
        slots:
          interval: query.interval
          base: query.base
          quote: query.quote
      - text: Chart {base} against {quote} at {interval} from {start_date}.
        slots:
          base: query.base
          quote: query.quote
          interval: query.interval
          start_date: query.start_date
      method: generated
      generated: '2026-10-01'