# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Wallet API
  version: 1.0.0
extends: openapi/agoragentic-com-wallet-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/wallet'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my wallet balance
      effect: read
      questions:
      - How much USDC is in my agent's wallet?
      - What's my current Agoragentic wallet balance?
      instructions:
      - text: Show my wallet balance.
      - text: Tell me how much money my agent has left.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/pricing'].get
  update:
    x-apievangelist-phrasing:
      intent: See wallet deposit pricing tiers
      effect: read
      questions:
      - What USDC deposit tiers and conversion rates are offered?
      - Is wallet funding currently available or suppressed?
      instructions:
      - text: Show the public wallet deposit pricing.
      - text: List the USDC funding tiers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/purchase'].post
  update:
    x-apievangelist-phrasing:
      intent: Get instructions to fund my wallet
      effect: write
      questions:
      - How do I add USDC to my agent wallet on Base?
      - Why am I told a dedicated wallet is required before funding?
      instructions:
      - text: Get Base L2 funding instructions for {amount} USDC.
        slots:
          amount: requestBody.amount
      - text: Tell me how to top up my agent wallet.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/purchase/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a USDC deposit by transaction hash
      effect: write
      questions:
      - I sent USDC on Base — how do I get it credited to my wallet?
      - Can a deposit be credited instantly from its transaction hash?
      instructions:
      - text: Verify deposit transaction {tx_hash} and credit my wallet.
        slots:
          tx_hash: requestBody.tx_hash
      - text: Check Base transfer {tx_hash} and add it to my balance.
        slots:
          tx_hash: requestBody.tx_hash
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/deposit'].post
  update:
    x-apievangelist-phrasing:
      intent: Call the removed test deposit endpoint
      effect: write
      questions:
      - Can I still make a test deposit into my wallet?
      - What replaced the old deprecated wallet deposit endpoint?
      instructions:
      - text: Call the deprecated wallet deposit endpoint.
      - text: Try the legacy test deposit route.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/transactions'].get
  update:
    x-apievangelist-phrasing:
      intent: View my wallet transaction history
      effect: read
      questions:
      - What transactions have gone through my wallet?
      - Can I filter my wallet history by transaction type?
      instructions:
      - text: Show my last {limit} wallet transactions.
        slots:
          limit: query.limit
      - text: List my wallet transactions of type {type}.
        slots:
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Read my autonomous spending policy
      effect: read
      questions:
      - What spend caps and seller rules are set on my wallet?
      - Which categories is my agent allowed to spend in?
      instructions:
      - text: Show my autonomous wallet policy.
      - text: Get the current spending rules for my agent wallet.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/policy'].post
  update:
    x-apievangelist-phrasing:
      intent: Update my autonomous spending policy
      effect: write
      questions:
      - Can I block specific sellers from being paid by my agent?
      - Is there a way to auto-approve small purchases up to a set amount?
      instructions:
      - text: Set my wallet policy's daily spend cap to {daily_spend_cap}.
        slots:
          daily_spend_cap: requestBody.daily_spend_cap
      - text: Block sellers {blocked_sellers} in my wallet policy.
        slots:
          blocked_sellers: requestBody.blocked_sellers
      - text: Auto-approve purchases up to {auto_approve_max_usdc} USDC and allow only categories {allowed_categories}.
        slots:
          auto_approve_max_usdc: requestBody.auto_approve_max_usdc
          allowed_categories: requestBody.allowed_categories
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wallet/set_limits'].post
  update:
    x-apievangelist-phrasing:
      intent: Set spend limits via the legacy alias
      effect: write
      questions:
      - Is there an older endpoint for just setting wallet spend limits?
      - Which limits can the legacy set_limits route change?
      instructions:
      - text: Use the legacy set_limits route to cap per-call cost at {per_call_max_cost}.
        slots:
          per_call_max_cost: requestBody.per_call_max_cost
      - text: With the older limits alias, set rate limit to {rate_limit_per_minute} per minute.
        slots:
          rate_limit_per_minute: requestBody.rate_limit_per_minute
      method: generated
      generated: '2026-09-26'