Sign in

v1

latestOpenAPI 3.1.02026-07-2610451.5 KB

One event with all linked markets, cross-venue prices, catalysts, and resolution detail

get/v1/events/{slug}

Path parameters

slugstring required

Event slug OR ClearMarket event_id — both resolve

Query parameters

detail'full' | 'concise'

Response

Event fields FLATTENED at the top level (not wrapped in an event key), plus linked markets and resolution log

event_idstring required

ClearMarket canonical event ID. Format: 'CM-EVT-' + 9-char vowel-free base36 + 1-char mod-10 check digit. Stable forever — never changes.

slugstring required

Human-readable URL form. Can change; not a stable identifier.

questionstring required

ClearMarket-canonical normalized English question text.

category'economics' | 'financials' | 'crypto' | 'companies' | 'technology' | 'health' | 'politics' | 'geopolitics' | 'climate' required

Top-level institutional classification. 9-enum (matches classify.py CATEGORIES_IN).

tagsstring[]

Cross-cutting filter tags (editorial + platform).

primary_market_idstring nullable

FK to markets.market_id. The market quoted as the event's headline price. Auto-computed nightly unless locked.

primary_market_lockedboolean

Editorial override flag. If true, primary_market_id is not auto-recomputed.

publishedboolean required

API gate. If false, event is internal-only and excluded from public API responses.

editorial_notesstring nullable

Public-facing editorial context (why this event is grouped, source quality caveats, cross-platform observations). Surfaced in API responses — this is the editorial layer platforms don't ship.

venue'kalshi' | 'polymarket' | 'null' nullable

Primary venue this event was ingested from. (Cross-venue coverage is surfaced via venues_covered at serve time.)

bundle_type'categorical' | 'date_ladder' | 'strike_ladder' | 'augmented_negrisk' | 'singleton' | 'null' nullable

Resolution-inheritance shape of the event's child markets (OCC class->series analog). Determines which resolution fields are event-level shared vs per-child native.

resolution_referencestring nullable

Generic, subject-free event-level resolution ontology (the OCC class-level settlement rule): the data source, mechanism, and deadline that resolve ANY outcome in this event, inherited by all children. Never names a specific child's subject; per-child references are composed from this plus each child's group_item_title.

created_atstring date-time required

Row creation timestamp (TIMESTAMPTZ).

updated_atstring date-time required

Last update timestamp (TIMESTAMPTZ).

venues_coveredstring[]

DERIVED AT API SERVE TIME. Distinct platform values across all markets linked to this event.

current_primary_markobject nullable

DERIVED AT API SERVE TIME. Latest marks row for the event's primary_market_id. Shape matches the marks schema response.

field_provenanceobject

Per-field provenance. Keys are field names; values are objects with 'source' ('platform_api' / 'clearmarket_editorial' / 'derived') and optional metadata.