# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for REST Instant API
  version: 1.0.0
extends: openapi/gemini-trust-instant-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['/v1/instant/quote'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a quote for an instant buy or sell
      effect: read
      questions:
      - What price would I get for an instant buy of bitcoin with $500?
      - Can I quote an instant purchase paid from a linked bank?
      instructions:
      - text: Quote an instant {side} of {symbol} spending {totalSpend}.
        slots:
          side: requestBody.side
          symbol: requestBody.symbol
          totalSpend: requestBody.totalSpend
      - text: Get an instant buy quote for {symbol} worth {totalSpend} paid with bank {paymentMethodUuid}.
        slots:
          symbol: requestBody.symbol
          totalSpend: requestBody.totalSpend
          paymentMethodUuid: requestBody.paymentMethodUuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/instant/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Execute an instant order from a quote
      effect: write
      questions:
      - How do I lock in an instant quote I just received?
      - Do the price and fee have to match the quote exactly when executing?
      instructions:
      - text: Execute instant quote {quoteId} to {side} {quantity} {symbol} at {price} with fee {fee}.
        slots:
          quoteId: requestBody.quoteId
          side: requestBody.side
          quantity: requestBody.quantity
          symbol: requestBody.symbol
          price: requestBody.price
          fee: requestBody.fee
      - text: Accept quote {quoteId} and complete the instant {side} of {symbol}.
        slots:
          quoteId: requestBody.quoteId
          side: requestBody.side
          symbol: requestBody.symbol
      method: generated
      generated: '2026-10-01'