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

# Events

> Understanding events in prediction markets

## What is an Event?

An **Event** in VoxFi represents a question or prediction market topic that users can trade on. Events are the top-level containers that group related markets.

### Key Features

* **Description**: A question or statement that defines what the event is predicting;
* **Status**: The current state of the event (e.g., open, closed, resolved);
* **Markets**: An event can contain one or multiple markets where users can trade;
* **Resolution Date**: When the event will be resolved and winners determined;
* **Categories and Tags**: Events are organized by categories and can have multiple tags.

### Example Event Response

```json theme={null}
{
  "id": "73fb9a96-fa5b-4680-b1aa-448afe9ec650",
  "status_id": 2,
  "type_id": 1,
  "category_id": 11,
  "tags_ids": [
    6,
    8,
    1,
    2
  ],
  "status": "Active",
  "type": "future",
  "category": "Technology",
  "description": "Will X (formerly Twitter) face a new judicial block in Brazil in 2026?",
  "tags": [
    "judiciary",
    "Pop Culture",
    "Brazil",
    "Federal Government"
  ],
  "slug": "will-x-formerly-twitter-face-a-new-judicial-block-in-brazil-in-2026",
  "rules": "For the result to be \"Yes\", the platform must be inaccessible in Brazil by judicial determination for a period exceeding 24 consecutive hours at any time during 2026. Technical instabilities do not count.",
  "thumbnail_url": "",
  "documentation_url": "",
  "metadata": {},
  "created_at": "2025-12-29T09:21:46.836348Z",
  "starts_at": "2025-12-29T09:23:00Z",
  "closes_at": "2026-12-31T23:00:00Z",
  "finished_at": null,
  "qty_markets": 1,
  "is_single_market": true,
  "markets": [
    {
      "id": "95f88394-4f4d-4489-99dc-8cef9f7682ee",
      "description": "",
      "metadata": {},
      "thumbnail_url": null,
      "options": [
        {
          "id": "13f89ed4-8cc0-4d72-bc64-88faf17ef386",
          "option_type": 1,
          "description": "Yes",
          "metadata": {}
        },
        {
          "id": "230d9631-b35a-4fbc-970d-39a60df7a7c6",
          "option_type": 2,
          "description": "No",
          "metadata": {}
        }
      ],
      "volume": 29500,
      "closed_at": null,
      "resolved_at": null,
      "settled_at": null,
      "liquidity": 32051,
      "winner_option_type": null
    }
  ],
  "likes": 0,
  "volume": 29500,
  "liquidity": 32051
}
```

## API Endpoints

### Get Events

Retrieves a list of available events with pagination and filtering options.

[Detailed documentation + playground](/playground/data/get-events)

### Get Event

Retrieves a specific event by ID.

[Detailed documentation + playground](/playground/data/get-event)

## Use Cases

* **Browse Events**: List all available events with filtering and sorting;
* **Search Events**: Find events by description or tags;
* **Event Details**: Get complete information about a specific event including all its markets;
* **Market Discovery**: Use events to discover related markets for trading.