{"release":"v1","network":"eip155:8453","chargeable":true,"request":{"product":"decision-preflight","method":"POST","path":"/api/v1/decision/preflight","content_type":"application/json","example_input":{"subject":"ETH 4h observation","observed_at":"2026-09-05T10:00:00Z","max_age_minutes":30,"values":[100,101,100,102,103],"required_context":{"source":"supplied"}},"input_schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":180},"observed_at":{"type":"string","format":"date-time"},"max_age_minutes":{"type":"integer","minimum":1,"maximum":10080},"values":{"type":"array","items":{"type":"number"},"maxItems":5000},"required_context":{"type":"object"}},"required":["subject","observed_at"]},"free_quote":{"method":"POST","path":"/api/v1/quote","body":{"product_id":"decision-preflight","input":{"subject":"ETH 4h observation","observed_at":"2026-09-05T10:00:00Z","max_age_minutes":30,"values":[100,101,100,102,103],"required_context":{"source":"supplied"}}}},"docs":"/docs.md","openapi":"/openapi.json","output":{"example":{"subject":"ETH 4h observation","fresh":true,"missing":[],"warnings":[],"ready":true}},"success_semantics":{"http":"2xx","settlement_header":"PAYMENT-RESPONSE","note":"A successful paid call returns the product JSON and x402 settlement evidence."},"recommended_next":[{"step":"review_request","method":"GET","path":"/api/v1/request-guide?product_id=decision-preflight","purpose":"Confirm method, schema, example input, output example and payment flow before spending."},{"step":"validate_free","method":"POST","path":"/api/v1/quote","body_example":{"product_id":"decision-preflight","input":{"subject":"ETH 4h observation","observed_at":"2026-09-05T10:00:00Z","max_age_minutes":30,"values":[100,101,100,102,103],"required_context":{"source":"supplied"}}},"purpose":"Validate product selection and input structure without initiating payment."},{"step":"request_unsigned","method":"POST","path":"/api/v1/decision/preflight","content_type":"application/json","body_example":{"subject":"ETH 4h observation","observed_at":"2026-09-05T10:00:00Z","max_age_minutes":30,"values":[100,101,100,102,103],"required_context":{"source":"supplied"}},"expect":"HTTP 402 with PAYMENT-REQUIRED"},{"step":"authorize_exact_requirement","when":"HTTP 402","instruction":"Use an x402-compatible buyer to authorize exactly the returned PAYMENT-REQUIRED requirement. Never send funds manually from documentation and never disclose a seed phrase or private key."},{"step":"retry_paid_request","method":"POST","path":"/api/v1/decision/preflight","content_type":"application/json","body_example":{"subject":"ETH 4h observation","observed_at":"2026-09-05T10:00:00Z","max_age_minutes":30,"values":[100,101,100,102,103],"required_context":{"source":"supplied"}},"required_header":"PAYMENT-SIGNATURE"},{"step":"accept_delivery","success_condition":"HTTP 2xx and PAYMENT-RESPONSE present","instruction":"Treat the purchase as complete only when the product response and settlement evidence are both returned."}]},"payment_flow":["Send the documented unsigned request.","Receive HTTP 402 with PAYMENT-REQUIRED.","Authorize the exact USDC requirement with an x402-compatible buyer.","Retry the same method/path/body with PAYMENT-SIGNATURE.","Treat the purchase as complete only after HTTP 2xx and PAYMENT-RESPONSE settlement proof."]}