# 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 Us Futures API
  version: 1.0.0
extends: openapi/massive-com-us-futures-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: 8
- target: $.paths['/futures/v1/contracts'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up futures contracts and specifications
      effect: read
      questions:
      - Which futures contracts are listed for a product code?
      - When is the last trade date for a futures contract?
      - Can I list only active futures contracts?
      instructions:
      - text: List futures contracts for product code {product_code}.
        slots:
          product_code: query.product_code
      - text: Get contract specifications for futures ticker {ticker}.
        slots:
          ticker: query.ticker
      - text: Show contracts whose last trade date is before {last_trade_date_lt}.
        slots:
          last_trade_date_lt: query.last_trade_date.lt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/exchanges'].get
  update:
    x-apievangelist-phrasing:
      intent: List US futures exchanges
      effect: read
      questions:
      - Which US derivatives exchanges trade futures?
      - Is a particular commodity futures exchange covered?
      instructions:
      - text: List US futures exchanges.
      - text: Show the first {limit} futures trading venues.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/market-status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a futures product is trading
      effect: read
      questions:
      - Is a futures product open, paused or closed right now?
      - What is the live trading status of a futures market?
      instructions:
      - text: Get the market status for futures product {product_code}.
        slots:
          product_code: query.product_code
      - text: Check whether futures products {product_code_any_of} are open.
        slots:
          product_code_any_of: query.product_code.any_of
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/products'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse futures products and specifications
      effect: read
      questions:
      - What futures products are available in a given sector?
      - Can I list futures products by asset class?
      instructions:
      - text: Get the futures product {product_code}.
        slots:
          product_code: query.product_code
      - text: List futures products in sector {sector}.
        slots:
          sector: query.sector
      - text: Find futures products named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/quotes/{ticker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get bid and offer quotes for a futures contract
      effect: read
      questions:
      - What were the best bid and offer quotes for a futures contract today?
      - Can I get futures quotes for a particular trading session?
      instructions:
      - text: Get quotes for futures contract {ticker}.
        slots:
          ticker: path.ticker
      - text: Show {ticker} quotes for the session ending {session_end_date}.
        slots:
          ticker: path.ticker
          session_end_date: query.session_end_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/schedules'].get
  update:
    x-apievangelist-phrasing:
      intent: Get futures trading session schedules
      effect: read
      questions:
      - What are the trading hours and breaks for a futures product?
      - Are futures session times adjusted for an upcoming holiday?
      instructions:
      - text: Get trading schedules for futures product {product_code}.
        slots:
          product_code: query.product_code
      - text: Show futures schedules for session end date {session_end_date}.
        slots:
          session_end_date: query.session_end_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/snapshot'].get
  update:
    x-apievangelist-phrasing:
      intent: Snapshot the latest futures contract data
      effect: read
      questions:
      - What's the latest price data for a futures contract?
      - Can I snapshot every contract under a futures product?
      instructions:
      - text: Get a snapshot for futures contract {ticker}.
        slots:
          ticker: query.ticker
      - text: Snapshot all contracts for product {product_code}.
        slots:
          product_code: query.product_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/futures/v1/trades/{ticker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get tick-level trades for a futures contract
      effect: read
      questions:
      - What trades executed in a futures contract over a time range?
      - Can I pull every futures trade for one trading session?
      instructions:
      - text: Get trades for futures contract {ticker}.
        slots:
          ticker: path.ticker
      - text: List {ticker} trades since {timestamp_gte}.
        slots:
          ticker: path.ticker
          timestamp_gte: query.timestamp.gte
      method: generated
      generated: '2026-09-26'