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

# Event series

> Recurring prediction markets on the same asset or topic

An **event series** is a collection of recurring events that follow the same pattern — same asset, same question structure, repeated on a schedule. Instead of a one-off "Will BTC close above \$70k?", a series produces a new event every hour, every 6 hours, or every day.

## How series work

Each series defines:

* **Asset** — the underlying asset or topic (e.g. BTC, ETH, XAUUSD, EUR/USD).
* **Interval** — how often a new event is created: `FIFTEEN_MINUTE`, `HOURLY`, `SIX_HOURLY`, or `DAILY`.
* **Category** — such as `CRYPTO`, `CURRENCY`, or `FINANCE`.

When a series interval elapses, a new event is automatically created with its own markets and outcomes. Previous events in the series continue through their normal lifecycle (trading closes, then the outcome is resolved).

## Series vs events

|                        | Series                               | Event                            |
| ---------------------- | ------------------------------------ | -------------------------------- |
| **What it represents** | A recurring template                 | A single tradeable question      |
| **Lifespan**           | Ongoing                              | Opens → closes → resolves        |
| **Tradeable?**         | No — you trade the individual events | Yes                              |
| **Example**            | "Bitcoin Hourly Markets"             | "Bitcoin Hourly — Apr 4 2pm GMT" |

A series is not tradeable on its own. It groups events so you can browse and follow a specific asset's recurring markets.

## Available series

| Asset type       | `category` field        | Examples                                                                                        |
| ---------------- | ----------------------- | ----------------------------------------------------------------------------------------------- |
| Crypto           | `CRYPTO`                | BTC, ETH, SOL — 15-min, hourly, 6-hourly, and daily intervals                                   |
| Commodities & FX | `CURRENCY` or `FINANCE` | Gold (XAUUSD), Silver (XAGUSD), Oil (WTI), EUR/USD, GBP/USD, USD/NGN, USD/JPY, EUR/GBP — hourly |

Use the `assetSymbol` and `intervalType` fields to find the series you need rather than relying on `category` alone.

## Browsing series

Use the [List series](/api-reference/pm/list-series) endpoint to get all available series:

```bash theme={null}
GET /v1/pm/events/series
```

Each series has a `slug` (e.g. `crypto-btc-1h`) that you use to fetch its recent events:

```bash theme={null}
GET /v1/pm/events/series/crypto-btc-1h/lean-events
```

This returns up to 20 recent events in the series with their opening, closing, and resolution times. See the [Get series events](/api-reference/pm/get-series-events) reference for the full response shape.

You can also filter the main [List events](/api-reference/pm/list-events) endpoint by `seriesSlug` to get full event details for a specific series:

```bash theme={null}
GET /v1/pm/events?seriesSlug=crypto-btc-1h&status=open
```

## Event lifecycle within a series

Events in a series follow the standard [event lifecycle](/concepts/events-markets-outcomes):

1. **Open** — the event is created and trading begins.
2. **Closed** — trading stops (e.g. at the end of the hourly window).
3. **Resolved** — the outcome is determined based on the real-world result.

For an hourly series, a typical event opens at the top of the hour, closes at the end of the hour, and resolves shortly after.
