{"openapi":"3.1.0","x-pricing":{"currency":"USDC","pricing_version":"estimated-cost-plus-2026-09-29-v1","pricing_basis":"conservative_variable_cost_estimate","cost_multiplier":3,"minimum_transaction_usdc":"0.10","explanation":"The price is fixed before payment: a conservative estimate of the variable cost of one research attempt for the tier (search, model, compute, database, settlement), multiplied by the configured markup. Actual usage is recorded per request; there is no usage surcharge or automatic price true-up.","network":"eip155:8453","mode":"live","tiers":[{"tier":"quick","amount":"0.23","searches":2,"pages_examined":5,"max_offers_interpreted":8},{"tier":"standard","amount":"0.34","searches":3,"pages_examined":8,"max_offers_interpreted":14},{"tier":"deep","amount":"0.49","searches":4,"pages_examined":12,"max_offers_interpreted":24}],"policy":"Pay per research request, including completed results with few or no comparable offers. Provider failures may be retried twice at no additional charge using the same Idempotency-Key. No automatic refunds; uncertain settlements require reconciliation."},"info":{"title":"Market Price Finder","version":"1.0.0","description":"Pay-per-request current market price research for AI agents: comparable public offers with verbatim evidence, preserved original prices, explicit normalization and verified/inferred/unknown status on every fact. x402 v2 USDC on Base. Operated by Active Life Hub LLC. The service does not sell products. The Idempotency-Key is also the secret result access token."},"servers":[{"url":"https://marketpricefinder.online"}],"paths":{"/api/v1/health":{"get":{"operationId":"health","summary":"Configuration-only liveness; ?ready=1 adds a CDN-cached database probe","parameters":[{"name":"ready","in":"query","required":false,"schema":{"enum":["1"]}}],"responses":{"200":{"description":"Ready","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/pricing":{"get":{"operationId":"pricing","summary":"Read configured prices, research limits, mode and payment policy","responses":{"200":{"description":"Pricing","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/quote":{"post":{"operationId":"quote","summary":"Validate input and see the current price before paying","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PriceRequest"},{"type":"string","minLength":3,"maxLength":2000}]}},"text/plain":{"schema":{"type":"string","minLength":3,"maxLength":2000}}}},"responses":{"200":{"description":"Quote and x402 payment requirements","content":{"application/json":{"schema":{"type":"object","properties":{"pricing_version":{"type":"string"},"pricing_basis":{"const":"conservative_variable_cost_estimate"},"amount":{"type":"string"},"currency":{"const":"USDC"},"tier":{"type":"string"},"mode":{"enum":["demo","live"]},"network":{"type":"string"},"policy":{"type":"string"},"payment":{"$ref":"#/components/schemas/PaymentRequired"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Price exceeds max_price_usdc; nothing charged","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Not ready; no payment accepted","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/api/v1/prices":{"post":{"operationId":"findPrices","summary":"Pay for and receive current, evidence-backed market prices","description":"Send JSON or text/plain, maximum 16 KiB. Without PAYMENT-SIGNATURE the response is an x402 402 challenge. Normal completion is synchronous (typically 30–120 s). Payment settles before research. After an interruption or a paid provider failure, resend the identical body with the same Idempotency-Key and Authorization: Bearer <Idempotency-Key> (no new payment); two free retries are allowed. A completed result with few or no comparable offers is charged. Do not sign a new payment after settlement_unknown.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Random secret unique to this request. Also used as Bearer token for retrieval.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,128}$"}},{"name":"Authorization","in":"header","required":false,"description":"Bearer <Idempotency-Key>: replay a completed request or claim a free retry without paying again.","schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64-encoded x402 v2 EIP-3009 payment payload. Demo only: demo:<Idempotency-Key>.","schema":{"type":"string","maxLength":16000}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PriceRequest"},{"type":"string","minLength":3,"maxLength":2000}]}},"text/plain":{"schema":{"type":"string","minLength":3,"maxLength":2000}}}},"responses":{"200":{"description":"Completed price result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceResult"}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64 settlement receipt","schema":{"type":"string"}}}},"202":{"description":"Existing request in progress","content":{"application/json":{"schema":{"type":"object","required":["request_id","status","paid","retryable"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"enum":["settling","processing","failed","settlement_unknown","payment_failed"]},"paid":{"type":"boolean"},"retryable":{"type":"boolean"},"error":{"type":"object"}}}}}},"400":{"description":"Invalid input or missing Idempotency-Key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"PAYMENT-REQUIRED":{"description":"Base64 x402 v2 payment requirements","schema":{"type":"string"}}}},"409":{"description":"Request key conflict or reused payment","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"413":{"description":"Body over 16 KiB","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"422":{"description":"Price exceeds max_price_usdc; no payment requested","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Rate limited; obey Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Provider failure, uncertain settlement or missing configuration","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},{"type":"object","required":["request_id","status","paid","retryable"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"enum":["settling","processing","failed","settlement_unknown","payment_failed"]},"paid":{"type":"boolean"},"retryable":{"type":"boolean"},"error":{"type":"object"}}}]}}}}}}},"/api/v1/requests/{id}":{"get":{"operationId":"getRequest","summary":"Retrieve a private result or status","security":[{"ResultAccess":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Completed price result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceResult"}}}},"202":{"description":"Processing","content":{"application/json":{"schema":{"type":"object","required":["request_id","status","paid","retryable"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"enum":["settling","processing","failed","settlement_unknown","payment_failed"]},"paid":{"type":"boolean"},"retryable":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Access key missing","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"404":{"description":"Unknown request or wrong key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"503":{"description":"Failed or settlement uncertain","content":{"application/json":{"schema":{"type":"object","required":["request_id","status","paid","retryable"],"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"enum":["settling","processing","failed","settlement_unknown","payment_failed"]},"paid":{"type":"boolean"},"retryable":{"type":"boolean"},"error":{"type":"object"}}}}}}}}}},"components":{"securitySchemes":{"ResultAccess":{"type":"http","scheme":"bearer","description":"Original Idempotency-Key"}},"schemas":{"PriceRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":3,"maxLength":2000},"model":{"type":"string","minLength":1,"maxLength":500},"sku":{"type":"string","minLength":1,"maxLength":500},"part_number":{"type":"string","minLength":1,"maxLength":500},"gtin":{"type":"string","pattern":"^\\d{8,14}$"},"specifications":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"quantity":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"unit":{"type":"string","minLength":1,"maxLength":60},"condition":{"default":"any","type":"string","enum":["new","used","refurbished","any"]},"market":{"default":{},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$"},"region":{"type":"string","minLength":1,"maxLength":500},"city":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"delivery":{"type":"string","minLength":1,"maxLength":500},"tax":{"default":"any","type":"string","enum":["included","excluded","any"]},"buyer_type":{"default":"any","type":"string","enum":["b2b","b2c","any"]},"channel":{"default":"any","type":"string","enum":["retail","wholesale","any"]},"exclude":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"max_results":{"default":8,"type":"integer","minimum":1,"maximum":20},"max_acceptable_price":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"tier":{"default":"standard","type":"string","enum":["quick","standard","deep"]},"preferred_output_language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$"},"search_languages":{"maxItems":4,"type":"array","items":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$"}},"max_price_usdc":{"type":"number","exclusiveMinimum":0,"maximum":1000}},"required":["query"],"additionalProperties":false},"PriceResult":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"},"status":{"type":"string","const":"completed"},"mode":{"type":"string","enum":["demo","live"]},"query":{"type":"object","properties":{"query":{"type":"string","minLength":3,"maxLength":2000},"model":{"type":"string","minLength":1,"maxLength":500},"sku":{"type":"string","minLength":1,"maxLength":500},"part_number":{"type":"string","minLength":1,"maxLength":500},"gtin":{"type":"string","pattern":"^\\d{8,14}$"},"specifications":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"quantity":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"unit":{"type":"string","minLength":1,"maxLength":60},"condition":{"default":"any","type":"string","enum":["new","used","refurbished","any"]},"market":{"default":{},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$"},"region":{"type":"string","minLength":1,"maxLength":500},"city":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"delivery":{"type":"string","minLength":1,"maxLength":500},"tax":{"default":"any","type":"string","enum":["included","excluded","any"]},"buyer_type":{"default":"any","type":"string","enum":["b2b","b2c","any"]},"channel":{"default":"any","type":"string","enum":["retail","wholesale","any"]},"exclude":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"max_results":{"default":8,"type":"integer","minimum":1,"maximum":20},"max_acceptable_price":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"tier":{"default":"standard","type":"string","enum":["quick","standard","deep"]},"preferred_output_language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$"},"search_languages":{"maxItems":4,"type":"array","items":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$"}},"max_price_usdc":{"type":"number","exclusiveMinimum":0,"maximum":1000}},"required":["query","specifications","condition","market","tax","buyer_type","channel","exclude","max_results","tier"],"additionalProperties":false},"normalized_query":{"type":"object","properties":{"item":{"type":"string"},"kind":{"type":"string","enum":["product","part","material","service","subscription","api_usage","other"]},"identifiers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}},"required":["type","value"],"additionalProperties":false}},"specifications":{"type":"array","items":{"type":"string"}},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"condition":{"type":"string"}},"required":["item","kind","identifiers","specifications","quantity","unit","condition"],"additionalProperties":false},"market":{"type":"object","properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"type":"string","enum":["explicit","global"]},"default_currency":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","city","description","scope","default_currency"],"additionalProperties":false},"currency":{"type":"object","properties":{"comparison":{"anyOf":[{"type":"string"},{"type":"null"}]},"basis":{"type":"string","enum":["requested","market_default","dominant_observed","none"]}},"required":["comparison","basis"],"additionalProperties":false},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"language":{"type":"object","properties":{"request":{"type":"string"},"request_confidence":{"type":"string","enum":["high","low"]},"output":{"type":"string"},"output_basis":{"type":"string","enum":["explicit","detected","fallback"]},"search":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["request","request_confidence","output","output_basis","search","sources","note"],"additionalProperties":false},"search_plan":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"language":{"type":"string"}},"required":["query","language"],"additionalProperties":false}},"summary":{"type":"object","properties":{"status":{"type":"string","enum":["computed","insufficient_comparable_offers","no_offers"]},"primary_group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"statistics":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string"},"basis":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"median":{"type":"number"},"mean":{"type":"number"},"p25":{"anyOf":[{"type":"number"},{"type":"null"}]},"p75":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["count","currency","basis","min","max","median","mean","p25","p75"],"additionalProperties":false},{"type":"null"}]},"offers_found":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offers_in_statistics":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"explanation":{"type":"string"}},"required":["status","primary_group_id","statistics","offers_found","offers_in_statistics","explanation"],"additionalProperties":false},"comparison_groups":{"type":"array","items":{"type":"object","properties":{"group_id":{"type":"string"},"label":{"type":"string"},"primary":{"type":"boolean"},"criteria":{"type":"object","properties":{"match":{"type":"string"},"condition":{"type":"string"},"pricing_type":{"type":"string"},"comparison_basis":{"type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["match","condition","pricing_type","comparison_basis","currency"],"additionalProperties":false},"offer_ids":{"type":"array","items":{"type":"string"}},"statistics":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string"},"basis":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"median":{"type":"number"},"mean":{"type":"number"},"p25":{"anyOf":[{"type":"number"},{"type":"null"}]},"p75":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["count","currency","basis","min","max","median","mean","p25","p75"],"additionalProperties":false},{"type":"null"}]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["group_id","label","primary","criteria","offer_ids","statistics","note"],"additionalProperties":false}},"offers":{"type":"array","items":{"type":"object","properties":{"offer_id":{"type":"string"},"seller":{"type":"object","properties":{"name":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"domain":{"type":"string"},"type":{"type":"string","enum":["retailer","manufacturer","distributor","wholesaler","marketplace_listing","service_provider","software_vendor","other"]}},"required":["name","domain","type"],"additionalProperties":false},"title":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"title_translation":{"anyOf":[{"type":"string"},{"type":"null"}]},"model_sku":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"source_url":{"type":"string","format":"uri"},"source_type":{"type":"string","enum":["seller_page","official_pricing_page","manufacturer_page","marketplace_listing","secondary_source"]},"source_language":{"type":"string"},"retrieval":{"type":"object","properties":{"method":{"type":"string","enum":["direct_fetch","extraction_service","demo_fixture"]},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"structured_data_found":{"type":"boolean"}},"required":["method","retrieved_at","structured_data_found"],"additionalProperties":false},"price":{"type":"object","properties":{"original":{"type":"string"},"value":{"type":"number"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"value_status":{"type":"string","enum":["verified","inferred","unknown"]},"currency_status":{"type":"string","enum":["verified","inferred","unknown"]},"currency_basis":{"type":"string"},"type":{"type":"string","enum":["one_time","recurring","usage_based","unknown"]},"billing_period":{"anyOf":[{"type":"string","enum":["day","week","month","quarter","year"]},{"type":"null"}]}},"required":["original","value","currency","value_status","currency_status","currency_basis","type","billing_period"],"additionalProperties":false},"quantity":{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"unit":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"unit_price":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"per":{"type":"string"},"status":{"type":"string","const":"inferred"},"method":{"type":"string"}},"required":["value","currency","per","status","method"],"additionalProperties":false},{"type":"null"}]},"normalized":{"anyOf":[{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string"},"basis":{"type":"string"},"conversion":{"anyOf":[{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"rate":{"type":"number"},"source":{"type":"string"},"source_url":{"type":"string"},"rate_date":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["from","to","rate","source","source_url","rate_date","retrieved_at"],"additionalProperties":false},{"type":"null"}]},"steps":{"type":"array","items":{"type":"string"}}},"required":["amount","currency","basis","conversion","steps"],"additionalProperties":false},{"type":"null"}]},"minimum_order_quantity":{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"condition":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"availability":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"normalized":{"type":"string","enum":["in_stock","out_of_stock","preorder","discontinued","limited","unknown"]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","normalized","status","basis"],"additionalProperties":false},"shipping":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"taxes_fees":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["verified","inferred","unknown"]},"basis":{"type":"string","enum":["structured_data","page_text","rule","model","none"]}},"required":["value","status","basis"],"additionalProperties":false},"freshness":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"status":{"type":"string","enum":["observed_at_retrieval","provider_retrieved","stale_indicator","demo"]},"price_valid_until":{"anyOf":[{"type":"string"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}}},"required":["retrieved_at","status","price_valid_until","notes"],"additionalProperties":false},"match":{"type":"object","properties":{"quality":{"type":"string","enum":["exact","equivalent","similar"]},"reason":{"type":"string"},"differences":{"type":"array","items":{"type":"string"}}},"required":["quality","reason","differences"],"additionalProperties":false},"comparability":{"type":"object","properties":{"group_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"in_statistics":{"type":"boolean"},"excluded_reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["group_id","in_statistics","excluded_reason"],"additionalProperties":false},"within_max_acceptable_price":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"source_url":{"type":"string","format":"uri"},"quote":{"type":"string"},"basis":{"type":"string","enum":["structured_data","page_text"]},"source_language":{"type":"string"},"quote_translation":{"anyOf":[{"type":"string"},{"type":"null"}]},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["field","source_url","quote","basis","source_language","quote_translation","retrieved_at"],"additionalProperties":false}},"confidence":{"type":"string","enum":["high","medium","low"]},"confidence_basis":{"type":"string"}},"required":["offer_id","seller","title","title_translation","model_sku","source_url","source_type","source_language","retrieval","price","quantity","unit","unit_price","normalized","minimum_order_quantity","condition","availability","shipping","taxes_fees","freshness","match","comparability","within_max_acceptable_price","evidence","confidence","confidence_basis"],"additionalProperties":false}},"exchange_rates":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"rate":{"type":"number"},"source":{"type":"string"},"source_url":{"type":"string"},"rate_date":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["from","to","rate","source","source_url","rate_date","retrieved_at"],"additionalProperties":false}},"excluded_candidates":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"reason":{"type":"string"}},"required":["url","reason"],"additionalProperties":false}},"limitations":{"type":"array","items":{"type":"string"}},"price":{"type":"object","properties":{"amount":{"type":"string"},"currency":{"type":"string","const":"USDC"},"tier":{"type":"string"},"network":{"type":"string"}},"required":["amount","currency","tier","network"],"additionalProperties":false}},"required":["request_id","status","mode","query","normalized_query","market","currency","started_at","completed_at","language","search_plan","summary","comparison_groups","offers","exchange_rates","excluded_candidates","limitations","price"],"additionalProperties":false},"PaymentRequired":{"type":"object","required":["x402Version","resource","accepts"],"properties":{"x402Version":{"const":2},"resource":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"accepts":{"type":"array","items":{"type":"object","required":["scheme","network","amount","asset","payTo","maxTimeoutSeconds"],"properties":{"scheme":{"const":"exact"},"network":{"enum":["eip155:8453","eip155:84532"]},"amount":{"type":"string","description":"USDC atomic units, 6 decimals"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object"}}}}}}}}}