{"product":"Scopes Reference","version":"reference-v1","description":"The historical, point-in-time independent record of event-market probabilities: per venue-contract-timestamp, the market price beside the independently-computed Scopes Fair Value, the divergence, liquidity, and — once resolved — the outcome. Bitemporal and append-only.","field_families":{"scopes_derived":"Scopes’ own outputs — always deliverable: identifiers, timestamps, methodology, benchmark sources, resolutions, settled outcomes.","sfv":"The Scopes Fair Value — deliverable where its input source is redistribution-clean and reviewed (e.g. poll composite, weather/catastrophe, rates-recession); withheld otherwise.","venue_derived":"Fields carrying the venue’s own price (market_probability, scopes_divergence, liquidity) — delivered only to clients with a verified entitlement to that venue, or where Scopes holds redistribution authorization for it."},"record_fields":[{"field":"event_id","type":"integer","desc":"Stable event identifier.","family":"scopes_derived"},{"field":"contract_id","type":"integer","desc":"Stable venue-contract identifier.","family":"scopes_derived"},{"field":"outcome","type":"string","desc":"Stable outcome label (e.g. Democrat, > 78°).","family":"scopes_derived"},{"field":"event_family","type":"string","desc":"Grouping key (e.g. us-midterms-2026).","family":"scopes_derived"},{"field":"desk","type":"string","desc":"rates | polls | sports | stocks | energy | weather | catastrophe.","family":"scopes_derived"},{"field":"venue","type":"string","desc":"Market venue (e.g. kalshi, polymarket).","family":"scopes_derived"},{"field":"observed_at","type":"timestamptz","desc":"WORLD time: when this market/benchmark state existed.","family":"scopes_derived"},{"field":"recorded_at","type":"timestamptz","desc":"KNOWLEDGE time: when Scopes wrote (or revised) this row.","family":"scopes_derived"},{"field":"market_probability","type":"numeric(0–1)","desc":"Venue-implied probability at observed_at.","family":"venue_derived"},{"field":"scopes_fair_value","type":"numeric(0–1)","desc":"Independently-computed fair value (never the market price).","family":"sfv"},{"field":"scopes_divergence","type":"numeric (points)","desc":"market_probability − scopes_fair_value.","family":"venue_derived"},{"field":"liquidity","type":"object","desc":"best bid/ask + sizes, spread; order-book depth where captured.","family":"venue_derived"},{"field":"benchmark_sources","type":"string[]","desc":"Model slugs + versions that fed the fair value.","family":"scopes_derived"},{"field":"methodology_version","type":"string","desc":"The versioned method under which the fair value was computed.","family":"scopes_derived"},{"field":"resolution_status","type":"string","desc":"open | resolved.","family":"scopes_derived"},{"field":"outcome_result","type":"string|null","desc":"The settled result, once resolved.","family":"scopes_derived"},{"field":"resolution_time","type":"timestamptz|null","desc":"World time of resolution (settlement).","family":"scopes_derived"},{"field":"revision_of","type":"integer|null","desc":"For a superseding row: the prior row it corrects.","family":"scopes_derived"},{"field":"revision_reason","type":"string|null","desc":"initial | correction | migration_backfill | note.","family":"scopes_derived"}],"time_dimensions":{"observed_at":"When the state existed in the world. Filtered by the `as_of` query param — no lookahead.","recorded_at":"When Scopes recorded it. Filtered by the `knowledge_as_of` param — what Scopes itself knew by a past instant.","note":"The two are independent (bitemporal). A correction recorded later than it was observed is visible under as_of but not under an earlier knowledge_as_of."},"revision_semantics":{"policy":"Scopes Reference is append-only. Corrections supersede; they never overwrite. Every revision carries its reason and its timestamp, and prior states remain queryable forever.","how":"A correction appends a new row with recorded_at = now and revision_of = the superseded row id. The latest row (by recorded_at) is the current state; earlier rows persist and are returned by an earlier knowledge_as_of."},"query_params":{"as_of":"ISO 8601. Return state observed at or before this instant (point-in-time correct, no lookahead).","knowledge_as_of":"ISO 8601. Return what Scopes had recorded by this instant. Combinable with as_of.","since":"ISO 8601. Trailing window start; capped by tier."},"delivery":{"historical_extracts":"CSV / Parquet, licensed per scope of data and use.","point_in_time_api":"/api/v1/series with as_of + knowledge_as_of.","snowflake_share":"on request","pricing":"licensed per scope of data and use — inquire"},"terms":"Delivered subject to source-data rights: venue-derived fields require a verified entitlement to that venue or Scopes’ redistribution authorization, and some Scopes Fair Values await input-source review. Bring your own venue feed to receive venue-derived fields, or receive them under Scopes’ authorization where held. Research and information only — not investment advice."}