{"openapi":"3.1.0","info":{"title":"QuanterraOS Prediction Market Telemetry API","version":"2.0.0","description":"Independent pricing, settlement radar, fee friction teardown, and empirical calibration telemetry across Kalshi and Polymarket event contracts. Strictly non-advisory, permanent $0 live capital circuit breaker (Rule B5).","contact":{"name":"Quantara Global LLC Developer Support","email":"support@quanterraos.com","url":"https://quanterraos.com/developers"},"license":{"name":"Proprietary Data License / Fair-Use Analytics","url":"https://quanterraos.com/legal"}},"servers":[{"url":"https://quanterraos.com/api/v1","description":"Production Gateway"},{"url":"http://localhost:3102/api/v1","description":"Local Development Gateway"}],"paths":{"/fees/check":{"post":{"summary":"Calculate True Cost & Breakeven Hurdle","description":"Computes non-linear Kalshi taker fee (0.07 × C × P × (1-P)), executable cost, breakeven win rate hurdle, and danger-zone hazard flags.","operationId":"calculateTrueCost","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeeCheckRequest"}}}},"responses":{"200":{"description":"Detailed fee and friction calculations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeeCheckResponse"}}}}}}},"/radar/{ticker}":{"get":{"summary":"Get Live Settlement Radar & Spot Dispersion","description":"Returns the 60-second TWAP settlement benchmark progression, constituent spot prices, and strike delta for active BTC event contracts.","operationId":"getSettlementRadar","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"KXBTC15M"}}],"responses":{"200":{"description":"Live radar and dispersion telemetry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarResponse"}}}}}}},"/sensors/trades":{"get":{"summary":"Large-Trade Whale Feed with Net-After-Fees","description":"Stream of institutional-sized event contract transactions with exact regulatory fee deductions and settlement oracle context.","operationId":"getSensorsTrades","responses":{"200":{"description":"List of large trades with net fee calculations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SensorsTradesResponse"}}}}}}},"/calibration/brier":{"get":{"summary":"Empirical Calibration Ledger & Brier Decompositions","description":"Returns verified Brier score accuracy across 1,316 settled BTC15M windows proving market mid beats model.","operationId":"getCalibrationLedger","responses":{"200":{"description":"Brier score calibration data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationResponse"}}}}}}},"/mcp":{"post":{"summary":"Model Context Protocol (MCP) JSON-RPC Gateway","description":"Executes tool requests from Claude, Cursor, and autonomous agents conforming to the MCP 2026-01-01 specification.","operationId":"executeMcpRpc","responses":{"200":{"description":"MCP tool execution result"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API Key issued via https://quanterraos.com/deck or Clerk Billing"}},"schemas":{"FeeCheckRequest":{"type":"object","required":["venue","price","contracts"],"properties":{"venue":{"type":"string","enum":["kalshi","polymarket"],"example":"kalshi"},"product":{"type":"string","example":"KXBTC15M"},"price":{"type":"number","minimum":0.01,"maximum":0.99,"example":0.5},"contracts":{"type":"integer","minimum":1,"maximum":10000,"example":100}}},"FeeCheckResponse":{"type":"object","properties":{"venue":{"type":"string","example":"kalshi"},"price":{"type":"number","example":0.5},"contracts":{"type":"integer","example":100},"totalPurchaseCostUsd":{"type":"number","example":50},"takerFeeUsd":{"type":"number","example":1.75},"feePerContractCents":{"type":"number","example":1.75},"requiredBreakevenPct":{"type":"number","example":51.75},"isDangerZone":{"type":"boolean","example":true},"dangerZoneReason":{"type":"string","example":"Coin-flip hazard zone: 40¢-60¢ contracts suffer maximum taker fee drag."},"settlementOracle":{"type":"string","example":"CME CF BRTI 60s TWAP"},"ruleB5Discharge":{"type":"string","example":"LOCKED_RULE_B5: Non-custodial computational telemetry only."}}},"RadarResponse":{"type":"object","properties":{"ticker":{"type":"string","example":"KXBTC15M"},"compositeSpotPrice":{"type":"number","example":91250},"brtiTwapProxy":{"type":"number","example":91244.5},"dispersionBps":{"type":"number","example":8.4},"dispersionStatus":{"type":"string","example":"NORMAL_DISPERSION"},"atmStrike":{"type":"number","example":91250},"secondsRemaining":{"type":"integer","example":268},"isCoinFlipHazard":{"type":"boolean","example":false}}},"SensorsTradesResponse":{"type":"object","properties":{"totalTrades":{"type":"integer","example":50},"trades":{"type":"array","items":{"type":"object","properties":{"tradeId":{"type":"string"},"venue":{"type":"string"},"ticker":{"type":"string"},"side":{"type":"string"},"priceCents":{"type":"number"},"contractCount":{"type":"integer"},"grossNotionalUsd":{"type":"number"},"estimatedFeeUsd":{"type":"number"},"netAfterFeesUsd":{"type":"number"},"settlementBasis":{"type":"string"}}}}}},"CalibrationResponse":{"type":"object","properties":{"sampleSizeWindows":{"type":"integer","example":1316},"kalshiMarketMidBrier":{"type":"number","example":0.2001},"quanterraModelBrier":{"type":"number","example":0.2063},"naiveCoinFlipBrier":{"type":"number","example":0.25},"proofConclusion":{"type":"string","example":"Kalshi market mid beats model; transparently published."}}}}}}