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

# Events

> Kalshi prediction market events metadata grouping related markets together.

The `common.predictions.kalshi_events` table provides event-level metadata for Kalshi prediction markets. Events serve as containers that group related markets together. This table combines both settled and non-settled events.

Use this table for event categorization, series analysis, understanding multi-market events, and tracking event-level patterns.

### Table Columns

**Data Notes:**

* Events group multiple related markets together
* Combines settled and non-settled events
* MVE (Multi-Variable Event) indicators help identify complex event structures

Unique Key: `event_ticker`

| Column Name              | Data Type         | Description                                                       |
| ------------------------ | ----------------- | ----------------------------------------------------------------- |
| project                  | VARCHAR           | Project identifier, always 'kalshi'.                              |
| protocol                 | VARCHAR           | Protocol identifier, always 'kalshi'.                             |
| event\_ticker            | VARCHAR           | Unique event identifier.                                          |
| series\_ticker           | VARCHAR           | Series ticker identifier grouping similar events.                 |
| category                 | VARCHAR           | Category classification.                                          |
| title                    | VARCHAR           | Event title.                                                      |
| sub\_title               | VARCHAR           | Event subtitle (MVE indicator).                                   |
| mutually\_exclusive      | BOOLEAN           | Boolean flag indicating if event outcomes are mutually exclusive. |
| strike\_period           | VARCHAR           | Strike period for the event.                                      |
| strike\_date             | TIMESTAMP\_NTZ(9) | Strike date for the event.                                        |
| available\_on\_brokers   | BOOLEAN           | Boolean flag indicating if available on brokers.                  |
| collateral\_return\_type | VARCHAR           | Type of collateral return.                                        |
| is\_settled              | BOOLEAN           | Boolean flag indicating if the event is settled.                  |

***

### Understanding Event Structure

#### Event vs Market

* **Event**: A container grouping related prediction markets (e.g., "2024 Presidential Election")
* **Market**: Individual prediction markets within an event (e.g., "Will Trump win?", "Will Biden win?")
* One event can have multiple markets, all sharing the same `event_ticker`

#### Series Ticker

The `series_ticker` groups similar events across time. For example:

* `NFL-WEEK1`, `NFL-WEEK2`, `NFL-WEEK3` all belong to the NFL series
* `ECON-JOBS` might represent monthly employment report events