# 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 Stocks:aggregates API
  version: 1.0.0
extends: openapi/massive-com-stocks-aggregates-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: 7
- target: $.paths['/v1/indicators/ema/{stockTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the exponential moving average of a stock
      effect: read
      questions:
      - What's the 20-day exponential moving average for Apple stock?
      - Can I get a stock's EMA on split-adjusted prices?
      instructions:
      - text: Calculate the EMA for stock {stockTicker}.
        slots:
          stockTicker: path.stockTicker
      - text: Get the {window}-period exponential moving average for {stockTicker} on {timespan} bars.
        slots:
          window: query.window
          stockTicker: path.stockTicker
          timespan: query.timespan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/macd/{stockTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get MACD for a stock
      effect: read
      questions:
      - Has a stock's MACD line crossed above its signal line?
      - Can I change the short, long and signal windows for a stock's MACD?
      instructions:
      - text: Get MACD for stock {stockTicker}.
        slots:
          stockTicker: path.stockTicker
      - text: Compute MACD for {stockTicker} using windows {short_window}, {long_window} and {signal_window}.
        slots:
          stockTicker: path.stockTicker
          short_window: query.short_window
          long_window: query.long_window
          signal_window: query.signal_window
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/rsi/{stockTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the relative strength index of a stock
      effect: read
      questions:
      - Is a stock overbought or oversold on the RSI?
      - What is a share price's 14-day relative strength index?
      instructions:
      - text: Get the RSI for stock {stockTicker}.
        slots:
          stockTicker: path.stockTicker
      - text: Calculate a {window}-period RSI for {stockTicker}.
        slots:
          window: query.window
          stockTicker: path.stockTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/sma/{stockTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the simple moving average of a stock
      effect: read
      questions:
      - Is a stock trading above its 200-day simple moving average?
      - What's the 50-day SMA of a share price?
      instructions:
      - text: Calculate the simple moving average for stock {stockTicker}.
        slots:
          stockTicker: path.stockTicker
      - text: Get the {window}-period SMA for {stockTicker} on {timespan} bars.
        slots:
          window: query.window
          stockTicker: path.stockTicker
          timespan: query.timespan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/aggs/grouped/locale/us/market/stocks/{date}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get daily OHLC for every US stock
      effect: read
      questions:
      - Can I get the open, high, low and close for every US stock on one day?
      - Can the whole-market daily bars include OTC securities?
      instructions:
      - text: Get grouped daily bars for all US stocks on {date}.
        slots:
          date: path.date
      - text: Show every stock's OHLC for {date}, including OTC set to {include_otc}.
        slots:
          date: path.date
          include_otc: query.include_otc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/aggs/ticker/{stocksTicker}/prev'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a stock's previous-day OHLC
      effect: read
      questions:
      - What did a stock close at yesterday?
      - What were the prior session's high, low and volume for a share?
      instructions:
      - text: Get the previous close for stock {stocksTicker}.
        slots:
          stocksTicker: path.stocksTicker
      - text: Show yesterday's OHLC bar for {stocksTicker}.
        slots:
          stocksTicker: path.stocksTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get stock price bars over a date range
      effect: read
      questions:
      - Can I get 5-minute candles for a stock across a date range?
      - What were a stock's daily bars for the past year, adjusted for splits?
      instructions:
      - text: Get {multiplier}-{timespan} bars for {stocksTicker} from {from} to {to}.
        slots:
          multiplier: path.multiplier
          timespan: path.timespan
          stocksTicker: path.stocksTicker
          to: path.to
          from: path.from
      - text: Pull stock candles for {stocksTicker} between {from} and {to}.
        slots:
          stocksTicker: path.stocksTicker
          to: path.to
          from: path.from
      method: generated
      generated: '2026-09-26'