Skip to main content
GET
Get Predict Markets
List Predict.fun markets with filtering and sorting. Markets sharing the same event_slug belong to the same event.

Event Grouping

Multiple markets sharing the same event_slug are outcomes under one event (e.g. all teams in “2026-nba-champion”). Use event_slug as a query parameter to fetch all outcomes.

Market Variants

Notes

  • Outcomes use best_bid/best_ask instead of price (CLOB-style pricing). Currently null for most markets.
  • is_neg_risk indicates negative risk markets (event-grouped, shares one slug).
  • is_yield_bearing indicates yield-bearing collateral.
  • Use bid_depth/ask_depth for liquidity signals (no volume/OI columns).

Authorizations

x-api-key
string
header
required

Query Parameters

status
enum<string> | null

Filter by status: open or closed

Available options:
open,
closed
market_variant
enum<string> | null

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

Available options:
DEFAULT,
CRYPTO_UP_DOWN,
SPORTS_TEAM_MATCH,
SPORTS_MATCH,
TWEET_COUNT
search
string | null

Search in title (minimum 3 characters)

Required string length: 3 - 100
min_bid_depth
number | null

Minimum bid depth

Required range: x >= 0
condition_id
string[] | null

Filter by condition ID(s)

Maximum array length: 50
market_slug
string[] | null

Filter by market slug(s)

Maximum array length: 50
market_id
integer[] | null

Filter by market ID(s)

Maximum array length: 50
token_id
string[] | null

Filter by token ID(s)

Maximum array length: 50
predexon_id
string[] | null

Filter by predexon ID(s)

Maximum array length: 50
event_slug
string[] | null

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

Maximum array length: 50
sort
enum<string>
default:created

Sort by

Available options:
created,
created_asc,
price_desc,
price_asc,
bid_depth
limit
integer
default:20

Number of markets to return

Required range: 1 <= x <= 100
pagination_key
string | null

Cursor for next page (from previous response)

Response

Successful Response

Response for Predict.fun markets list endpoint.

markets
PredictMarket · object[]
required
pagination
CursorPagination · object
required

Cursor-based pagination for endpoints that don't support offset.