Data

Events & Series

An event groups related markets under a shared outcome. A series is a recurring template that produces new events on a schedule. Query both to navigate the market hierarchy above individual markets.

GET/events

sdkclient.events.list(**params)

List events with optional filtering by category, series, or time range.

Parameters

qstr

Full-text search on event title.

categorystr

Filter by event category.

series_idstr

Filter by parent series slug or UUID.

recurringbool

Only events from recurring series.

end_afterint | str

Events ending after this time (ms epoch or ISO 8601).

start_beforeint | str

Events starting before this time (ms epoch or ISO 8601).

sortstr= "-created_at"

Sort field.

limitint= 50

Results per page.

cursorstr

Pagination cursor from previous response.

takeint

SDK only. Caps total items returned across pages.

events = client.events.list(recurring=True, take=2)
for event in events:
    print(event.title, event.market_count)

jsonResponse

{
  "data": [
    {
      "id": "a924d6c4-9f75-569c-...",
      "platform": "polymarket",
      "title": "Bitcoin above ___ on March 14?",
      "category": "Crypto",
      "series_id": "a54be2bf-3198-5f30-...",
      "series_title": "BTC Multi Strikes Weekly",
      "series_recurrence": "daily",
      "market_count": 11,
      "end_date": 1773504000000
    },
    {
      "id": "031f37fb-4384-5ddc-...",
      "platform": "polymarket",
      "title": "Fed decision in April?",
      "category": "Economy",
      "series_id": "9b2c1d7e-4a05-5e8f-...",
      "series_title": "FOMC",
      "series_recurrence": "monthly",
      "market_count": 2,
      "end_date": 1777420800000
    }
  ],
  "meta": { "cursor": "...", "has_more": true }
}

GET/events/{event_id}

sdkclient.events.get(event_id)

Retrieve a single event by ID.

event = client.events.get(
    "c2e9078c-c0be-5199-8c77-4f65948d15c2"
)
print(event.title, event.market_count)

jsonResponse

{
  "id": "a924d6c4-9f75-569c-...",
  "platform": "polymarket",
  "title": "Bitcoin above ___ on March 14?",
  "category": "Crypto",
  "series_id": "a54be2bf-3198-5f30-...",
  "series_title": "BTC Multi Strikes Weekly",
  "series_recurrence": "daily",
  "market_count": 11,
  "end_date": 1773504000000
}

GET/events/{event_id}/markets

sdkclient.events.markets(event_id, **params)

List all markets belonging to an event.

Parameters

statusstr

Filter by market status ("active", "closed", "resolved").

sortstr= "close_time"

Sort field.

limitint= 50

Results per page.

cursorstr

Pagination cursor from previous response.

takeint

SDK only. Caps total items returned across pages.

markets = client.events.markets(
    "c2e9078c-c0be-5199-8c77-4f65948d15c2",
    sort="close_time", take=2,
)
for m in markets:
    print(m.question, m.strike)

jsonResponse

{
  "data": [
    {
      "id": "93cfbf00-1afc-537c-...",
      "event_id": "a924d6c4-9f75-569c-...",
      "series_id": "a54be2bf-3198-5f30-...",
      "series_title": "BTC Multi Strikes Weekly",
      "question": "Will the price of Bitcoin be above $68,000 on March 14?",
      "market_type": "binary",
      "status": "active",
      "outcomes": [
        { "name": "Yes", "last_price": 0.9950 },
        { "name": "No", "last_price": 0.0050 }
      ],
      "volume": 2241.2834,
      "strike": 68000,
      "close_time": 1773504000000
    },
    {
      "id": "8150b888-67f6-58ed-...",
      "event_id": "a924d6c4-9f75-569c-...",
      "series_id": "a54be2bf-3198-5f30-...",
      "series_title": "BTC Multi Strikes Weekly",
      "question": "Will the price of Bitcoin be above $70,000 on March 14?",
      "market_type": "binary",
      "status": "active",
      "outcomes": [
        { "name": "Yes", "last_price": 0.9390 },
        { "name": "No", "last_price": 0.0610 }
      ],
      "volume": 4637.1978,
      "strike": 70000,
      "close_time": 1773504000000
    }
  ],
  "meta": { "cursor": "...", "has_more": true }
}

