{"name":"onyx_retail_price_check","tier":"metered","price_usdc":"0.02","endpoint":"https://onyx-actions.onrender.com/v1/onyx_retail_price_check","method":"POST","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"Full product page URL (http/https). The exact page whose price + availability you want observed."},"expect_price":{"type":"number","description":"Optional. A price you believe is current. If given, the result includes matches_expected:bool + drift so a caller can detect a stale/hallucinated quote."}},"required":["url"]},"description":"Ground-truth retail oracle. Give a product URL; get the real current price, currency, and in-stock state as actually fetched now — with the extraction source (JSON-LD / OpenGraph / microdata) as evidence. Covers the long tail of no-API shops where agents otherwise hallucinate prices. Never guesses: returns price=None with confidence='none' when the page exposes no machine-readable price. Use before an agent quotes, compares, or transacts on a price it would otherwise invent.","when_to_use":"Before an agent quotes, compares, or transacts on a retail price — especially for shops with no official price API, where the agent would otherwise hallucinate. Also to detect a stale/invented cached price via expect_price drift.","vs_alternatives":"Official retail APIs (Shopify Catalog, Kroger, Tesco) only cover merchants who built them — the regional long tail is invisible. Generic 'fetch this URL' tools return raw HTML and make the agent parse (and mis-parse) it. This returns ONE structured, sourced, timestamped observation with an explicit confidence and never-guess guarantee.","example_request":{"url":"https://www.example-shop.com/product/123","expect_price":49.9},"example_response":{"ok":true,"price":49.9,"currency":"EUR","in_stock":true,"extraction_source":"jsonld","confidence":"high","matches_expected":true},"settle_to":"0x3fD9ee1373562f894D322B37DFFAd7a5D2b2d78f","network":"base","facilitator":"https://facilitator.xpay.sh","payment_required":true,"free_introspection":true,"note":"GET this URL = free introspection card. POST with x402 payment header to call."}