Skip to main content
GET
/
v2
/
predictfun
/
markets
Get Predict Markets
curl --request GET \
  --url https://api.predexon.com/v2/predictfun/markets \
  --header 'x-api-key: <api-key>'
{
  "markets": [
    {
      "market_id": 123,
      "title": "<string>",
      "status": "<string>",
      "outcomes": [
        {
          "label": "<string>",
          "token_id": "",
          "predexon_id": "",
          "best_bid": 123,
          "best_ask": 123
        }
      ],
      "condition_id": "",
      "description": "",
      "market_variant": "",
      "best_bid": 123,
      "best_ask": 123,
      "bid_depth": 0,
      "ask_depth": 0,
      "is_yield_bearing": false,
      "is_neg_risk": false,
      "event_slug": "<string>",
      "image_url": "",
      "winning_outcome": 123,
      "payout_numerators": [],
      "resolution_block": 123,
      "resolution_tx": "<string>",
      "created_time": "<string>",
      "updated_time": "<string>"
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
List Predict.fun markets with filtering and sorting. Markets sharing the same event_slug belong to the same event.
ConstraintValue
limit1–100 (default 20)

​
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

VariantDescription
DEFAULTGeneral markets
CRYPTO_UP_DOWNCrypto price direction
SPORTS_TEAM_MATCHTeam vs team
SPORTS_MATCHMatch outcome
TWEET_COUNTSocial media

​
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.