VOLROC REFERENCEedition reference-v1.2026.08records 3bindings 53
reference.volroc.ai  /  reference api
Reference API

Resolve identifiers. Retrieve sealed records.

A small, stable, read-only JSON interface over the Reference. No account, no key, no VolRoc software. This is the Reference API; the VolRoc Observatory statistics API is documented separately.

01 Endpoints
Method & pathReturns
GET /reference/v1/Discovery root
GET /reference/v1/editions/index.jsonEditions catalog
GET /reference/v1/editions/reference-v1.2026.07.jsonPer-edition public metadata
GET /reference/v1/vocabulary.jsonSealed resolution vocabulary (authoritative)
GET /reference/v1/propositions/index.jsonPublished propositions index
GET /reference/v1/propositions/{proposition_id}.jsonCanonical proposition: bindings, legs, relation, divergence
GET /reference/v1/resolve/{venue}/{venue_native_id}.jsonVenue-native id -> canonical proposition id
GET /reference/v1/resolve/index.jsonResolver coverage
GET /reference/v1/changes/index.jsonChange Ledger (currently empty)
GET /reference/v1/search-index.jsonStatic search index
02 Example

Resolve, then dereference

# Resolve a Kalshi ticker to its canonical proposition
$ curl -s https://reference.volroc.ai/reference/v1/resolve/kalshi/KXWCGOALLEADER-26-KMBA.json

# Retrieve the canonical proposition it maps to
$ curl -s https://reference.volroc.ai/reference/v1/propositions/prop:wc2026:golden_boot:player.json

# Percent-encoded form of the same id (colons -> %3A) also resolves
$ curl -s https://reference.volroc.ai/reference/v1/propositions/prop%3Awc2026%3Agolden_boot%3Aplayer.json
03 Contracts

What the interface guarantees

  • An unknown identifier returns HTTP 404 — an unresolved lookup is a measurement, never a fabricated mapping.
  • status: bound is Edition-scoped: it means a venue market was adjudicated in the sealed Edition as referring to the canonical proposition. It does not assert current market state, settlement, rule equivalence, future editions, or any inferred relationship.
  • Divergence is carried on the relation between two propositions, never per binding.
  • Proposition identifiers contain verbatim colons; both the raw and the percent-encoded (%3A) forms resolve.
04 Deliberately absent

The free/commercial boundary

The public interface deliberately omits: point-in-time queries (?as_of=), historical bindings and identity vintages, full criteria text at arbitrary dates, and any authenticated or write path. The present canonical state is free; the historical record is the commercial layer.