# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for REST Margin Trading API
  version: 1.0.0
extends: openapi/gemini-trust-margin-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: 3
- target: $.paths['/v1/margin/account'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a spot margin account summary
      effect: read
      questions:
      - How close is my spot margin account to liquidation?
      - What is my current leverage and buying power for a given pair?
      instructions:
      - text: Show my margin account summary for {symbol}.
        slots:
          symbol: requestBody.symbol
      - text: Get collateral, leverage and liquidation risk for {symbol} on account {account}.
        slots:
          symbol: requestBody.symbol
          account: requestBody.account
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/margin/rates'].post
  update:
    x-apievangelist-phrasing:
      intent: Get margin borrowing interest rates
      effect: read
      questions:
      - What interest rate do I pay to borrow assets on margin?
      - Are margin borrow rates quoted hourly, daily or annually?
      instructions:
      - text: List current margin borrow rates for all assets.
      - text: Show margin interest rates available to account {account}.
        slots:
          account: requestBody.account
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/margin/order/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview how an order affects margin risk
      effect: read
      questions:
      - Can I see how a trade would change my margin risk before placing it?
      - Which fields do I need to preview a market buy versus a limit order on margin?
      instructions:
      - text: Preview the margin impact of a {type} {side} of {amount} {symbol} at {price}.
        slots:
          type: requestBody.type
          side: requestBody.side
          amount: requestBody.amount
          symbol: requestBody.symbol
          price: requestBody.price
      - text: Simulate a margin market buy of {symbol} spending {totalSpend} without placing it.
        slots:
          symbol: requestBody.symbol
          totalSpend: requestBody.totalSpend
      method: generated
      generated: '2026-10-01'