Where should this whole shopping list be bought today? Real local shelf prices from each retailer's own storefront, normalized per unit so a gallon and a half gallon compare honestly. Pay-per-call in USDC on Base (x402).
| Endpoint | Price | What it returns |
|---|---|---|
| /find?q=milk&zip=30501 | $0.002 | One item across every store: price, sale, size, per-unit price, stock, link |
| /basket?items=milk,eggs,bread,butter&zip=30501 | $0.05 | The whole list priced at each store, missing items called out |
| /cheapest?items=milk,eggs,bread,butter&zip=30501 | $0.20 | Cheapest single store AND cross-store optimum, with savings and substitutes |
Payment: send an X-PAYMENT header (x402 exact scheme, USDC on Base). Without it, paid routes return a 402 challenge. Free: /health, /sources, /llms.txt, /server.json, and MCP initialize/tools/list. An uncovered ZIP or unknown product returns an explicit error and is not charged. Delivery fees and loyalty prices are not collected yet and are returned as null, never estimated — see /sources.