# 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 Positions API
  version: 1.0.0
extends: openapi/gemini-trust-positions-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: 5
- target: $.paths['/v1/prediction-markets/orders/active'].post
  update:
    x-apievangelist-phrasing:
      intent: List open prediction market orders
      effect: read
      questions:
      - Which of my prediction market orders are still open?
      - Can I see open orders for just one contract?
      instructions:
      - text: List my open prediction market orders.
      - text: Show my active orders on contract {symbol}.
        slots:
          symbol: requestBody.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/orders/history'].post
  update:
    x-apievangelist-phrasing:
      intent: List filled or cancelled prediction orders
      effect: read
      questions:
      - What prediction market orders of mine were filled last week?
      - Can I pull cancelled orders within a bounded time window?
      instructions:
      - text: Show my {status} prediction orders closed between {from} and {to}.
        slots:
          status: requestBody.status
          from: requestBody.from
          to: requestBody.to
      - text: List my past orders on contract {symbol}.
        slots:
          symbol: requestBody.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/positions'].post
  update:
    x-apievangelist-phrasing:
      intent: List current prediction market positions
      effect: read
      questions:
      - What prediction market positions am I holding right now?
      - Can I sort my open positions by unrealized profit and loss?
      instructions:
      - text: Show my current positions in event {eventTicker}.
        slots:
          eventTicker: query.eventTicker
      - text: List my open positions sorted by {sort}.
        slots:
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/positions/settled'].post
  update:
    x-apievangelist-phrasing:
      intent: List settled prediction positions and payouts
      effect: read
      questions:
      - How much did I get paid out on contracts that have resolved?
      - Can I include cash-outs when reviewing my settled positions?
      instructions:
      - text: List my settled positions sorted by {sort}.
        slots:
          sort: query.sort
      - text: Show settled positions in category {category} matching {search}.
        slots:
          category: query.category
          search: query.search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/prediction-markets/metrics/volume'].post
  update:
    x-apievangelist-phrasing:
      intent: Get my share volume for an event
      effect: read
      questions:
      - How many contracts have I traded as maker versus taker in an event?
      - Is event volume measured in shares or in dollars?
      instructions:
      - text: Show per-contract volume metrics for event {eventTicker}.
        slots:
          eventTicker: requestBody.eventTicker
      - text: Get my maker and taker volume in {eventTicker} between {startTime} and {endTime}.
        slots:
          eventTicker: requestBody.eventTicker
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-10-01'