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.

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

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.

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.