{"openapi":"3.1.0","info":{"title":"Sharvora Intelligence","description":"Pay-per-request decision, quant, web and verification intelligence for autonomous agents. Production payment resources use x402 v2 on Base mainnet.","version":"v1","contact":{"name":"Sharvora Support","email":"support@sharvora.com","url":"https://sharvora.com/.well-known/security.txt"},"x-guidance":{"agent":"Start with workflows, request-guide, router, examples, and free quote. Paid operations return x402 v2 402 challenges and never auto-purchase from recommended_next.","workflows":"/api/v1/workflows","examples":"/api/v1/examples","skill":"/SKILL.md"},"x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","guidance":"Inspect each paid operation's x-payment-info and 402 response before authorizing payment."}},"servers":[{"url":"https://sharvora.com","description":"Sharvora production"}],"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/status":{"get":{"summary":"Status","operationId":"status_api_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/catalog":{"get":{"summary":"Catalog","operationId":"catalog_api_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/request-guide":{"get":{"summary":"Request Guide","description":"Free machine-facing method/schema/example guide. Never initiates payment.","operationId":"request_guide_api_v1_request_guide_get","parameters":[{"name":"product_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pricing":{"get":{"summary":"Pricing","operationId":"pricing_api_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/launch-readiness":{"get":{"summary":"Launch Readiness","operationId":"launch_readiness_api_v1_launch_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/quality":{"get":{"summary":"Quality Scorecard","description":"Public, claim-safe quality metrics backed only by settled first-party telemetry.","operationId":"quality_scorecard_api_v1_quality_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/trust":{"get":{"summary":"Trust Profile","description":"Machine-readable claim boundaries and proof surfaces for agent consumers.","operationId":"trust_profile_api_v1_trust_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/router/recommend":{"get":{"summary":"Router Recommend","description":"Free deterministic capability router; never initiates a payment.","operationId":"router_recommend_api_v1_router_recommend_get","parameters":[{"name":"goal","in":"query","required":true,"schema":{"type":"string","title":"Goal"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/quote":{"get":{"summary":"Quote Help","operationId":"quote_help_api_v1_quote_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Quote","description":"Free no-spend product quote and structural input check.\n\nThis endpoint never creates a payment challenge, signs a payment, or settles USDC. It\nexists so agents can choose a resource and catch obvious input mistakes before entering\nthe x402 payment flow. Paid-request preflight runs again immediately before settlement.","operationId":"quote_api_v1_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workflows":{"get":{"summary":"Workflows","description":"Free machine-readable workflow routing. Never initiates or authorizes payment.","operationId":"workflows_api_v1_workflows_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/examples":{"get":{"summary":"Examples","description":"Free representative examples with explicit non-live claim boundaries.","operationId":"examples_api_v1_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/providers/recommend":{"get":{"summary":"Provider Recommend","operationId":"provider_recommend_api_v1_providers_recommend_get","parameters":[{"name":"capability","in":"query","required":true,"schema":{"type":"string","title":"Capability"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/x402":{"get":{"summary":"Discovery","operationId":"discovery__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Agent Manifest","operationId":"agent_manifest__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/api-catalog":{"get":{"summary":"Api Catalog","operationId":"api_catalog__well_known_api_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"summary":"Api Catalog Head","operationId":"api_catalog_head__well_known_api_catalog_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/security.txt":{"get":{"summary":"Security Txt","description":"Publish RFC 9116-style security contact only after a monitored contact is configured.","operationId":"security_txt__well_known_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/api/v1/service-proof":{"get":{"summary":"Service Proof","operationId":"service_proof_api_v1_service_proof_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"product":"service-proof","status":"paid-delivery-ok","release":"v1","network":"eip155:8453","receipt":"sha256"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"service-proof","x-sharvora-request-guide":{"method":"GET","path":"/api/v1/service-proof","contentType":null,"exampleInput":null,"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=service-proof"},"x-sharvora-output-example":{"product":"service-proof","status":"paid-delivery-ok","release":"v1","network":"eip155:8453","receipt":"sha256"},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=service-proof","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"service-proof"}},"unsignedRequest":{"method":"GET","path":"/api/v1/service-proof","bodyExample":null},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/quant/anomaly":{"post":{"summary":"Quant Anomaly","operationId":"quant_anomaly_api_v1_quant_anomaly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeriesIn"},"example":{"values":[10,10.2,9.9,10.1,18]}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"count":5,"anomalies":[{"index":4,"value":18,"z_score":1.99,"mad_score":53.96}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"anomaly-scan","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/quant/anomaly","contentType":"application/json","exampleInput":{"values":[10,10.2,9.9,10.1,18]},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=anomaly-scan"},"x-sharvora-output-example":{"count":5,"anomalies":[{"index":4,"value":18,"z_score":1.99,"mad_score":53.96}]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=anomaly-scan","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"anomaly-scan","input":{"values":[10,10.2,9.9,10.1,18]}}},"unsignedRequest":{"method":"POST","path":"/api/v1/quant/anomaly","bodyExample":{"values":[10,10.2,9.9,10.1,18]}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/quant/risk-state":{"post":{"summary":"Quant Risk","operationId":"quant_risk_api_v1_quant_risk_state_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskSeriesIn"},"example":{"values":[100,101,99,103,102,104]}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"regime":"moderate","volatility":0.019,"max_drawdown":-0.0198,"sample_count":6}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"risk-state","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/quant/risk-state","contentType":"application/json","exampleInput":{"values":[100,101,99,103,102,104]},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=risk-state"},"x-sharvora-output-example":{"regime":"moderate","volatility":0.019,"max_drawdown":-0.0198,"sample_count":6},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=risk-state","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"risk-state","input":{"values":[100,101,99,103,102,104]}}},"unsignedRequest":{"method":"POST","path":"/api/v1/quant/risk-state","bodyExample":{"values":[100,101,99,103,102,104]}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/quant/forecast-range":{"post":{"summary":"Quant Forecast","operationId":"quant_forecast_api_v1_quant_forecast_range_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastIn"},"example":{"values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"method":"empirical-drift-normal-80","horizon_steps":4,"center":112.27,"lower_80":109.8,"upper_80":114.74,"up_probability":0.72}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"forecast-range","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/quant/forecast-range","contentType":"application/json","exampleInput":{"values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=forecast-range"},"x-sharvora-output-example":{"method":"empirical-drift-normal-80","horizon_steps":4,"center":112.27,"lower_80":109.8,"upper_80":114.74,"up_probability":0.72},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=forecast-range","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"forecast-range","input":{"values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4}}},"unsignedRequest":{"method":"POST","path":"/api/v1/quant/forecast-range","bodyExample":{"values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/quant/flow-monitor":{"post":{"summary":"Quant Flow","operationId":"quant_flow_api_v1_quant_flow_monitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowIn"},"example":{"exchange_inflow":120,"exchange_outflow":80,"bridge_inflow":30,"bridge_outflow":20,"stablecoin_inflow":50,"stablecoin_outflow":40}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"exchange_net":40,"bridge_net":10,"stablecoin_net":10,"total_net":60,"intensity":0.1765,"state":"balanced"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"flow-monitor","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/quant/flow-monitor","contentType":"application/json","exampleInput":{"exchange_inflow":120,"exchange_outflow":80,"bridge_inflow":30,"bridge_outflow":20,"stablecoin_inflow":50,"stablecoin_outflow":40},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=flow-monitor"},"x-sharvora-output-example":{"exchange_net":40,"bridge_net":10,"stablecoin_net":10,"total_net":60,"intensity":0.1765,"state":"balanced"},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=flow-monitor","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"flow-monitor","input":{"exchange_inflow":120,"exchange_outflow":80,"bridge_inflow":30,"bridge_outflow":20,"stablecoin_inflow":50,"stablecoin_outflow":40}}},"unsignedRequest":{"method":"POST","path":"/api/v1/quant/flow-monitor","bodyExample":{"exchange_inflow":120,"exchange_outflow":80,"bridge_inflow":30,"bridge_outflow":20,"stablecoin_inflow":50,"stablecoin_outflow":40}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/decision/preflight":{"post":{"summary":"Decision Preflight","operationId":"decision_preflight_api_v1_decision_preflight_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreflightIn"},"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":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"subject":"ETH 4h observation","fresh":true,"missing":[],"warnings":[],"ready":true}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"decision-preflight","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/decision/preflight","contentType":"application/json","exampleInput":{"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"}},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=decision-preflight"},"x-sharvora-output-example":{"subject":"ETH 4h observation","fresh":true,"missing":[],"warnings":[],"ready":true},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=decision-preflight","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"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"}}}},"unsignedRequest":{"method":"POST","path":"/api/v1/decision/preflight","bodyExample":{"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"}}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/decision/journal":{"post":{"summary":"Decision Journal","operationId":"decision_journal_api_v1_decision_journal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionIn"},"example":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"decision_id":"dec_example","subject":"BTC setup","horizon":"4h","direction":"up","confidence":0.6,"context_hash":"sha256"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.1"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"decision-journal","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/decision/journal","contentType":"application/json","exampleInput":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=decision-journal"},"x-sharvora-output-example":{"decision_id":"dec_example","subject":"BTC setup","horizon":"4h","direction":"up","confidence":0.6,"context_hash":"sha256"},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=decision-journal","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"decision-journal","input":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}}}},"unsignedRequest":{"method":"POST","path":"/api/v1/decision/journal","bodyExample":{"subject":"BTC setup","horizon":"4h","reference_value":100,"direction":"up","confidence":0.6,"context":{"source":"agent"}}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/decision/bundle":{"post":{"summary":"Decision Bundle","operationId":"decision_bundle_api_v1_decision_bundle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionBundleIn"},"example":{"subject":"ETH decision","observed_at":"2026-09-07T08:00:00Z","values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4,"max_age_minutes":60,"required_context":{"source":"supplied"}}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"subject":"ETH decision","readiness_score":100,"ready":true,"risk":{},"anomaly":{},"forecast":{},"warnings":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"decision-bundle","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/decision/bundle","contentType":"application/json","exampleInput":{"subject":"ETH decision","observed_at":"2026-09-07T08:00:00Z","values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4,"max_age_minutes":60,"required_context":{"source":"supplied"}},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=decision-bundle"},"x-sharvora-output-example":{"subject":"ETH decision","readiness_score":100,"ready":true,"risk":{},"anomaly":{},"forecast":{},"warnings":[]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=decision-bundle","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"decision-bundle","input":{"subject":"ETH decision","observed_at":"2026-09-07T08:00:00Z","values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4,"max_age_minutes":60,"required_context":{"source":"supplied"}}}},"unsignedRequest":{"method":"POST","path":"/api/v1/decision/bundle","bodyExample":{"subject":"ETH decision","observed_at":"2026-09-07T08:00:00Z","values":[100,101,102,101,103,104,105,104,106,107,108,109],"horizon_steps":4,"max_age_minutes":60,"required_context":{"source":"supplied"}}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/decision/audit":{"post":{"summary":"Decision Audit","operationId":"decision_audit_api_v1_decision_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditIn"},"example":{"decision_id":"dec_example","actual_value":102}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"decision_id":"dec_example","reference_value":100,"actual_value":102,"change_pct":2,"direction_hit":true}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"outcome-audit","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/decision/audit","contentType":"application/json","exampleInput":{"decision_id":"dec_example","actual_value":102},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=outcome-audit"},"x-sharvora-output-example":{"decision_id":"dec_example","reference_value":100,"actual_value":102,"change_pct":2,"direction_hit":true},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=outcome-audit","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"outcome-audit","input":{"decision_id":"dec_example","actual_value":102}}},"unsignedRequest":{"method":"POST","path":"/api/v1/decision/audit","bodyExample":{"decision_id":"dec_example","actual_value":102}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/trust-passport":{"post":{"summary":"Web Trust Passport","operationId":"web_trust_passport_api_v1_web_trust_passport_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"url":"https://example.com","score":91,"grade":"A","components":{"agent_readiness":{},"endpoint_trust":{},"redirect_audit":{},"http_policy":{},"security_headers":{},"tls":{}},"warnings":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.15"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"trust-passport","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/trust-passport","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=trust-passport"},"x-sharvora-output-example":{"url":"https://example.com","score":91,"grade":"A","components":{"agent_readiness":{},"endpoint_trust":{},"redirect_audit":{},"http_policy":{},"security_headers":{},"tls":{}},"warnings":[]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=trust-passport","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"trust-passport","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/trust-passport","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/agent-readiness":{"post":{"summary":"Web Agent","operationId":"web_agent_api_v1_web_agent_readiness_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"url":"https://example.com","score":80,"grade":"B","checks":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"agent-readiness","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/agent-readiness","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=agent-readiness"},"x-sharvora-output-example":{"url":"https://example.com","score":80,"grade":"B","checks":{}},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=agent-readiness","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"agent-readiness","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/agent-readiness","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/redirect-audit":{"post":{"summary":"Web Redirect Audit","operationId":"web_redirect_audit_api_v1_web_redirect_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"requested_url":"https://example.com","final_url":"https://example.com/","redirect_count":0,"cross_origin_hops":0,"https_downgrade_detected":false,"chain":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"redirect-audit","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/redirect-audit","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=redirect-audit"},"x-sharvora-output-example":{"requested_url":"https://example.com","final_url":"https://example.com/","redirect_count":0,"cross_origin_hops":0,"https_downgrade_detected":false,"chain":[]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=redirect-audit","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"redirect-audit","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/redirect-audit","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/endpoint-trust":{"post":{"summary":"Web Endpoint Trust","operationId":"web_endpoint_trust_api_v1_web_endpoint_trust_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"requested_url":"https://example.com","http_status":200,"risk_score":8,"risk_band":"low","static_instruction_findings":[],"missing_security_headers":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"agent-endpoint-trust","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/endpoint-trust","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=agent-endpoint-trust"},"x-sharvora-output-example":{"requested_url":"https://example.com","http_status":200,"risk_score":8,"risk_band":"low","static_instruction_findings":[],"missing_security_headers":[]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=agent-endpoint-trust","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"agent-endpoint-trust","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/endpoint-trust","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/http-policy":{"post":{"summary":"Web Http Policy","operationId":"web_http_policy_api_v1_web_http_policy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"http_status":200,"cache":{},"cors":{},"cookies":{},"policy_headers":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"http-policy","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/http-policy","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=http-policy"},"x-sharvora-output-example":{"http_status":200,"cache":{},"cors":{},"cookies":{},"policy_headers":{}},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=http-policy","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"http-policy","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/http-policy","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/security-headers":{"post":{"summary":"Web Headers","operationId":"web_headers_api_v1_web_security_headers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlIn"},"example":{"url":"https://example.com"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"url":"https://example.com","http_status":200,"score":83,"missing":["CSP"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"security-headers","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/security-headers","contentType":"application/json","exampleInput":{"url":"https://example.com"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=security-headers"},"x-sharvora-output-example":{"url":"https://example.com","http_status":200,"score":83,"missing":["CSP"]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=security-headers","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"security-headers","input":{"url":"https://example.com"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/security-headers","bodyExample":{"url":"https://example.com"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/web/tls-report":{"post":{"summary":"Web Tls","operationId":"web_tls_api_v1_web_tls_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostIn"},"example":{"host":"example.com","port":443}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"host":"example.com","port":443,"expires_at":"2026-12-01T00:00:00+00:00","days_remaining":87,"valid":true}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"tls-report","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/web/tls-report","contentType":"application/json","exampleInput":{"host":"example.com","port":443},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=tls-report"},"x-sharvora-output-example":{"host":"example.com","port":443,"expires_at":"2026-12-01T00:00:00+00:00","days_remaining":87,"valid":true},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=tls-report","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"tls-report","input":{"host":"example.com","port":443}}},"unsignedRequest":{"method":"POST","path":"/api/v1/web/tls-report","bodyExample":{"host":"example.com","port":443}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/x402/validate":{"post":{"summary":"Validate X402","operationId":"validate_x402_api_v1_x402_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402ProbeIn"},"example":{"url":"https://seller.example/paid-resource"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"http_status":402,"is_payment_required":true,"payment_required_header_present":true,"valid_402_challenge":true,"no_payment_was_signed_or_sent":true}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"x402-validator","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/x402/validate","contentType":"application/json","exampleInput":{"url":"https://seller.example/paid-resource"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=x402-validator"},"x-sharvora-output-example":{"http_status":402,"is_payment_required":true,"payment_required_header_present":true,"valid_402_challenge":true,"no_payment_was_signed_or_sent":true},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=x402-validator","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"x402-validator","input":{"url":"https://seller.example/paid-resource"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/x402/validate","bodyExample":{"url":"https://seller.example/paid-resource"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/evidence/receipt":{"post":{"summary":"Evidence Receipt","operationId":"evidence_receipt_api_v1_evidence_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceIn"},"example":{"content":"exact text to hash","label":"optional-reference"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"receipt_id":"ev_example","sha256":"64-hex-character digest","bytes":18,"onchain":false}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"evidence-receipt","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/evidence/receipt","contentType":"application/json","exampleInput":{"content":"exact text to hash","label":"optional-reference"},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=evidence-receipt"},"x-sharvora-output-example":{"receipt_id":"ev_example","sha256":"64-hex-character digest","bytes":18,"onchain":false},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=evidence-receipt","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"evidence-receipt","input":{"content":"exact text to hash","label":"optional-reference"}}},"unsignedRequest":{"method":"POST","path":"/api/v1/evidence/receipt","bodyExample":{"content":"exact text to hash","label":"optional-reference"}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}},"/api/v1/evidence/consensus":{"post":{"summary":"Evidence Consensus","operationId":"evidence_consensus_api_v1_evidence_consensus_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceConsensusIn"},"example":{"observations":[{"source":"source-a","value":100,"confidence":0.9},{"source":"source-b","value":102,"confidence":0.8}],"max_age_minutes":1440}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"source_count":2,"weighted_consensus":100.94,"agreement_score":96,"agreement":"strong","contradiction_detected":false,"observations":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements.","schema":{"type":"string"}}}},"405":{"description":"Wrong HTTP method; no payment attempted. Response includes allowed_method and request guidance."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.06"},"protocols":[{"x402":{}}]},"x-sharvora-product-id":"evidence-consensus","x-sharvora-request-guide":{"method":"POST","path":"/api/v1/evidence/consensus","contentType":"application/json","exampleInput":{"observations":[{"source":"source-a","value":100,"confidence":0.9},{"source":"source-b","value":102,"confidence":0.8}],"max_age_minutes":1440},"quoteEndpoint":"/api/v1/quote","requestGuideEndpoint":"/api/v1/request-guide?product_id=evidence-consensus"},"x-sharvora-output-example":{"source_count":2,"weighted_consensus":100.94,"agreement_score":96,"agreement":"strong","contradiction_detected":false,"observations":[]},"x-sharvora-recommended-next":{"requestGuide":"/api/v1/request-guide?product_id=evidence-consensus","freeQuote":{"method":"POST","path":"/api/v1/quote","bodyExample":{"product_id":"evidence-consensus","input":{"observations":[{"source":"source-a","value":100,"confidence":0.9},{"source":"source-b","value":102,"confidence":0.8}],"max_age_minutes":1440}}},"unsignedRequest":{"method":"POST","path":"/api/v1/evidence/consensus","bodyExample":{"observations":[{"source":"source-a","value":100,"confidence":0.9},{"source":"source-b","value":102,"confidence":0.8}],"max_age_minutes":1440}},"payment":"On HTTP 402, authorize exactly PAYMENT-REQUIRED with an x402-compatible buyer and retry with PAYMENT-SIGNATURE.","success":"Require HTTP 2xx plus PAYMENT-RESPONSE settlement evidence."}}}},"components":{"schemas":{"AuditIn":{"properties":{"decision_id":{"type":"string","maxLength":64,"minLength":8,"title":"Decision Id"},"actual_value":{"type":"number","title":"Actual Value"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"}},"type":"object","required":["decision_id","actual_value"],"title":"AuditIn"},"Body_login_login_post":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"Body_login_login_post"},"DecisionBundleIn":{"properties":{"subject":{"type":"string","maxLength":180,"minLength":1,"title":"Subject"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"values":{"items":{"type":"number"},"type":"array","maxItems":5000,"minItems":12,"title":"Values"},"horizon_steps":{"type":"integer","maximum":48.0,"minimum":1.0,"title":"Horizon Steps","default":4},"max_age_minutes":{"type":"integer","maximum":10080.0,"minimum":1.0,"title":"Max Age Minutes","default":60},"required_context":{"additionalProperties":true,"type":"object","title":"Required Context"}},"type":"object","required":["subject","observed_at","values"],"title":"DecisionBundleIn"},"DecisionIn":{"properties":{"subject":{"type":"string","maxLength":180,"minLength":1,"title":"Subject"},"horizon":{"type":"string","maxLength":40,"minLength":1,"title":"Horizon"},"reference_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reference Value"},"direction":{"anyOf":[{"type":"string","pattern":"^(up|down|neutral)$"},{"type":"null"}],"title":"Direction"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"},"context":{"additionalProperties":true,"type":"object","title":"Context"},"notes":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["subject","horizon"],"title":"DecisionIn"},"EventIn":{"properties":{"event_id":{"type":"string","maxLength":160,"minLength":6,"title":"Event Id"},"occurred_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurred At"},"endpoint":{"type":"string","maxLength":240,"minLength":1,"title":"Endpoint"},"quote_issued":{"type":"boolean","title":"Quote Issued","default":false},"payment_verified":{"type":"boolean","title":"Payment Verified","default":false},"payment_settled":{"type":"boolean","title":"Payment Settled","default":false},"price_usd":{"type":"number","maximum":1000000.0,"minimum":0.0,"title":"Price Usd","default":0},"variable_cost_usd":{"type":"number","maximum":1000000.0,"minimum":0.0,"title":"Variable Cost Usd","default":0},"delivered":{"type":"boolean","title":"Delivered","default":false},"latency_ms":{"anyOf":[{"type":"integer","maximum":3600000.0,"minimum":0.0},{"type":"null"}],"title":"Latency Ms"},"error_code":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Error Code"},"network":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Network"},"payer_id":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Payer Id"},"source_brand":{"type":"string","maxLength":60,"title":"Source Brand","default":"sharvora"}},"type":"object","required":["event_id","endpoint"],"title":"EventIn"},"EvidenceConsensusIn":{"properties":{"observations":{"items":{"$ref":"#/components/schemas/EvidenceObservationIn"},"type":"array","maxItems":50,"minItems":2,"title":"Observations"},"max_age_minutes":{"type":"integer","maximum":525600.0,"minimum":1.0,"title":"Max Age Minutes","default":1440}},"type":"object","required":["observations"],"title":"EvidenceConsensusIn"},"EvidenceIn":{"properties":{"content":{"type":"string","maxLength":200000,"minLength":1,"title":"Content"},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label"}},"type":"object","required":["content"],"title":"EvidenceIn"},"EvidenceObservationIn":{"properties":{"source":{"type":"string","maxLength":160,"minLength":1,"title":"Source"},"value":{"type":"number","title":"Value"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":1.0},"weight":{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0,"title":"Weight","default":1.0},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"}},"type":"object","required":["source","value"],"title":"EvidenceObservationIn"},"ExperimentIn":{"properties":{"name":{"type":"string","maxLength":240,"minLength":3,"title":"Name"},"hypothesis":{"type":"string","maxLength":8000,"title":"Hypothesis","default":""},"target_buyer":{"type":"string","maxLength":400,"title":"Target Buyer","default":""},"proposed_price_usd":{"anyOf":[{"type":"number","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Proposed Price Usd"},"estimated_variable_cost_usd":{"anyOf":[{"type":"number","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Estimated Variable Cost Usd"},"target_gross_margin_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":-1000.0},{"type":"null"}],"title":"Target Gross Margin Pct"},"status":{"type":"string","maxLength":60,"title":"Status","default":"idea"},"priority":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Priority","default":50}},"type":"object","required":["name"],"title":"ExperimentIn"},"FlowIn":{"properties":{"exchange_inflow":{"type":"number","title":"Exchange Inflow","default":0},"exchange_outflow":{"type":"number","title":"Exchange Outflow","default":0},"bridge_inflow":{"type":"number","title":"Bridge Inflow","default":0},"bridge_outflow":{"type":"number","title":"Bridge Outflow","default":0},"stablecoin_inflow":{"type":"number","title":"Stablecoin Inflow","default":0},"stablecoin_outflow":{"type":"number","title":"Stablecoin Outflow","default":0}},"type":"object","title":"FlowIn"},"ForecastIn":{"properties":{"values":{"items":{"type":"number"},"type":"array","maxItems":5000,"minItems":12,"title":"Values"},"horizon_steps":{"type":"integer","maximum":48.0,"minimum":1.0,"title":"Horizon Steps","default":1}},"type":"object","required":["values"],"title":"ForecastIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HostIn":{"properties":{"host":{"type":"string","maxLength":253,"minLength":1,"title":"Host"},"port":{"type":"integer","title":"Port","default":443}},"type":"object","required":["host"],"title":"HostIn"},"PreflightIn":{"properties":{"subject":{"type":"string","maxLength":180,"minLength":1,"title":"Subject"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"max_age_minutes":{"type":"integer","maximum":10080.0,"minimum":1.0,"title":"Max Age Minutes","default":30},"values":{"items":{"type":"number"},"type":"array","maxItems":5000,"title":"Values"},"required_context":{"additionalProperties":true,"type":"object","title":"Required Context"}},"type":"object","required":["subject","observed_at"],"title":"PreflightIn"},"QuoteIn":{"properties":{"product_id":{"anyOf":[{"type":"string","maxLength":80,"minLength":2},{"type":"null"}],"title":"Product Id"},"endpoint":{"anyOf":[{"type":"string","maxLength":240,"minLength":2},{"type":"null"}],"title":"Endpoint"},"input":{"anyOf":[{},{"type":"null"}],"title":"Input"}},"type":"object","title":"QuoteIn"},"RadarSnapshotIn":{"properties":{"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"source":{"type":"string","maxLength":120,"minLength":1,"title":"Source"},"resource":{"type":"string","maxLength":240,"minLength":1,"title":"Resource"},"calls_30d":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Calls 30D"},"unique_payers_30d":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Unique Payers 30D"},"last_called_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Called At"},"confidence":{"type":"string","maxLength":40,"title":"Confidence","default":"reported"}},"type":"object","required":["source","resource"],"title":"RadarSnapshotIn"},"RiskSeriesIn":{"properties":{"values":{"items":{"type":"number"},"type":"array","maxItems":5000,"minItems":5,"title":"Values"}},"type":"object","required":["values"],"title":"RiskSeriesIn"},"SeriesIn":{"properties":{"values":{"items":{"type":"number"},"type":"array","maxItems":5000,"minItems":3,"title":"Values"}},"type":"object","required":["values"],"title":"SeriesIn"},"UrlIn":{"properties":{"url":{"type":"string","maxLength":500,"minLength":4,"title":"Url"}},"type":"object","required":["url"],"title":"UrlIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"X402ProbeIn":{"properties":{"url":{"type":"string","maxLength":500,"minLength":4,"title":"Url"}},"type":"object","required":["url"],"title":"X402ProbeIn"}}},"externalDocs":{"description":"Sharvora agent documentation","url":"https://sharvora.com/docs.md"}}