{"openapi":"3.1.0","info":{"title":"Real-World Odds Oracle API","description":"The true odds, proven. A paid, evidence-backed decision oracle for data-resolvable prediction markets. Every probability is produced by a deterministic engine; the API reads a market, compares it to the independent probability net of uncertainty and cost, and commits a tamper-evident receipt.","contact":{"name":"Real-World Odds Oracle","email":"jennyoliver630@gmail.com"},"version":"1.0.0"},"paths":{"/v1/check-market":{"post":{"tags":["services"],"summary":"Price and compare one supported market","operationId":"check_market_v1_check_market_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckMarketRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckMarketResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/cross-venue-edge":{"post":{"tags":["services"],"summary":"Compare two candidate-equivalent contracts across venues","operationId":"cross_venue_v1_cross_venue_edge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossVenueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossVenueResponse"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/calibration":{"get":{"tags":["calibration"],"summary":"Public calibration summary","operationId":"calibration_all_v1_calibration_get","parameters":[{"name":"probability_band","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Probability Band"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calibration/{family}":{"get":{"tags":["calibration"],"summary":"Calibration Family","operationId":"calibration_family_v1_calibration__family__get","parameters":[{"name":"family","in":"path","required":true,"schema":{"type":"string","title":"Family"}},{"name":"probability_band","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Probability Band"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calibration/{family}/{model_version}":{"get":{"tags":["calibration"],"summary":"Calibration Family Model","operationId":"calibration_family_model_v1_calibration__family___model_version__get","parameters":[{"name":"family","in":"path","required":true,"schema":{"type":"string","title":"Family"}},{"name":"model_version","in":"path","required":true,"schema":{"type":"string","title":"Model Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/healthz":{"get":{"tags":["ops"],"summary":"Cheap liveness check","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/readyz":{"get":{"tags":["ops"],"summary":"Readiness: engine, ledger, paths, artifacts","operationId":"readyz_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/version":{"get":{"tags":["ops"],"summary":"Version","operationId":"version_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/service-metadata":{"get":{"tags":["ops"],"summary":"ASP service catalog","operationId":"service_metadata_v1_service_metadata_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/supported-markets":{"get":{"tags":["ops"],"summary":"Coverage: venues, families, series","operationId":"supported_markets_v1_supported_markets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evidence/status":{"get":{"tags":["ops"],"summary":"Evidence ledger + calibration status","operationId":"evidence_status_v1_evidence_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/receipts/{record_hash}":{"get":{"tags":["receipts"],"summary":"Fetch a decision receipt","operationId":"get_receipt_v1_receipts__record_hash__get","parameters":[{"name":"record_hash","in":"path","required":true,"schema":{"type":"string","title":"Record Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipts/{record_hash}/verify":{"get":{"tags":["receipts"],"summary":"Verify a receipt against the chain","operationId":"verify_receipt_v1_receipts__record_hash__verify_get","parameters":[{"name":"record_hash","in":"path","required":true,"schema":{"type":"string","title":"Record Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CalibrationContext":{"properties":{"status":{"type":"string","title":"Status","default":"accumulating"},"scope":{"additionalProperties":true,"type":"object","title":"Scope"},"independent_resolved_events":{"type":"integer","title":"Independent Resolved Events","default":0},"next_checkpoint":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Checkpoint"},"promotion_eligible":{"type":"boolean","title":"Promotion Eligible","default":false},"criteria":{"additionalProperties":true,"type":"object","title":"Criteria"}},"additionalProperties":true,"type":"object","title":"CalibrationContext"},"CheckMarketRequest":{"properties":{"market":{"$ref":"#/components/schemas/MarketRef"},"include":{"$ref":"#/components/schemas/IncludeOptions"}},"additionalProperties":false,"type":"object","required":["market"],"title":"CheckMarketRequest","example":{"include":{"calibration":true,"receipt":true,"why_trace":true},"market":{"market_id":"KXHIGHNY-26JUL12-B85","venue":"kalshi"}}},"CheckMarketResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"service":{"type":"string","title":"Service"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"market":{"additionalProperties":true,"type":"object","title":"Market"},"forecast":{"anyOf":[{"$ref":"#/components/schemas/Forecast"},{"type":"null"}]},"market_comparison":{"anyOf":[{"$ref":"#/components/schemas/MarketComparison"},{"type":"null"}]},"why":{"anyOf":[{"$ref":"#/components/schemas/WhyTrace"},{"type":"null"}]},"calibration":{"anyOf":[{"$ref":"#/components/schemas/CalibrationContext"},{"type":"null"}]},"receipt":{"anyOf":[{"$ref":"#/components/schemas/ReceiptRef"},{"type":"null"}]},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Explanation"},"missing_capability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Missing Capability"}},"additionalProperties":true,"type":"object","required":["request_id","service","status","created_at"],"title":"CheckMarketResponse"},"CrossVenueRequest":{"properties":{"left":{"$ref":"#/components/schemas/VenueRef"},"right":{"$ref":"#/components/schemas/VenueRef"},"include":{"$ref":"#/components/schemas/IncludeOptions"}},"additionalProperties":false,"type":"object","required":["left","right"],"title":"CrossVenueRequest","example":{"left":{"market_id":"KXHIGHNY-26JUL12-B85","venue":"kalshi"},"right":{"market_id":"0xabc...","venue":"polymarket"}}},"CrossVenueResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"service":{"type":"string","title":"Service"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"left":{"additionalProperties":true,"type":"object","title":"Left"},"right":{"additionalProperties":true,"type":"object","title":"Right"},"equivalence":{"additionalProperties":true,"type":"object","title":"Equivalence"},"edge":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Edge"},"actionable":{"type":"boolean","title":"Actionable","default":false},"risk_disclosure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Disclosure"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"receipt":{"anyOf":[{"$ref":"#/components/schemas/ReceiptRef"},{"type":"null"}]}},"additionalProperties":true,"type":"object","required":["request_id","service","status","created_at"],"title":"CrossVenueResponse"},"ErrorEnvelope":{"properties":{"error":{"additionalProperties":true,"type":"object","title":"Error"},"request_id":{"type":"string","title":"Request Id"}},"additionalProperties":true,"type":"object","required":["error","request_id"],"title":"ErrorEnvelope"},"Forecast":{"properties":{"event_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Group Id"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"oracle_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Oracle Probability"},"probability_interval":{"anyOf":[{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Probability Interval"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"model_agreement":{"anyOf":[{"$ref":"#/components/schemas/ModelAgreement"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"Forecast"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IncludeOptions":{"properties":{"why_trace":{"type":"boolean","title":"Why Trace","default":true},"calibration":{"type":"boolean","title":"Calibration","default":true},"receipt":{"type":"boolean","title":"Receipt","default":true}},"additionalProperties":false,"type":"object","title":"IncludeOptions"},"MarketComparison":{"properties":{"market_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Probability"},"yes_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yes Bid"},"yes_ask":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Yes Ask"},"spread":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spread"},"side":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Side"},"gross_edge":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Edge"},"estimated_fees":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Fees"},"expected_profit_per_contract":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expected Profit Per Contract"},"expected_return_on_cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expected Return On Cost"},"actionable":{"type":"boolean","title":"Actionable","default":false},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"additionalProperties":true,"type":"object","title":"MarketComparison"},"MarketRef":{"properties":{"venue":{"type":"string","minLength":1,"title":"Venue","examples":["kalshi"]},"market_id":{"type":"string","minLength":1,"title":"Market Id","examples":["KXHIGHNY-26JUL12-B85"]},"question":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Question","description":"Optional when market_id is supplied."}},"additionalProperties":false,"type":"object","required":["venue","market_id"],"title":"MarketRef"},"ModelAgreement":{"properties":{"available":{"type":"boolean","title":"Available","default":false},"model_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Model Count"},"range":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Range"},"median":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Median"},"largest_outlier":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Largest Outlier"}},"additionalProperties":true,"type":"object","title":"ModelAgreement"},"ReceiptRef":{"properties":{"record_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Hash"},"chain_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chain Hash"},"sequence":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sequence"},"verification_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Url"}},"additionalProperties":true,"type":"object","title":"ReceiptRef"},"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"},"VenueRef":{"properties":{"venue":{"type":"string","minLength":1,"title":"Venue"},"market_id":{"type":"string","minLength":1,"title":"Market Id"}},"additionalProperties":false,"type":"object","required":["venue","market_id"],"title":"VenueRef"},"WhyTrace":{"properties":{"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"sources":{"additionalProperties":true,"type":"object","title":"Sources"},"source_freshness":{"additionalProperties":true,"type":"object","title":"Source Freshness"},"model_probabilities":{"additionalProperties":true,"type":"object","title":"Model Probabilities"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":true,"type":"object","title":"WhyTrace"}}},"servers":[{"url":"https://api.trueodd.xyz"}]}