Public endpoints for browsing prediction markets.
Market Data: Use these REST endpoints to discover active events and each contract's instrumentSymbol (e.g., GEMI-FEDJAN26-DN25). For active trading and market making, prefer Prediction Markets WebSocket streams with that instrumentSymbol.
- List Events - Discover active events and instrument symbols
- Prediction Markets WebSocket Streams - Stream prices, depth, order events, and positions
List prediction market events
Returns a paginated list of prediction market events with optional filtering by status, category, sports-market classification, and search text. Repeated values for the same filter use OR semantics; different filters combine with AND semantics.
query Parameters
statusFilter by event status (can specify multiple)
categoryFilter by category (can specify multiple). If omitted, returns events from all categories.
sportFilter by sportsMarket.sport. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request; valid combinations with no matching events return an empty result.
sports_market_typeFilter by sportsMarket.type. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_subjectFilter by sportsMarket.subject. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_scopeFilter by sportsMarket.scope.type. Repeat the parameter to match any supplied value (OR). Ordinal and range qualifiers are not inferred by this filter. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_metricFilter by sportsMarket.metric. Repeat the parameter to match any supplied value (OR). A metric can be queried without sport; use sport when its sport-specific meaning matters. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
searchSearch text to filter events by title
limitMaximum number of results to return (max 500)
offsetNumber of results to skip for pagination
List prediction market events › Responses
Successful response
Get event by ticker
Returns detailed information about a specific prediction market event.
path Parameters
eventTickerThe event ticker symbol (e.g., "BTC100K")
Get event by ticker › Responses
Successful response
idtitleslugdescriptionimageUrltypeType of prediction market
categoryseriesAtomic sports-market classification shared by every contract grouped under the event. Present only for sports events. All fields except metric are required together.
tickerThe event ticker (e.g., "BTC100K2028")
statusStatus of a prediction market
resolvedAtcreatedAtTradeable contracts within this event
volumeTotal trading volume in USD
liquidityTotal liquidity in USD
tagseffectiveDateexpiryDatesubcategoryNested category information for the event
sourceDetailsStructured data source information for price observation. Replaces the deprecated flat source string on the event and contract. Present for crypto Up/Down events. Both fields are omitted when not available.
Settlement information for resolved events
sourceDeprecated: use sourceDetails (agency + index) instead. Data source identifier for price observation. Aggregated from contracts for crypto Up/Down events.
Get strike price for event
Returns strike price information for a specific prediction market event.
Useful for crypto Up/Down contracts where the strike price becomes available at the start of the observation window (typically ~5 minutes before expiry for 5M contracts).
For Up/Down contracts, the value field will be null until the strike is captured at availableAt time.
path Parameters
eventTickerThe event ticker symbol (e.g., "BTC05M2603271950")
Get strike price for event › Responses
Successful response
valueThe strike price value. Null for "reference" type strikes where the value is determined at availableAt time. For sports contracts, this represents the derived numeric strike value (e.g. spread margin, total line, or position/rank threshold).
typeStrike or condition inequality type for contract threshold evaluation. - reference: Crypto Up/Down reference strike price captured at availableAt time. - above: Higher/Lower contract threshold. - spread: Point, run, or goal handicap spread line. - over: Total or prop threshold evaluated as strict greater than (>). - over_or_equal: Total or prop threshold evaluated as greater than or equal to (>=). - under: Total or prop threshold evaluated as strict less than (<). - under_or_equal: Position, rank, or total threshold evaluated as less than or equal to (<=).
availableAtWhen the strike price becomes available
List newly listed events
Returns a list of prediction market events created in the last 24 hours, sorted by creation date (newest first). Repeated values for the same sports-market filter use OR semantics; different filters combine with AND semantics.
query Parameters
categoryFilter by category (can specify multiple). If omitted, returns events from all categories.
sportFilter by sportsMarket.sport. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request; valid combinations with no matching events return an empty result.
sports_market_typeFilter by sportsMarket.type. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_subjectFilter by sportsMarket.subject. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_scopeFilter by sportsMarket.scope.type. Repeat the parameter to match any supplied value (OR). Ordinal and range qualifiers are not inferred by this filter. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_metricFilter by sportsMarket.metric. Repeat the parameter to match any supplied value (OR). A metric can be queried without sport; use sport when its sport-specific meaning matters. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
limitMaximum number of results to return (max 500)
offsetNumber of results to skip for pagination
List newly listed events › Responses
Successful response
List recently settled events
Returns a list of prediction market events settled in the last 24 hours, sorted by resolution date (most recently settled first). Repeated values for the same sports-market filter use OR semantics; different filters combine with AND semantics.
query Parameters
categoryFilter by category (can specify multiple). If omitted, returns events from all categories.
sportFilter by sportsMarket.sport. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request; valid combinations with no matching events return an empty result.
sports_market_typeFilter by sportsMarket.type. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_subjectFilter by sportsMarket.subject. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_scopeFilter by sportsMarket.scope.type. Repeat the parameter to match any supplied value (OR). Ordinal and range qualifiers are not inferred by this filter. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_metricFilter by sportsMarket.metric. Repeat the parameter to match any supplied value (OR). A metric can be queried without sport; use sport when its sport-specific meaning matters. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
limitMaximum number of results to return (max 500)
offsetNumber of results to skip for pagination
List recently settled events › Responses
Successful response
List upcoming events
Returns a list of approved prediction market events that are not yet active (pre-launch), sorted by start time (soonest first). Repeated values for the same sports-market filter use OR semantics; different filters combine with AND semantics.
query Parameters
categoryFilter by category (can specify multiple). If omitted, returns events from all categories.
sportFilter by sportsMarket.sport. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request; valid combinations with no matching events return an empty result.
sports_market_typeFilter by sportsMarket.type. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_subjectFilter by sportsMarket.subject. Repeat the parameter to match any supplied value (OR). Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_scopeFilter by sportsMarket.scope.type. Repeat the parameter to match any supplied value (OR). Ordinal and range qualifiers are not inferred by this filter. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
sports_market_metricFilter by sportsMarket.metric. Repeat the parameter to match any supplied value (OR). A metric can be queried without sport; use sport when its sport-specific meaning matters. Sports-market filters compose independently using AND. Unsupported enum values return 400 Bad Request.
limitMaximum number of results to return (max 500)
offsetNumber of results to skip for pagination
List upcoming events › Responses
Successful response
List event categories
Returns available prediction market event categories, optionally filtered by event status.
query Parameters
statusFilter categories by event status
List event categories › Responses
Successful response
categories