Polymarket hub

Polymarket Series API

Recurring event groups, with their schedule, status and volume.

GET /v1/polymarket/series

1 credit Failed requests are free

About this endpoint

GET /v1/polymarket/series returns a page of series in data.series. A series carries id, slug, title, seriesType, recurrence (daily, weekly, monthly, annual, hourly, quarterly), description, image, icon, status, active, closed, archived, featured, volume, liquidity, commentCount and dates.

Filter by recurrence and closed. limit is 1 to 50 and defaults to 50; Polymarket caps a series page at 50 and says nothing when it does. data.page continues with an opaque cursor. Polymarket reports all-time and 24-hour volume for a series; the other volume windows are null.

Polymarket Series API FAQ

What is a series?

A series groups related events, such as a league season or a recurring question that adds a new event each day, week or month. The recurrence field says how often a new event is added.

Why are some volume windows null?

Polymarket reports all-time and 24-hour volume for series. The week, month and year windows are null on this object. A null window is not a missing series.

How do I get a series' events?

Call GET /v1/polymarket/series/{idOrSlug} with includeEvents=true. The events come back with the headline numbers of their markets, newest end date first.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.