{"openapi":"3.1.0","info":{"title":"The Truth — 4-Pillar Thermodynamic Reference Agent API","version":"1.1.0","description":"Strictly read-only, 0-credit API exposing the 4 canonical reference pillars of The Truth: (1) Archive, (2) Deterministic Grading Rubric & Consistency Proof, (3) Live Gains & US M2 Benchmark, and (4) First-Principles Origin Thesis."},"servers":[{"url":"https://the-truth.ai.studio"}],"paths":{"/api/agent/pillars":{"get":{"operationId":"getReferencePillarsIndex","summary":"Fetch a compact index and headline proof across all 4 canonical reference pillars.","responses":{"200":{"description":"4-pillar summary index"}}}},"/api/agent/archive":{"get":{"operationId":"listArchivedAudits","summary":"Pillar 1: List all archived audits (strictly archive-only, 0 AI credits).","parameters":[{"name":"basket","in":"query","schema":{"type":"string","enum":["ALL","PASSED","FAILED"]}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"family","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"List of archived audit summaries"}}}},"/api/agent/audit/{ticker}":{"get":{"operationId":"getArchivedAudit","summary":"Pillar 1: Fetch full 6-invariant thermodynamic audit for an archived asset.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full archived audit"},"404":{"description":"Not archived (strictly refuses live AI pull)"}}}},"/api/agent/compare":{"get":{"operationId":"compareArchivedAudits","summary":"Pillar 1: Run side-by-side 6-invariant comparison across 2–4 archived assets.","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string"}},{"name":"mode","in":"query","schema":{"type":"string","enum":["NORMIE","GENIUS"]}}],"responses":{"200":{"description":"Side-by-side comparison matrix and PoS vs PoW analysis"},"404":{"description":"One or more requested tickers are not archived"}}}},"/api/agent/rubric":{"get":{"operationId":"getGradingRubric","summary":"Pillar 2: Fetch exact 6-invariant quantitative scoring brackets, Standard vs Sovereignty-Compromised grade curves, and 100% mathematical consistency verification across all archived assets.","responses":{"200":{"description":"Deterministic rubric and per-asset consistency proof"}}}},"/api/agent/gains":{"get":{"operationId":"getLiveGainsAndM2","summary":"Pillar 3: Fetch Passed (E > 0) vs Failed (E = 0) cohort returns across Cycle, All-Time, 180D, 1Y, 2Y, and 4Y windows plus KAS, BTC, Gold, and S&P 500 vs FRED US M2 money supply.","responses":{"200":{"description":"Live cohort gains and US M2 benchmark dataset"}}}},"/api/agent/origin-thesis":{"get":{"operationId":"getOriginThesis","summary":"Pillar 4: Fetch the 17-axiom First-Principles Origin Thesis (\"Physics Over Consensus\"), conservation equations, and 100 MJ human biological workweek ledger.","parameters":[{"name":"mode","in":"query","schema":{"type":"string","enum":["GENIUS","NORMIE"]}}],"responses":{"200":{"description":"Full 17-axiom origin thesis"}}}},"/api/agent/research":{"get":{"operationId":"researchThermodynamicArchiveGet","summary":"Answer coin, rubric consistency, M2 gains, or origin thesis questions via GET.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"mode","in":"query","schema":{"type":"string","enum":["NORMIE","GENIUS"]}}],"responses":{"200":{"description":"Deterministic reference answer"}}},"post":{"operationId":"researchThermodynamicArchive","summary":"Answer coin comparison, rubric, M2 gains, or PoS-vs-PoW questions using deterministic reference data.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string"},"mode":{"type":"string","enum":["NORMIE","GENIUS"]}}}}}},"responses":{"200":{"description":"Grounded archive-only answer with comparison matrix and deep-link"},"404":{"description":"Unarchived asset requested"}}}}}}