Skip to main content
GET
/
v2
/
polymarket
/
markets
/
keyset
List Markets (Keyset Pagination)
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/markets/keyset \
  --header 'x-api-key: <api-key>'
{
  "markets": [
    {
      "condition_id": "<string>",
      "market_id": "<string>",
      "market_slug": "<string>",
      "title": "<string>",
      "status": "<string>",
      "outcomes": [
        {
          "label": "<string>",
          "token_id": "<string>",
          "predexon_id": "<string>",
          "price": 123
        }
      ],
      "question_id": "<string>",
      "description": "",
      "winning_side": "<string>",
      "start_time": "<string>",
      "end_time": "<string>",
      "close_time": "<string>",
      "created_time": "<string>",
      "image_url": "",
      "event_id": "<string>",
      "event_slug": "<string>",
      "event_title": "<string>",
      "total_volume_usd": 0,
      "liquidity_usd": 0,
      "tags": [
        "<string>"
      ],
      "is_neg_risk": false,
      "rolling_metrics": {
        "volume_1d": 0,
        "volume_7d": 0,
        "volume_30d": 0,
        "buy_volume_1d": 0,
        "buy_volume_7d": 0,
        "buy_volume_30d": 0,
        "sell_volume_1d": 0,
        "sell_volume_7d": 0,
        "sell_volume_30d": 0,
        "trades_1d": 0,
        "trades_7d": 0,
        "trades_30d": 0,
        "buys_1d": 0,
        "buys_7d": 0,
        "buys_30d": 0,
        "sells_1d": 0,
        "sells_7d": 0,
        "sells_30d": 0,
        "oi_change_1d": 0,
        "oi_change_7d": 0,
        "oi_change_30d": 0,
        "computed_at": "<string>"
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

Fetch Polymarket prediction markets with the same filters and sort options as List Markets, but paginate with pagination_key instead of offset. Use this endpoint for large backfills or long-running crawls. It is designed to keep deep pagination stable and does not return a total count.
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.
ConstraintValue
limit1-100 (default 20)
pagination_keyCursor returned from the previous response
To fetch the next page, pass the returned pagination.pagination_key as the next request’s pagination_key. Keep the same filter and sort parameters across pages.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
status
enum<string> | null

Filter by status: open or closed

Available options:
open,
closed
​
min_price
number | null

Minimum price

Required range: 0 <= x <= 1
​
max_price
number | null

Maximum price

Required range: 0 <= x <= 1
​
min_open_interest
number | null

Minimum open interest (USD)

Required range: x >= 0
​
min_volume
number | null

Minimum volume (USD)

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

Filter by tag(s)

Maximum array length: 50
​
event_slug
string[] | null

Filter by event slug(s)

Maximum array length: 50
​
search
string | null

Search in title (minimum 3 characters)

Required string length: 3 - 100
​
condition_id
string[] | null

Filter by condition ID(s)

Maximum array length: 50
​
question_id
string[] | null

Filter by question ID(s)

Maximum array length: 50
​
market_id
string[] | null

Filter by market ID(s)

Maximum array length: 50
​
market_slug
string[] | null

Filter by market slug(s)

Maximum array length: 50
​
token_id
string[] | null

Filter by token ID(s) - matches either side_a or side_b

Maximum array length: 50
​
predexon_id
string[] | null

Filter by predexon ID(s) - matches either side_a or side_b

Maximum array length: 50
​
sort
enum<string>
default:volume

Sort by

Available options:
volume,
open_interest,
price_desc,
price_asc,
expiration,
expiration_asc,
created,
created_asc,
relevance,
volume_1d,
volume_7d,
volume_30d,
trades_1d,
trades_7d,
trades_30d,
oi_change_1d,
oi_change_7d,
oi_change_30d
​
end_after
integer | null

Only markets with end_time after this Unix timestamp (seconds)

Required range: x >= 0
​
end_before
integer | null

Only markets with end_time before or at this Unix timestamp (seconds)

Required range: x >= 0
​
limit
integer
default:20

Number of markets to return

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

Cursor for the next page

​
min_volume_1d
number | null

Minimum rolling 1-day volume (USD)

Required range: x >= 0
​
min_volume_7d
number | null

Minimum rolling 7-day volume (USD)

Required range: x >= 0
​
min_volume_30d
number | null

Minimum rolling 30-day volume (USD)

Required range: x >= 0
​
min_trades_1d
integer | null

Minimum rolling 1-day trade count

Required range: x >= 0
​
min_trades_7d
integer | null

Minimum rolling 7-day trade count

Required range: x >= 0
​
min_trades_30d
integer | null

Minimum rolling 30-day trade count

Required range: x >= 0

Response

Successful Response

Response for Polymarket markets list endpoint with cursor pagination.

​
markets
PolymarketMarket · object[]
required
​
pagination
CursorPagination · object
required

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