Skip to main content
GET
/
v1
/
polymarket
/
markets
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets?status=open&sort=volume&limit=10"

{
  "markets": [
    {
      "condition_id": "0x1a2b3c4d...",
      "market_id": "12345",
      "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
      "title": "Will Donald Trump win the 2024 Presidential Election?",
      "description": "This market resolves to Yes if...",
      "status": "open",
      "winning_side": null,
      "start_time": "2024-01-01T00:00:00Z",
      "end_time": "2024-11-06T00:00:00Z",
      "outcomes": [
        {
          "label": "Yes",
          "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
          "price": 0.62
        },
        {
          "label": "No",
          "token_id": "48331043336612883890938759509493159234755048973500640148014422747788308965732",
          "price": 0.38
        }
      ],
      "total_volume_usd": 1500000000.00,
      "liquidity_usd": 25000000.00,
      "tags": ["politics", "elections"],
      "event_slug": "2024-presidential-election",
      "event_title": "2024 Presidential Election"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1234,
    "has_more": true
  }
}

​
Overview

Fetch a list of prediction markets with comprehensive filtering options. This is the primary endpoint for discovering markets on Polymarket.
​
status
string
default:"none"
Filter by market status: open or closed
​
min_price
number
Minimum price filter (0-1). Filters based on side A (Yes) price.
​
max_price
number
Maximum price filter (0-1). Filters based on side A (Yes) price.
​
min_open_interest
number
Minimum open interest in USD.
​
min_volume
number
Minimum total volume in USD.
​
tags
array
Filter by tag(s). Example: tags=politics&tags=elections
​
event_slug
array
Filter by event slug(s).
​
search
string
Search in market title (min 2 characters).
​
condition_id
array
Filter by specific condition ID(s).
​
market_slug
array
Filter by specific market slug(s).
​
sort
string
default:"volume"
Sort by: volume, open_interest, price_desc, price_asc
​
limit
integer
default:"20"
Number of markets to return (1-100).
​
offset
integer
default:"0"
Number of markets to skip for pagination.
​
markets
array
​
pagination
object
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets?status=open&sort=volume&limit=10"

{
  "markets": [
    {
      "condition_id": "0x1a2b3c4d...",
      "market_id": "12345",
      "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
      "title": "Will Donald Trump win the 2024 Presidential Election?",
      "description": "This market resolves to Yes if...",
      "status": "open",
      "winning_side": null,
      "start_time": "2024-01-01T00:00:00Z",
      "end_time": "2024-11-06T00:00:00Z",
      "outcomes": [
        {
          "label": "Yes",
          "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
          "price": 0.62
        },
        {
          "label": "No",
          "token_id": "48331043336612883890938759509493159234755048973500640148014422747788308965732",
          "price": 0.38
        }
      ],
      "total_volume_usd": 1500000000.00,
      "liquidity_usd": 25000000.00,
      "tags": ["politics", "elections"],
      "event_slug": "2024-presidential-election",
      "event_title": "2024 Presidential Election"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1234,
    "has_more": true
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

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

Required string length: 2 - 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
​
sort
enum<string>
default:volume

Sort by

Available options:
volume,
open_interest,
price_desc,
price_asc
​
limit
integer
default:20

Number of markets to return

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of markets to skip

Required range: 0 <= x <= 10000

Response

Successful Response