# 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 Options:aggregates API
  version: 1.0.0
extends: openapi/massive-com-options-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: 6
- target: $.paths['/v1/indicators/ema/{optionsTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the exponential moving average of an option
      effect: read
      questions:
      - What's the exponential moving average of an options contract's price?
      - Can I compute an EMA on an option contract with a custom window?
      instructions:
      - text: Calculate the EMA for option contract {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      - text: Get the {window}-period exponential moving average for {optionsTicker}.
        slots:
          window: query.window
          optionsTicker: path.optionsTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/macd/{optionsTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get MACD for an options contract
      effect: read
      questions:
      - Is an option's price momentum turning according to MACD?
      - Can I set short and long windows for MACD on an options contract?
      instructions:
      - text: Get MACD for options contract {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      - text: Compute MACD for {optionsTicker} with short window {short_window}.
        slots:
          optionsTicker: path.optionsTicker
          short_window: query.short_window
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/rsi/{optionsTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the relative strength index of an option
      effect: read
      questions:
      - Is an options contract overbought on the RSI?
      - What's the RSI reading for an option on hourly bars?
      instructions:
      - text: Get the RSI for options contract {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      - text: Calculate a {window}-period RSI for {optionsTicker} on {timespan} bars.
        slots:
          window: query.window
          optionsTicker: path.optionsTicker
          timespan: query.timespan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/indicators/sma/{optionsTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the simple moving average of an option
      effect: read
      questions:
      - What's the simple moving average of an options contract's price?
      - Is an option trading above its 20-period simple moving average?
      instructions:
      - text: Calculate the simple moving average for option {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      - text: Get the {window}-period SMA for {optionsTicker}.
        slots:
          window: query.window
          optionsTicker: path.optionsTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/aggs/ticker/{optionsTicker}/prev'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an option's previous-day OHLC
      effect: read
      questions:
      - What did an options contract close at yesterday?
      - What was the prior day's high and low for an option?
      instructions:
      - text: Get the previous close for option {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      - text: Show yesterday's OHLC bar for options contract {optionsTicker}.
        slots:
          optionsTicker: path.optionsTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/aggs/ticker/{optionsTicker}/range/{multiplier}/{timespan}/{from}/{to}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get option price bars over a date range
      effect: read
      questions:
      - Can I get minute bars for an option contract across several days?
      - What were an option's daily OHLC bars through expiration?
      instructions:
      - text: Get {multiplier}-{timespan} bars for {optionsTicker} from {from} to {to}.
        slots:
          multiplier: path.multiplier
          timespan: path.timespan
          optionsTicker: path.optionsTicker
          to: path.to
          from: path.from
      - text: Pull option candles for {optionsTicker} between {from} and {to}.
        slots:
          optionsTicker: path.optionsTicker
          to: path.to
          from: path.from
      method: generated
      generated: '2026-09-26'