Deal Verdict API

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xc8A8Cd75457103F847Eeddc7f6Fe4efB3cA31b75",
    "amount": "50000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 120
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "product": "Bosch 800 series stainless dishwasher",
          "attribute": "stainless",
          "discount_threshold": 0.3
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "leads": [],
          "price": 591,
          "methods": [
            "per-store retailer lookup"
          ],
          "summary": "A deal was found: home_depot is 21.0% below the computed reference price for this product, at $591.00, which meets your requested threshold of 15% off. Checked 3 retailer(s).",
          "verdict": "deal_found",
          "retailer": "home_depot",
          "store_id": "6970",
          "confidence": "high",
          "price_verified": true,
          "size_or_variant": "50 gallon",
          "reference_source": "computed",
          "merchants_checked": [
            "home_depot",
            "lowes",
            "walmart"
          ],
          "best_discount_found": 0.21,
          "threshold_requested": 0.15,
          "merchants_unreachable": []
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "required": [],
              "properties": {
                "product": {
                  "type": "string",
                  "description": "The product to shop for, in plain language. Brand and model help but are not required, e.g. '50 gallon natural gas water heater' or 'Bosch 800 series dishwasher'."
                },
                "category": {
                  "type": "string",
                  "description": "Optional coarse category hint."
                },
                "location": {
                  "type": "string",
                  "description": "Optional city or ZIP. Localizes the price searches to that area (a city suits the aggregated feed; a ZIP localizes store delivery). No per-store fan-out."
                },
                "variants": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Optional size/variant hints, e.g. ['50 gallon']."
                },
                "attribute": {
                  "type": "string",
                  "description": "A required attribute, e.g. 'gas', 'stainless', '15-inch'."
                },
                "product_url": {
                  "type": "string",
                  "description": "Optional link to a specific product page. The service reads the page's title, model/SKU, and price to identify the exact product and default the reference price. Only the answer is returned - never the page's content or URL."
                },
                "reference_price": {
                  "type": "number",
                  "description": "Optional. Your own reference/list price to judge against. If omitted, the service uses a trailing median of observed prices."
                },
                "discount_threshold": {
                  "type": "number",
                  "description": "How deep a discount counts as a deal, as a fraction off the reference price. 0.30 means 'only tell me if something is at least 30% off'. Defaults to the service setting."
                }
              },
              "description": "Ask whether a specific product is meaningfully discounted right now. You describe the product in plain language; the service resolves it to canonical models, checks every retailer it can reach, and returns a single deal verdict - not a list of listings."
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-07-29 06:50Z

Last indexed by Roundhouse

2026-08-28 06:30Z

Last enriched (probe, favicon, geo)

2026-09-24 13:45Z

x402 version

2

Max timeout

120s

Liveness probe

HTTP 405