Skip to main content

​
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

{
  "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",
  "resolves_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

​
Get Event

Retrieves a specific event by ID. Detailed documentation + playground

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