v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
predictfun

Get Predict Markets

List Predict.fun markets with filtering and sorting.

Returns markets from the Predict.fun prediction market platform with support for:

  • Status filtering (open, closed)
  • Market variant filtering (DEFAULT, CRYPTO_UP_DOWN, SPORTS_TEAM_MATCH, etc.)
  • Text search in titles
  • Bid depth thresholds
  • Filtering by condition_id, slug, market_id, token_id, event_slug
  • Multiple sort options
  • Cursor-based pagination via pagination_key

Markets sharing the same slug belong to the same event (e.g. "2026-nba-champion"). Use event_slug to query all outcomes under an event.

get/v2/predictfun/markets

Query parameters

status'open' | 'closed'

Filter by status: open or closed

market_variant'DEFAULT' | 'CRYPTO_UP_DOWN' | 'SPORTS_TEAM_MATCH' | 'SPORTS_MATCH' | 'TWEET_COUNT'

Filter by market variant: DEFAULT, CRYPTO_UP_DOWN, SPORTS_TEAM_MATCH, SPORTS_MATCH, TWEET_COUNT

searchstring nullable

Search in title (minimum 3 characters)

Search in title (minimum 3 characters)

min_bid_depthnumber nullable

Minimum bid depth

Minimum bid depth

condition_idstring[] nullable

Filter by condition ID(s)

Filter by condition ID(s)

market_slugstring[] nullable

Filter by market slug(s)

Filter by market slug(s)

market_idinteger[] nullable

Filter by market ID(s)

Filter by market ID(s)

token_idstring[] nullable

Filter by token ID(s)

Filter by token ID(s)

predexon_idstring[] nullable

Filter by predexon ID(s)

Filter by predexon ID(s)

event_slugstring[] nullable

Filter by event slug(s) — returns all outcomes under that event

Filter by event slug(s) — returns all outcomes under that event

sort'created' | 'created_asc' | 'price_desc' | 'price_asc' | 'bid_depth'

Sort by

limitinteger

Number of markets to return

Number of markets to return

pagination_keystring nullable

Cursor for next page (from previous response)

Cursor for next page (from previous response)

Response

Successful Response