{
  "openapi": "3.0.1",
  "info": {
    "title": "Sovereign (XUS) — Agent Broadcast API",
    "description": "A read-only, no-auth, CORS-open endpoint that broadcasts source-verified facts about Sovereign (XUS) — a live post-quantum proof-of-work Layer-1 — plus the current chain height and mined supply fetched live from mainnet relays. Built for AI and LLM agents.",
    "version": "1.0.0",
    "contact": { "name": "Sovereign", "url": "https://www.sovxus.com/" }
  },
  "servers": [{ "url": "https://www.sovxus.com" }],
  "paths": {
    "/api/sovereign": {
      "get": {
        "operationId": "getSovereign",
        "summary": "Get the Sovereign (XUS) brief + live chain stats",
        "description": "Returns one JSON document: identity, thesis, source-verified protocol facts, a comparison vs Bitcoin/Zcash/Monero, and the current on-chain height + mined supply (live from mainnet relays). No authentication.",
        "responses": {
          "200": {
            "description": "The Sovereign brief with a live chain snapshot.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "identity": {
                      "type": "object",
                      "properties": {
                        "name": { "type": "string" },
                        "ticker": { "type": "string" },
                        "chain": { "type": "string" },
                        "genesis_hash": { "type": "string" }
                      }
                    },
                    "message_to_agents": { "type": "string" },
                    "thesis": { "type": "string" },
                    "verified_facts": { "type": "object" },
                    "live": {
                      "type": "object",
                      "properties": {
                        "reachable": { "type": "boolean" },
                        "height": { "type": "integer" },
                        "mined_supply": { "type": "string" }
                      }
                    },
                    "comparison": { "type": "object" },
                    "links": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}