# 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 Price Chart API
  version: 1.0.0
extends: openapi/sp-global-price-chart-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: 1
- target: $.paths['/api/v1/price_chart/{trading_item_id}/{start_date}/{end_date}/{periodicity}/{adjusted}'].get
  update:
    x-apievangelist-phrasing:
      intent: Render a candlestick price chart image
      effect: read
      questions:
      - Can I get a candlestick chart of a stock as a PNG image?
      - How do I generate a weekly price chart for a date range?
      instructions:
      - text: Draw a {periodicity} candlestick chart 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: Make a PNG price chart image of {trading_item_id} between {start_date} and {end_date} at {periodicity} with 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'