> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Series

> Browse event series

The Series resource provides access to series information. Series group related events together (e.g., NFL games, election cycles, daily crypto markets).

## Methods

| Method | Endpoint | Description |
| - | - | - |
| `list(params?)` | `GET /v1/series` | List all series |
| `retrieve(id)` | `GET /v1/series/id/{id}` | Get series by ID |

***

## list

Get a list of all series with optional filtering.

```typescript theme={null}
const series = await client.series.list({
  active: true,
  limit: 20,
});

for (const s of series.series) {
  console.log(`${s.title} (${s.recurrence})`);
}
```

### Parameters

| Parameter | Type | Description |
| - | - | - |
| `limit` | number | Maximum results |
| `offset` | number | Pagination offset |
| `slug` | string\[] | Filter by slugs |
| `active` | boolean | Filter by active status |
| `closed` | boolean | Filter by closed status |
| `archived` | boolean | Filter by archived status |
| `recurrence` | string | Filter by recurrence (daily, weekly, etc.) |

### Response Fields

| Field | Type | Description |
| - | - | - |
| `id` | number | Unique series identifier |
| `slug` | string | URL-friendly identifier |
| `title` | string | Series title |
| `subtitle` | string | Series subtitle |
| `description` | string | Series description |
| `seriesType` | string | Type of series |
| `recurrence` | string | Recurrence pattern |
| `active` | boolean | Whether series is active |
| `volume` | string | Total trading volume |
| `liquidity` | string | Current liquidity |

***

## retrieve

Get a single series by ID.

```typescript theme={null}
const series = await client.series.retrieve(123);

console.log(`Title: ${series.title}`);
console.log(`Description: ${series.description}`);
console.log(`Recurrence: ${series.recurrence}`);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.