Skip to main content

​
What is a Market?

A Market in VoxFi is a tradable contract within an event. An event can contain one or multiple markets, each representing a specific outcome or question. Important: Markets are always obtained from their respective events. There is no direct endpoint to fetch markets in isolation - you must first get the event and then access its markets through the markets property in the event response.

​
Key Features

  • Binary Outcomes: Each market has two possible outcomes: YES or NO;
  • Trading: Users can buy or sell contracts for any outcome;
  • Price: Market prices range from 0 to 100 ticks, representing probability;
  • Liquidity: The amount of capital available for trading (in ticks, cached);
  • Volume: Total trading volume in the market (in ticks, cached).

​
Relationship with Events

  • Single Market Event: An event with is_single_market: true has only one market;
  • Multi-Market Event: An event can have multiple markets, each representing different aspects or questions related to the main event.

​
Market Example

{
      "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
    }

​
Market Options

Each market has exactly two options, with a fixed and immutable mapping between the option type and its meaning.

​
Official Mapping

  • 1 → YES
  • 2 → NO
This mapping never changes in any market.

​
Option Structure (JSON)

{
  "id": "string",
  "option_type": 1,
  "description": "YES",
  "metadata": {}
}

​
Market States

Markets can be in different states:
  • Active: Market is awaiting opening;
  • Active: Active trading is allowed;
  • Closed: Trading is closed, awaiting resolution;
  • Resolved: Outcome has been determined;
  • Settled: Contracts have been settled and payouts distributed.

​
Use Cases

  • Get Markets from an Event: Fetch a specific event to access all its markets through the markets property;
  • List Available Markets: Browse events to discover markets available for trading;
  • Analyze Event Markets: Examine all markets related to an event to understand the different possible questions or outcomes;
  • Trade in Markets: Identify specific markets within events to buy or sell contracts;
  • Monitor Volume and Liquidity: Track market metrics (volume, liquidity) through data returned with the event;
  • Check Market States: Check the current state of markets (active, closed, resolved, settled) to determine if they are available for trading.