GET/series

sdkclient.series.list(**params)

List all available series with filtering.

Parameters

categorystr

Filter by category.

recurrencestr

Filter by recurrence interval ("5m", "15m", "hourly", "daily", "weekly").

is_rollingbool

Only rolling (true) or structured (false).

sortstr= "-market_count"

Sort field.

limitint= 50

Results per page.

takeint

SDK only. Caps total items returned across pages.

series = client.series.list(category="Sports", take=2)
for s in series:
    print(s.title, s.recurrence, s.market_count)

jsonResponse

{
  "data": [
    {
      "id": "090de525-7d56-5c75-...",
      "platform": "polymarket",
      "platform_series_id": "soccer-fifwc",
      "title": "FIFA World Cup",
      "recurrence": "daily",
      "category": "Sports",
      "is_rolling": false,
      "structured_type": null,
      "market_count": 2027,
      "first_market_close": 1781924400000,
      "last_market_close": 1782118800000
    },
    {
      "id": "ab80d611-dcc3-5c73-...",
      "platform": "polymarket",
      "platform_series_id": "mlb",
      "title": "MLB",
      "recurrence": "daily",
      "category": "Sports",
      "is_rolling": false,
      "structured_type": null,
      "market_count": 1298,
      "first_market_close": 1781922000000,
      "last_market_close": 1782112800000
    }
  ],
  "meta": { "cursor": "...", "has_more": true }
}

GET/series/{series_id}

sdkclient.series.get(series_id)

Get a single series. Both the SDK and the REST path accept the series slug or UUID.

s = client.series.get(
    "mlb"
)
print(s.title, s.recurrence, s.market_count)

jsonResponse

{
  "id": "ab80d611-dcc3-5c73-...",
  "platform": "polymarket",
  "platform_series_id": "mlb",
  "title": "MLB",
  "recurrence": "daily",
  "category": "Sports",
  "is_rolling": false,
  "structured_type": null,
  "market_count": 1298,
  "first_market_close": 1781922000000,
  "last_market_close": 1782112800000
}

GET/series/{series_id}/markets

sdkclient.series.markets(series_id, **params)

List all markets in a series, ordered chronologically. The path accepts the series slug or UUID.

Parameters

statusstr

Filter by market status ("active", "closed", "resolved").

sortstr= "close_time"

Sort field ("close_time", "volume").

limitint= 50

Results per page.

cursorstr

Pagination cursor from previous response.

takeint

SDK only. Caps total items returned across pages.

markets = client.series.markets(
    "mlb", status="resolved", sort="-volume",
)
for m in markets:
    print(m.question, m.volume)

jsonResponse

{
  "data": [
    {
      "id": "78375028-6c81-5427-...",
      "event_id": "bdb00734-7007-5661-...",
      "event_title": "Cincinnati Reds vs. New York Yankees",
      "series_id": "ab80d611-dcc3-5c73-...",
      "series_title": "MLB",
      "question": "Cincinnati Reds vs. New York Yankees",
      "market_type": "binary",
      "subtype": "moneyline",
      "status": "resolved",
      "outcomes": [
        { "name": "Cincinnati Reds", "last_price": 0.345 },
        { "name": "New York Yankees", "last_price": 0.655 }
      ],
      "winning_outcome": "Cincinnati Reds",
      "volume": 1152412.8246,
      "close_time": 1782005700000
    },
    {
      "id": "d6335ee7-0bfb-5a28-...",
      "event_id": "fc4ab55b-2e74-5972-...",
      "event_title": "Boston Red Sox vs. Seattle Mariners",
      "series_id": "ab80d611-dcc3-5c73-...",
      "series_title": "MLB",
      "question": "Boston Red Sox vs. Seattle Mariners: O/U 6.5",
      "market_type": "binary",
      "subtype": "total",
      "status": "resolved",
      "outcomes": [
        { "name": "Over", "last_price": 0.535 },
        { "name": "Under", "last_price": 0.465 }
      ],
      "winning_outcome": "Under",
      "volume": 610906.8940,
      "close_time": 1782101400000
    }
  ],
  "meta": { "cursor": "...", "has_more": true }
}