# 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:snapshot API
  version: 1.0.0
extends: openapi/massive-com-stocks-snapshot-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: 3
- target: $.paths['/v2/snapshot/locale/us/markets/stocks/tickers'].get
  update:
    x-apievangelist-phrasing:
      intent: Snapshot all US stock tickers
      effect: read
      questions:
      - Can I get up-to-date market data for every traded US stock at once?
      - Why is the full-market stock snapshot empty before 4am Eastern?
      instructions:
      - text: Get a snapshot of all US stock tickers.
      - text: 'Snapshot only these stocks: {tickers}.'
        slots:
          tickers: query.tickers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Snapshot a single US stock
      effect: read
      questions:
      - What's the most up-to-date market data for one stock?
      - Can I see a stock's current minute bar, day bar and last trade together?
      instructions:
      - text: Get the current snapshot for stock {stocksTicker}.
        slots:
          stocksTicker: path.stocksTicker
      - text: Show live market data for {stocksTicker}.
        slots:
          stocksTicker: path.stocksTicker
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/snapshot/locale/us/markets/stocks/{direction}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get today's top stock gainers or losers
      effect: read
      questions:
      - Which stocks are the biggest gainers today?
      - What are the 20 worst-performing stocks since yesterday's close?
      instructions:
      - text: List today's top stock {direction}.
        slots:
          direction: path.direction
      - text: Show the 20 stock {direction}, with OTC included set to {include_otc}.
        slots:
          direction: path.direction
          include_otc: query.include_otc
      method: generated
      generated: '2026-09-26'