Polymarket

List Polymarket series

List Polymarket event series such as league seasons and recurring markets.

GET/v1/polymarket/series
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
recurrencestringquery

Only series that add an event on this schedule.

one of: daily, weekly, monthly, annual, hourly, quarterly

closedbooleanquery

Only series that have ended (true) or are still running (false).

limitintegerquery

Items per page, 1–50. Default: 50.

≥ 1 · ≤ 50

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.

min 1 chars · max 6000 chars

Response fields
34

Endpoint-specific response payload.

datalookupStatus
string

`found` on success.

one of: found, not_found

Series in order.

dataseries[]id
string

Series id.

dataseries[]slug
string

Series slug.

dataseries[]title
string

Series title.

dataseries[]seriesType
stringnullable

Kind of series, for example `single`.

dataseries[]recurrence
stringnullable

How often a new event is added: `daily`, `weekly`, `monthly` and so on.

dataseries[]description
stringnullable

Series description.

dataseries[]image
stringnullable

Image URL.

dataseries[]icon
stringnullable

Icon URL.

dataseries[]status
string

Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.

one of: open, closed, inactive

dataseries[]active
boolean

Whether the series is active.

dataseries[]closed
boolean

Whether the series has ended.

dataseries[]archived
boolean

Whether the series is archived.

dataseries[]featured
boolean

Whether Polymarket features the series.

Traded volume of the series' events in US dollars. Polymarket reports the all-time and 24-hour figures for a series; the other windows are null.

dataseries[]volumetotal

All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]volumeday

Volume in the last 24 hours. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]volumeweek

Volume in the last 7 days. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]volumemonth

Volume in the last 30 days. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]volumeyear

Volume in the last 365 days. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]liquidity

Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

dataseries[]commentCount
integernullable

Number of comments on the series.

dataseries[]startDate
stringnullable

When the series starts (ISO-8601, UTC).

dataseries[]createdAt
stringnullable

When the series was created (ISO-8601, UTC).

dataseries[]updatedAt
stringnullable

When the series was last changed (ISO-8601, UTC).

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/series?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket series.