{
  "namespace": "volroc-reference",
  "version": "v1",
  "title": "VolRoc Reference — machine-readable namespace",
  "description": "The permanent public machine-readable namespace for VolRoc Reference: canonical proposition identity, cross-venue bindings, the resolution vocabulary, sealed editions, and the daily change ledger. Static, content-addressed where applicable, no authentication, permanently free.",
  "base_url": "https://reference.volroc.ai/reference/v1/",
  "status": "provisional",
  "status_note": "Namespace and routing are live. Edition metadata and the settlement vocabulary are derived from the sealed Reference Edition manifest and are available; the proposition, resolver, and changes surfaces remain pending. No unverified count, hash, or availability is asserted.",
  "human_documentation": "https://reference.volroc.ai/reference/api/",
  "verification": "https://reference.volroc.ai/reference/verify/",
  "endpoints": [
    {
      "id": "editions",
      "href": "https://reference.volroc.ai/reference/v1/editions/index.json",
      "status": "available",
      "description": "Index of sealed Reference Editions (id, manifest hash, vintage, distribution status). Derived from the sealed Edition manifest; identity and metadata are public, the sealed package is not downloadable (gated by P-A)."
    },
    {
      "id": "vocabulary",
      "href": "https://reference.volroc.ai/reference/v1/vocabulary.json",
      "status": "available",
      "description": "The venue-independent resolution vocabulary (five canonical settlement values). Values are ratified public doctrine; the full sealed projection hash is derived from the manifest."
    },
    {
      "id": "propositions",
      "href": "https://reference.volroc.ai/reference/v1/propositions/index.json",
      "status": "pending",
      "description": "Index of canonical propositions and their cross-venue bindings. Populates from the sealed binding registry.",
      "item_url_template": "https://reference.volroc.ai/reference/v1/propositions/{proposition_id}.json"
    },
    {
      "id": "resolve",
      "href": "https://reference.volroc.ai/reference/v1/resolve/index.json",
      "status": "pending",
      "description": "Venue-native identifier to canonical proposition resolver.",
      "resolve_url_template": "https://reference.volroc.ai/reference/v1/resolve/{venue}/{venue_id}.json",
      "venues": [
        "kalshi",
        "polymarket"
      ]
    },
    {
      "id": "changes",
      "href": "https://reference.volroc.ai/reference/v1/changes/index.json",
      "status": "pending",
      "description": "Daily change ledger. Each dated record lists propositions minted, bindings changed, criteria hash changes, divergence assignments, resolutions, and errata.",
      "record_url_template": "https://reference.volroc.ai/reference/v1/changes/{YYYY-MM-DD}.json"
    }
  ],
  "provenance": "Edition metadata and settlement vocabulary are derived from the sealed Reference Edition manifest. Proposition, resolver, and changes surfaces remain pending and are not yet sealed-backed."
}