---
title: "Get Predict Markets"
method: GET
path: "/v2/predictfun/markets"
tags: ["predictfun"]
---

# Get Predict Markets

`GET /v2/predictfun/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.

## Query parameters

- `status` 'open' | 'closed'
- `market_variant` 'DEFAULT' | 'CRYPTO_UP_DOWN' | 'SPORTS_TEAM_MATCH' | 'SPORTS_MATCH' | 'TWEET_COUNT'
- `search` string, nullable — Search in title (minimum 3 characters)
- `min_bid_depth` number, nullable — Minimum bid depth
- `condition_id` string[], nullable — Filter by condition ID(s)
- `market_slug` string[], nullable — Filter by market slug(s)
- `market_id` integer[], nullable — Filter by market ID(s)
- `token_id` string[], nullable — Filter by token ID(s)
- `predexon_id` string[], nullable — Filter by predexon ID(s)
- `event_slug` string[], nullable — Filter by event slug(s) — returns all outcomes under that event
- `sort` 'created' | 'created_asc' | 'price_desc' | 'price_asc' | 'bid_depth'
- `limit` integer — Number of markets to return
- `pagination_key` string, nullable — Cursor for next page (from previous response)

## Response `200`

Successful Response

- PredictMarketsResponse — Response for Predict.fun markets list endpoint.
  - `markets` PredictMarket[], required
    - `market_id` integer, required
    - `condition_id` string
    - `title` string, required
    - `description` string
    - `status` string, required
    - `market_variant` string
    - `outcomes` PredictOutcome[], required
      - `label` string, required
      - `token_id` string
      - `predexon_id` string
      - `best_bid` number, nullable
      - `best_ask` number, nullable
    - `best_bid` number, nullable
    - `best_ask` number, nullable
    - `bid_depth` number
    - `ask_depth` number
    - `is_yield_bearing` boolean
    - `is_neg_risk` boolean
    - `event_slug` string, nullable
    - `image_url` string
    - `winning_outcome` integer, nullable
    - `payout_numerators` integer[]
    - `resolution_block` integer, nullable
    - `resolution_tx` string, nullable
    - `created_time` string, nullable — ISO 8601 timestamp
    - `updated_time` string, nullable — ISO 8601 timestamp
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)