v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Markets

Fetches market data with optional filtering and search functionality. Supports filtering by market slug, condition ID, token ID, or tags, as well as fuzzy search across market titles and descriptions. Returns markets ordered by volume (most popular first) when filters are applied, or by start_time (most recent first) when no filters are provided.

get/polymarket/markets

Query parameters

market_slugstring[]

Filter markets by market slug(s). Can provide multiple values.

[
  "bitcoin-up-or-down-july-25-8pm-et"
]

event_slugstring[]

Filter markets by event slug(s). Can provide multiple values.

[
  "presidential-election-winner-2028"
]

condition_idstring[]

Filter markets by condition ID(s). Can provide multiple values.

[
  "0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57"
]

token_idstring[]

Filter markets by token ID(s). Matches markets where the token_id is either the primary_token_id or secondary_token_id. Can provide multiple values (maximum 100). Each token_id must be a numeric string.

[
  "24891147099018724959141647991382271578149113344000019968758330059825991230807"
]

tagsstring[]

Filter markets by tag(s). Can provide multiple values.

[
  "politics",
  "crypto"
]

searchstring

Example:bitcoin

Search markets by keywords in title and description. Must be URL encoded (e.g., 'bitcoin%20price' for 'bitcoin price').

status'open' | 'closed'

Example:open

Filter markets by status (whether they're open or closed)

min_volumenumber

Example:100000

Filter markets with total trading volume greater than or equal to this amount (USD)

limitinteger

Example:20

Number of markets to return (1-100). Default: 10 for search, 10 for regular queries.

pagination_keystring

Example:eyJzdGFydF9kYXRlIjoiMjAyNi0wMS0xOVQxMjowMDowMC4wMDBaIiwiY29uZGl0aW9uX2lkIjoiMHgxMjM0In0=

Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object. Use this instead of large offsets for better performance.

start_timeinteger

Example:1640995200

Filter markets from this Unix timestamp in seconds (inclusive)

end_timeinteger

Example:1672531200

Filter markets until this Unix timestamp in seconds (inclusive)

Response

Markets response with pagination

Example response

{
  "markets": [
    {
      "market_slug": "btc-updown-15m-1762516800",
      "event_slug": "presidential-election-winner-2028",
      "condition_id": "0x6876ac2b6174778c973c118aac287c49057c4d5360f896729209fe985a2c07fb",
      "title": "Bitcoin Up or Down - November 7, 7:00AM-7:15AM ET",
      "start_time": 1762506140,
      "end_time": 1762517700,
      "game_start_time": "2025-08-16 20:00:00.000",
      "tags": [
        "Up or Down",
        "Crypto Prices",
        "Hide From New",
        "Recurring",
        "Crypto",
        "Bitcoin",
        "15M"
      ],
      "volume_total": 93.148228,
      "resolution_source": "https://data.chain.link/streams/btc-usd",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
      "description": "This market resolves to \"Yes\" if Bitcoin's price increases from the start to the end of the 15-minute window, and \"No\" otherwise.",
      "side_a": {
        "id": "14557944883400223565643640243919774851380876937588843424705199812983475639104",
        "label": "Up"
      },
      "side_b": {
        "id": "57567439101367774829602299916701968079591032322820664013819223989961583069589",
        "label": "Down"
      },
      "status": "open",
      "extra_fields": {
        "price_to_beat": 98765.43,
        "final_price": 98801.21
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "total": 150,
    "has_more": true,
    "pagination_key": "eyJ2b2x1bWVfdG90YWwiOjEyMzQ1LjY3LCJjbG9zZV90aW1lIjpudWxsLCJjb25kaXRpb25faWQiOiIweDEyMzQifQ=="
  }
}