# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gemini Trust Trading API
  version: 1.0.0
extends: openapi/gemini-trust-trading-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: 4
- target: $.paths['/v1/prediction-markets/order'].post
  update:
    x-apievangelist-phrasing:
      intent: Place a prediction market order
      effect: write
      questions:
      - How do I buy Yes contracts on a prediction market at a limit price?
      - Can I place a stop-limit or maker-only order on a prediction contract?
      instructions:
      - text: Place a {orderType} order to {side} {quantity} {outcome} contracts of {symbol} at {price}.
        slots:
          orderType: requestBody.orderType
          side: requestBody.side
          quantity: requestBody.quantity
          outcome: requestBody.outcome
          symbol: requestBody.symbol
          price: requestBody.price
      - text: Buy {quantity} {outcome} shares of {symbol} at {price}, {timeInForce}.
        slots:
          quantity: requestBody.quantity
          outcome: requestBody.outcome
          symbol: requestBody.symbol
          price: requestBody.price
          timeInForce: requestBody.timeInForce
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/order/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Place up to 20 prediction orders at once
      effect: write
      questions:
      - Can I submit several prediction market orders in a single request?
      - What is the maximum number of orders in one batch?
      instructions:
      - text: 'Submit these prediction orders as one batch: {orders}.'
        slots:
          orders: requestBody.orders
      - text: 'Place a batch of up to 20 contract orders: {orders}.'
        slots:
          orders: requestBody.orders
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/order/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel one prediction market order
      effect: destructive
      questions:
      - How do I cancel a single prediction market order?
      - What permission does my key need to cancel a contract order?
      instructions:
      - text: Cancel prediction order {orderId}.
        slots:
          orderId: requestBody.orderId
      - text: Pull my contract order {orderId} off the book.
        slots:
          orderId: requestBody.orderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/order/batch/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel up to 20 prediction orders at once
      effect: destructive
      questions:
      - Can I cancel a list of prediction orders in one call?
      - Do batch cancels accept order IDs as strings as well as integers?
      instructions:
      - text: 'Cancel these prediction orders together: {orderIds}.'
        slots:
          orderIds: requestBody.orderIds
      - text: Batch-cancel contract orders {orderIds}.
        slots:
          orderIds: requestBody.orderIds
      method: generated
      generated: '2026-10-01'