Discovery

List markets

List bettable contracts/markets (e.g., "Winner", "Total Points Over/Under").

Supports filtering by date ranges, text search, tags, and pagination. Results are sorted by the selected field (default: updated_at desc).

Pagination: Use the next_cursor value from the response to fetch the next page.

get/v1/markets

Request

Base URL: https://api.polymarketdata.co
URL: https://api.polymarketdata.co/v1/markets
Auth: API key in header X-API-Key

Query parameters

searchstring

Optional case-insensitive text match for market question or slug.

Example:trump

limitinteger

Maximum number of items returned in this page.

Example:100

cursorstring

Opaque cursor from a previous metadata.next_cursor value.

start_date_minstring

Filter for markets with start_date greater than or equal to this ISO 8601 timestamp.

Example:2026-01-01T00:00:00Z

start_date_maxstring

Filter for markets with start_date less than or equal to this ISO 8601 timestamp.

Example:2026-12-31T23:59:59Z

end_date_minstring

Filter for markets with end_date greater than or equal to this ISO 8601 timestamp.

Example:2026-01-01T00:00:00Z

end_date_maxstring

Filter for markets with end_date less than or equal to this ISO 8601 timestamp.

Example:2026-12-31T23:59:59Z

tagsstring[] nullable

Filter by event tags. Supports repeated params and comma-separated values.

tags_match'any' | 'all'

Tag match behavior for filtering.

Tag matching strategy: any (OR) or all (AND).

sort'created_at' | 'updated_at'

Sortable fields for discovery listings.

Field used to sort the response rows.

order'asc' | 'desc'

Sort direction for discovery listings.

Sort direction.

Response

Paginated list of markets.

Example response

{
  "data": [
    {
      "end_date": "2025-11-05T23:59:59Z",
      "id": "618831",
      "question": "Will Candidate X win the 2025 election?",
      "slug": "will-candidate-x-win-2025",
      "start_date": "2025-09-01T00:00:00Z",
      "status": "open",
      "tokens": [
        {
          "id": "12345",
          "label": "Yes"
        },
        {
          "id": "12346",
          "label": "No"
        }
      ]
    }
  ],
  "metadata": {
    "count": 1,
    "limit": 100
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.