v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB
Markets

Get market live snapshot

Provider-first market card snapshot with canonical identity, outcome labels, cached top-of-book when available, liquidity, live sports context, and explicit freshness/unavailable states.

get/api/v1/market/{condition_id}/snapshot

Path parameters

condition_idstring required

Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses.

Query parameters

expand[]string[]

Backward-compatible alias for expand. Repeatable: trust.

expandstring[]

Include trust metadata for current_price and spread_bps. Repeatable: trust.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Provider-first market snapshot

object'market_snapshot' required