Skip to main content
GET
/
v2
/
predictfun
/
markets
List Predict.Fun Markets
curl --request GET \
  --url https://api.predexon.com/v2/predictfun/markets \
  --header 'x-api-key: <api-key>'
{
  "markets": [
    {
      "market_id": 123,
      "condition_id": "<string>",
      "title": "<string>",
      "status": "open",
      "market_variant": "DEFAULT",
      "outcomes": [
        {
          "label": "<string>",
          "token_id": "<string>",
          "predexon_id": "<string>",
          "best_bid": 123,
          "best_ask": 123
        }
      ],
      "bid_depth": 123,
      "ask_depth": 123,
      "is_yield_bearing": true,
      "is_neg_risk": true,
      "created_time": "2023-11-07T05:31:56Z",
      "updated_time": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "best_bid": 123,
      "best_ask": 123,
      "event_slug": "<string>",
      "image_url": "<string>",
      "winning_outcome": "<string>",
      "payout_numerators": [
        "<unknown>"
      ],
      "resolution_block": 123,
      "resolution_tx": "<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 market status

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

Filter by market variant

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

Search in title

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
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 order

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

Results per page

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

Cursor for next page

Response

Successful Response

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

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