Discovery

List series

List broad categories of prediction markets (e.g., "NBA", "US Politics").

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/series

Request

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

Query parameters

searchstring

Optional case-insensitive text match for series title or slug.

Example:nba

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 series with start_date greater than or equal to this ISO 8601 timestamp.

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

start_date_maxstring

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

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

end_date_minstring

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

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

end_date_maxstring

Filter for series 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 market series.

Example response

{
  "data": [
    {
      "id": "101",
      "slug": "nba",
      "start_date": "2025-09-01T00:00:00Z",
      "status": "open",
      "title": "NBA"
    },
    {
      "id": "102",
      "slug": "us-politics",
      "start_date": "2025-09-01T00:00:00Z",
      "status": "open",
      "title": "US Politics"
    }
  ],
  "metadata": {
    "count": 2,
    "limit": 100,
    "next_cursor": "eyJ2IjoiMjAyNS0wNi0wNVQxMjozNDo1NiswMDowMCIsImlkIjoiMTAxIn0="
  }
}

Changes

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