# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LLM-ready Pricing API
  version: 1.0.0
extends: openapi/sp-global-pricing-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: 2
- target: $.paths['/api/v1/pricing/{trading_item_id}/{start_date}/{end_date}/{periodicity}/{adjusted}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get historical stock prices
      effect: read
      questions:
      - What were a stock's daily open, high, low and close prices last month?
      - Can I get split-adjusted prices and volume for a date range?
      - How current is the price data - does it include today?
      instructions:
      - text: Get {periodicity} prices for trading item {trading_item_id} from {start_date} to {end_date}, adjusted {adjusted}.
        slots:
          periodicity: path.periodicity
          trading_item_id: path.trading_item_id
          start_date: path.start_date
          end_date: path.end_date
          adjusted: path.adjusted
      - text: Pull OHLC and volume data for {trading_item_id} between {start_date} and {end_date} at {periodicity}, adjusted={adjusted}.
        slots:
          trading_item_id: path.trading_item_id
          start_date: path.start_date
          end_date: path.end_date
          periodicity: path.periodicity
          adjusted: path.adjusted
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/pricing/{trading_item_id}/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a trading item's listing metadata
      effect: read
      questions:
      - When did this stock first trade and on which exchange?
      - What currency and instrument type is a trading item?
      instructions:
      - text: Get the metadata for trading item {trading_item_id}.
        slots:
          trading_item_id: path.trading_item_id
      - text: Show the symbol, exchange and first trade date of {trading_item_id}.
        slots:
          trading_item_id: path.trading_item_id
      method: generated
      generated: '2026-10-01'