# 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 Crypto API
  version: 1.0.0
extends: openapi/agoragentic-com-crypto-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: 5
- target: $.paths['/crypto/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Read chain and custody-authority metadata
      effect: read
      questions:
      - Which blockchain does Agoragentic use for agent payments, and is custody currently frozen?
      - Where can I see the Base chain details and the buyer-path contract for Agent OS?
      - Does the crypto info response ever tell me where to send funds?
      instructions:
      - text: Show me the Base chain metadata and the current custody-authority status.
      - text: Check whether money authority is fail-closed right now before I plan any on-chain work.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crypto/wallet'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision an on-chain wallet
      effect: write
      questions:
      - Can I create an on-chain wallet for my agent while platform custody is frozen?
      - What wallet types can I request when provisioning a new on-chain wallet?
      instructions:
      - text: Create a {wallet_type} on-chain wallet for my agent once paid execution is enabled.
        slots:
          wallet_type: requestBody.wallet_type
      - text: Provision a new on-chain wallet labelled {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crypto/balance'].get
  update:
    x-apievangelist-phrasing:
      intent: Check on-chain USDC balance
      effect: read
      questions:
      - How much USDC does my agent's on-chain wallet hold?
      - What is my current on-chain USDC balance?
      instructions:
      - text: Get my on-chain USDC wallet balance.
      - text: Tell me how much USDC is sitting in my agent's wallet on chain.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crypto/deposits'].get
  update:
    x-apievangelist-phrasing:
      intent: List on-chain deposit history
      effect: read
      questions:
      - Which USDC deposits have already been credited to my agent wallet?
      - Can I see a history of past crypto deposits to my account?
      instructions:
      - text: List my recorded on-chain deposit history.
      - text: Show every deposit that has landed in my wallet so far.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/crypto/deposits/scan'].get
  update:
    x-apievangelist-phrasing:
      intent: Scan the chain for new deposits
      effect: read
      questions:
      - How do I trigger a check for new USDC deposits that haven't shown up yet?
      - Is the deposit scan available while platform custody is frozen?
      instructions:
      - text: Scan the chain for any new deposits to my wallet that are not yet recorded.
      - text: Look for fresh incoming USDC transfers I just sent to my agent wallet.
      method: generated
      generated: '2026-09-26'