{
  "openapi": "3.1.0",
  "info": {
    "title": "Delivery Probe by Agentropolis",
    "version": "0.1.0",
    "summary": "One real paid call to an x402 seller; did it actually deliver?",
    "description": "Delivery Probe: before your agent trusts an x402 seller, Agentropolis makes ONE real paid call to it from our own wallet and reports whether it actually delivered — HTTP status, latency, valid JSON, error-shaped body, the seller's own declared output schema, and on-chain settlement of the seller payment (paid_not_delivered is the red flag). Price = $0.50 + the seller's price; only Base-USDC sellers priced ≤ $0.10; 1 paid probe per seller per day, repeat checks within 24h return the cached result for $0.50.",
    "contact": {
      "name": "Agentropolis",
      "email": "hello@agentropolis.io",
      "url": "https://agentropolis.io"
    },
    "x-guidance": "POST https://seenly-delivery-probe.vercel.app/api/probe with JSON {url, method?, body?} → verdict (delivered | delivered_with_issues | paid_not_delivered | failed_not_charged | unconfirmed), reasons, delivery details, seller payment tx. Ineligible targets (not x402, not Base USDC, price > $0.10, already probed today without cache, daily budget used) are refused BEFORE payment with a 4xx and you are not charged. Your payment is collected before the probe pays the seller, because the probe spends real money. A single probe is evidence, not a guarantee."
  },
  "servers": [
    {
      "url": "https://seenly-delivery-probe.vercel.app"
    }
  ],
  "paths": {
    "/api/probe": {
      "post": {
        "operationId": "probeSellerDelivery",
        "summary": "Pay an x402 seller once from our wallet and grade the delivery",
        "tags": [
          "Delivery Probe"
        ],
        "x-payment-info": {
          "price": {
            "mode": "dynamic",
            "currency": "USD",
            "min": "0.50",
            "max": "0.60",
            "formula": "0.50 + seller price"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "rails": [
            {
              "protocol": "x402",
              "version": 2,
              "scheme": "exact",
              "network": "eip155:8453",
              "networkName": "Base mainnet",
              "asset": "USDC",
              "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "500000",
              "priceUsd": "0.50",
              "pricing": "dynamic: $0.50 + target seller price (seller price ≤ $0.10)",
              "priceMaxUsd": "0.60",
              "chargeOn": "before_probe",
              "payTo": "0xeE6239F3E17bEBe5e89F21F29D74D68CAa0d78CE",
              "facilitator": "Coinbase CDP (gas sponsored; payer needs no ETH)",
              "header": "PAYMENT-SIGNATURE"
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProbeRequest"
              },
              "examples": {
                "seller": {
                  "value": {
                    "url": "https://seller.example.com/api/paid-endpoint",
                    "method": "POST",
                    "body": {
                      "query": "example input the seller expects"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Probe report",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProbeResult"
                }
              }
            }
          },
          "402": {
            "description": "Payment required (x402 v2); body.quote shows fee + seller price"
          },
          "409": {
            "description": "already_probed_today (not charged)"
          },
          "422": {
            "description": "invalid_request / target_not_x402 / target_not_eligible (not charged)"
          },
          "429": {
            "description": "daily_cap_reached (not charged)"
          },
          "503": {
            "description": "probe_wallet_low / payments_misconfigured (not charged)"
          }
        }
      }
    },
    "/api/status": {
      "get": {
        "operationId": "probeStatus",
        "summary": "Free: probe wallet health and remaining daily budget",
        "responses": {
          "200": {
            "description": "status"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProbeRequest": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The seller's paid x402 endpoint (https, Base USDC, price ≤ $0.10)"
          },
          "method": {
            "type": "string",
            "enum": [
              "POST",
              "GET"
            ],
            "default": "POST"
          },
          "body": {
            "description": "JSON body to send the seller (default: the seller's own Bazaar example input, else {})"
          }
        },
        "required": [
          "url"
        ]
      },
      "ProbeResult": {
        "type": "object",
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "delivered",
              "delivered_with_issues",
              "paid_not_delivered",
              "failed_not_charged",
              "unconfirmed",
              "probe_error"
            ]
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cached": {
            "type": "boolean"
          },
          "seller": {
            "type": "object"
          },
          "delivery": {
            "type": "object"
          },
          "seller_payment": {
            "type": "object"
          },
          "probed_at": {
            "type": "string"
          }
        },
        "required": [
          "verdict",
          "seller",
          "delivery",
          "seller_payment"
        ],
        "example": {
          "verdict": "delivered",
          "reasons": [],
          "cached": false,
          "seller": {
            "url": "https://seller.example.com/api/paid-endpoint",
            "method": "POST",
            "pay_to": "0x0000000000000000000000000000000000000000",
            "price_usd": 0.01,
            "x402_version": 2,
            "network": "eip155:8453"
          },
          "delivery": {
            "http_status": 200,
            "latency_ms": 840,
            "content_type": "application/json",
            "bytes": 512,
            "truncated": false,
            "json_valid": true,
            "error_shaped": false,
            "schema_check": {
              "declared": true,
              "ok": true,
              "missing": []
            },
            "excerpt": "{\"result\": \"...\"}"
          },
          "seller_payment": {
            "settled": true,
            "tx": "0x…",
            "onchain_status": "success",
            "basescan": "https://basescan.org/tx/0x…",
            "paid_from": "0x03f7F496b5E5358D4579e58ba9e466cFf401c2A3"
          },
          "request_body_source": "buyer",
          "probed_at": "2026-10-30T15:00:00.000Z",
          "agentropolis": {
            "listing": "https://agentropolis.io/listing/seenly.seenly-delivery-probe",
            "note": "One real paid call; a single probe is evidence, not a guarantee."
          }
        }
      }
    }
  }
}