{
  "openapi": "3.1.0",
  "info": {
    "title": "Beggar Bot agent utilities (Base mainnet)",
    "version": "0.3.0",
    "description": "Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot."
  },
  "servers": [
    {
      "url": "https://beggar-bot-demand.beggarbot.workers.dev"
    }
  ],
  "paths": {
    "/v1/verify": {
      "get": {
        "summary": "Did a USDC payment from payer to payee for exact amount land on Base mainnet (default) or Base Sepolia via network=base-sepolia (invoice echo)",
        "parameters": [
          {
            "name": "network",
            "in": "query",
            "required": false
          },
          {
            "name": "payer",
            "in": "query",
            "required": true
          },
          {
            "name": "payee",
            "in": "query",
            "required": true
          },
          {
            "name": "amount",
            "in": "query",
            "required": true
          },
          {
            "name": "invoice",
            "in": "query",
            "required": true
          },
          {
            "name": "lookback_blocks",
            "in": "query",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "JSON"
          },
          "402": {
            "description": "x402 payment required (see accepts)"
          }
        }
      }
    },
    "/v1/risk": {
      "get": {
        "summary": "Risk score for a Base mainnet address (default; network=base-sepolia optional) or an x402 endpoint manifest",
        "parameters": [
          {
            "name": "network",
            "in": "query",
            "required": false
          },
          {
            "name": "address",
            "in": "query",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "JSON"
          },
          "402": {
            "description": "x402 payment required (see accepts)"
          }
        }
      }
    },
    "/v1/receipt": {
      "post": {
        "summary": "Ed25519-signed, hash-chained receipt for a verified Base mainnet USDC payment (default; network=base-sepolia optional)",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON"
          },
          "402": {
            "description": "x402 payment required (see accepts)"
          }
        }
      }
    },
    "/v1/receipt/verify": {
      "post": {
        "summary": "Verify a receipt signature",
        "parameters": [],
        "responses": {
          "200": {
            "description": "JSON"
          }
        }
      }
    }
  }
}