openapi: 3.1.0
info:
  title: agentstock
  version: "0.1.0"
  description: |
    Pay-per-use consumables for AI agents. Every endpoint returns
    `402 Payment Required` until settled in USDC on Base via the x402 protocol.
servers:
  - url: https://api.agent402stock.xyz
paths:
  /v1/sms/otp:
    post:
      summary: Reserve a disposable SMS OTP number
      operationId: reserveSmsOtp
      responses:
        "200": { description: Number returned }
        "402": { description: Payment required }
  /v1/mail/inbox:
    post:
      summary: Spawn a disposable email inbox
      operationId: spawnMailInbox
      responses:
        "200": { description: Inbox created }
        "402": { description: Payment required }
  /v1/proxy/session:
    post:
      summary: Reserve a sticky residential proxy session
      operationId: reserveProxySession
      responses:
        "200": { description: Proxy URL returned }
        "402": { description: Payment required }
  /v1/browser/stealth:
    post:
      summary: Launch a stealth Chromium session
      operationId: launchBrowserStealth
      responses:
        "200": { description: CDP URL returned }
        "402": { description: Payment required }
  /v1/captcha/solve:
    post:
      summary: Solve a captcha challenge
      operationId: solveCaptcha
      responses:
        "200": { description: Solution token }
        "402": { description: Payment required }
  /v1/bundle/identity:
    post:
      summary: Geo-coordinated SMS + mail + proxy + browser bundle
      operationId: identityBundle
      responses:
        "200": { description: Bundle ready }
        "402": { description: Payment required }
  /api/v1/feedback:
    post:
      summary: Free-form feedback from agents
      operationId: submitFeedback
      responses:
        "201": { description: Stored }
