API Evangelist conversational phrasing for Kraken Spot REST Account Data API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kraken Spot REST Account Data API
  version: 1.0.0
extends: openapi/kraken-account-data-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: 12
- target: $.paths['/0/private/Balance'].post
  update:
    x-apievangelist-phrasing:
      intent: Get spot account asset balances
      effect: read
      questions:
      - How much of each asset do I hold in my Kraken account?
      - What is my current crypto and cash balance per asset?
      instructions:
      - text: Show the balance of every asset in my account.
      - text: Get my asset balances using two-factor code {otp}.
        slots:
          otp: requestBody.otp
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/BalanceEx'].post
  update:
    x-apievangelist-phrasing:
      intent: Get balances with amounts on hold and credit
      effect: read
      questions:
      - How much of my balance is on hold in open orders?
      - Can I see credit and held amounts alongside each asset balance?
      instructions:
      - text: Show my extended balances including amounts held for trades and credit.
      - text: Get my extended balance with held amounts using two-factor code {otp}.
        slots:
          otp: requestBody.otp
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/TradeBalance'].post
  update:
    x-apievangelist-phrasing:
      intent: Get margin equity and free margin
      effect: read
      questions:
      - What is my margin level and how much free margin do I have?
      - Can I see my trade balance denominated in a particular asset?
      instructions:
      - text: Show my margin equity, used margin and free margin.
      - text: Get my trade balance expressed in {asset}.
        slots:
          asset: requestBody.asset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/OpenOrders'].post
  update:
    x-apievangelist-phrasing:
      intent: List open spot orders
      effect: read
      questions:
      - Which spot orders do I have open right now?
      - Can I filter my open orders by my own user reference number?
      instructions:
      - text: List all my open orders including related trades.
      - text: Show my open orders tagged with user reference {userref}.
        slots:
          userref: requestBody.userref
      - text: Find my open order with client order ID {cl_ord_id}.
        slots:
          cl_ord_id: requestBody.cl_ord_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/ClosedOrders'].post
  update:
    x-apievangelist-phrasing:
      intent: List closed or cancelled orders
      effect: read
      questions:
      - What orders of mine have closed or been cancelled recently?
      - Is closed-order history limited to 50 results per page?
      - Can I restrict closed orders to a date range?
      instructions:
      - text: List my 50 most recent closed orders.
      - text: Show orders I closed between {start} and {end}.
        slots:
          start: requestBody.start
          end: requestBody.end
      - text: Get the next page of closed orders starting at offset {ofs}.
        slots:
          ofs: requestBody.ofs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/QueryOrders'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up specific orders by ID
      effect: read
      questions:
      - Can I check the details of particular orders if I know their transaction IDs?
      - How many order IDs can I look up in one request?
      instructions:
      - text: Get details for orders {txid}.
        slots:
          txid: requestBody.txid
      - text: Look up order {txid} and include its trades.
        slots:
          txid: requestBody.txid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/TradesHistory'].post
  update:
    x-apievangelist-phrasing:
      intent: View my spot trade history
      effect: read
      questions:
      - What trades have I executed, newest first?
      - Can I see only my trades within a specific time window?
      instructions:
      - text: Show my trade history.
      - text: List my trades between {start} and {end}.
        slots:
          start: requestBody.start
          end: requestBody.end
      - text: Show only my {type} trades.
        slots:
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/QueryTrades'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up specific trades by ID
      effect: read
      questions:
      - Can I fetch the details of a trade if I have its trade ID?
      - What price and fee did a particular fill of mine have?
      instructions:
      - text: Get details for trade {txid}.
        slots:
          txid: requestBody.txid
      - text: Look up trades {txid} with their related trade info.
        slots:
          txid: requestBody.txid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/OpenPositions'].post
  update:
    x-apievangelist-phrasing:
      intent: List open margin positions
      effect: read
      questions:
      - What margin positions do I have open on spot pairs?
      - Can I see profit and loss calculated for my open margin positions?
      instructions:
      - text: List my open margin positions.
      - text: Show margin position {txid} with profit and loss calculated.
        slots:
          txid: requestBody.txid
      - text: Show my margin positions consolidated by {consolidation}.
        slots:
          consolidation: requestBody.consolidation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/Ledgers'].post
  update:
    x-apievangelist-phrasing:
      intent: Browse ledger entries
      effect: read
      questions:
      - Where can I see a log of deposits, withdrawals, fees and transfers on my account?
      - Can I filter ledger entries by asset or entry type?
      instructions:
      - text: List my ledger entries.
      - text: Show ledger entries for {asset} between {start} and {end}.
        slots:
          asset: requestBody.asset
          start: requestBody.start
          end: requestBody.end
      - text: List only {type} ledger entries.
        slots:
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/QueryLedgers'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up ledger entries by ID
      effect: read
      questions:
      - Can I pull up specific ledger entries if I know their ledger IDs?
      - How many ledger IDs can I query at once?
      instructions:
      - text: Get ledger entries {id}.
        slots:
          id: requestBody.id
      - text: Look up ledger {id} and include trade details.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/0/private/TradeVolume'].post
  update:
    x-apievangelist-phrasing:
      intent: Check 30-day trading volume and fee tier
      effect: read
      questions:
      - What is my 30-day trading volume on Kraken?
      - Which fee tier am I on for a given pair?
      instructions:
      - text: Show my 30-day trade volume and current fee tier.
      - text: Get my fee schedule for pair {pair}.
        slots:
          pair: requestBody.pair
      method: generated
      generated: '2026-10-01'