{"release":"v1","network":"eip155:8453","chargeable":true,"request":{"product":"decision-journal","method":"POST","path":"/api/v1/decision/journal","content_type":"application/json","example_input":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}},"input_schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":180},"horizon":{"type":"string","minLength":1,"maxLength":40},"reference_value":{"type":["number","null"]},"direction":{"type":["string","null"],"enum":["up","down","neutral",null]},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"context":{"type":"object"},"notes":{"type":["string","null"],"maxLength":4000}},"required":["subject","horizon"]},"free_quote":{"method":"POST","path":"/api/v1/quote","body":{"product_id":"decision-journal","input":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}}}},"docs":"/docs.md","openapi":"/openapi.json","output":{"example":{"decision_id":"dec_example","subject":"BTC setup","horizon":"4h","direction":"up","confidence":0.6,"context_hash":"sha256"}},"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-journal","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-journal","input":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}}},"purpose":"Validate product selection and input structure without initiating payment."},{"step":"request_unsigned","method":"POST","path":"/api/v1/decision/journal","content_type":"application/json","body_example":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}},"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/journal","content_type":"application/json","body_example":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}},"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."]}