openapi: 3.2.0
info:
  title: PaidHandshake Exchange X402 API
  version: 2.9.0
  description: Broad lawful paid public-web research and commercial-intelligence routing, verified data feeds, delegated machine payments and recurring watches for autonomous agents.
servers:
- url: https://paidhandshake.com
tags:
- name: X402
paths:
  /api/x402/v1/status:
    get:
      operationId: getX402Status
      summary: Read x402 payment-gateway status
      responses:
        '200':
          description: x402 status
      tags:
      - X402
  /api/x402/v1/item:
    get:
      operationId: buyVerifiedItemX402
      summary: Buy one verified inventory item with Base USDC via x402
      responses:
        '200':
          description: Paid verified answer
        '402':
          description: PAYMENT-REQUIRED
        '503':
          description: x402 not active
      tags:
      - X402
  /api/x402/v1/bundle:
    get:
      operationId: buyVerifiedBundleX402
      summary: Buy a verified inventory bundle with Base USDC via x402
      responses:
        '200':
          description: Paid verified answer bundle
        '402':
          description: PAYMENT-REQUIRED
        '503':
          description: x402 not active
      tags:
      - X402
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: One-time-issued phm_ machine API key. Store securely; PaidHandshake stores only a hash.