> ## 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.

# Events & Markets

> Understanding how prediction markets are structured on Polymarket US.

Every prediction on Polymarket US is structured around three levels: **series**, **events**, and **markets**. Understanding how they relate is essential for finding what you want to trade.

## Series

A series is a broad grouping of related events — like a sports league or a season. Think of it as a folder that contains many games or occurrences.

**Examples:** NFL 2025-26 Season, NBA 2025-26 Season, March Madness 2026

## Events

An event is a specific occurrence within a series — usually a single game, match, or contest. Each event has a start time, participants, and one or more markets attached to it.

**Examples:** Chiefs vs Eagles — Feb 9, 2026, Lakers vs Celtics — Jan 15, 2026

## Markets

A market is the actual thing you trade. It's a single yes/no question about an event. Each market settles at \$1.00 if the outcome happens and \$0.00 if it doesn't.

One event can have multiple markets. For example, a single NFL game might have:

| Market type   | Question                                  | Example                |
| ------------- | ----------------------------------------- | ---------------------- |
| **Moneyline** | Who wins?                                 | Will the Chiefs win?   |
| **Spread**    | Will they win by more than X points?      | Chiefs -3.5            |
| **Total**     | Will the combined score be over/under X?  | Total points over 47.5 |
| **Prop**      | Will a specific thing happen in the game? | Mahomes over 2.5 TDs   |

```
Series: NFL 2025-26 Season
  └── Event: Chiefs vs Eagles — Feb 9, 2026
        ├── Market: Will the Chiefs win? (moneyline)
        ├── Market: Chiefs -3.5 (spread)
        └── Market: Total points over 47.5 (total)
```

## Market slugs

Every market has a **slug** — a URL-friendly identifier like `aec-nfl-kc-phi-2026-02-09`. This is what you use everywhere: placing orders, fetching order books, subscribing to WebSocket streams.

You can find slugs by searching or browsing markets through the API.

## Live sports data

For sports events that are in progress, you get real-time metadata like the current score, period, and whether the game has ended. This is useful if you're building applications that react to live game state.