Futures Markets

Overview

Novig offers futures markets for NBA, MLB, NHL, WNBA, Tennis, and special events like the Olympics. This guide explains how futures are structured and how to integrate them into your platform.

Event Types

The Event class has a type field that can be:

Type	Description
`Game`	Standard game/match events (what you currently support)
`Future`	Futures markets (championship winners, MVPs, etc.)
`Tournament`	Tournament-level events

To avoid collisions between Games and Futures, modify your existing queries to explicitly filter on event type.

Filtering by Event Type

Add the type filter to your queries:

query GetGames {
  event(where: {
    type: { _eq: "Game" },
    league: { _eq: "NBA" }
  }) {
    description
  }
}

Querying Futures

query GetFutures {
  event(where: {
    type: { _eq: "Future" },
    league: { _eq: "NBA" }
  }) {
    description
    markets {
      description
      competitor {
        name
      }
      player {
        name
      }
      outcomes {
        competitor {
          name
        }
        description
      }
    }
  }
}

Key Differences from Game Events

Future type events do not have a game field.

The scheduled_start and league fields are now available directly inside Event for futures:

query GetFutures {
  event(where: { type: { _eq: "Future" } }) {
    scheduled_start  # Available directly on Event
    league           # Available directly on Event
    description
  }
}

These fields still exist in Event.game for backwards compatibility with Game events.

Example Futures Response

{
  "data": {
    "event": [
      {
        "description": "Eastern Conference Winner",
        "markets": [
          {
            "description": "Cleveland Cavaliers EASTERN_CONFERENCE_WINNER",
            "competitor": {
              "name": "Cleveland Cavaliers"
            },
            "player": null,
            "outcomes": [
              { "competitor": null, "description": "Yes" },
              { "competitor": null, "description": "No" }
            ]
          }
        ]
      },
      {
        "description": "Detroit Pistons vs New York Knicks - Series Winner",
        "markets": [
          {
            "description": "DET",
            "competitor": null,
            "player": null,
            "outcomes": [
              {
                "competitor": { "name": "Detroit Pistons" },
                "description": "DET"
              },
              {
                "competitor": { "name": "New York Knicks" },
                "description": "NYK"
              }
            ]
          }
        ]
      },
      {
        "description": "Finals MVP",
        "markets": [
          {
            "description": "Donovan Mitchell FINALS_MVP",
            "competitor": null,
            "player": {
              "name": "Donovan Mitchell"
            },
            "outcomes": [
              { "competitor": null, "description": "Yes" },
              { "competitor": null, "description": "No" }
            ]
          }
        ]
      }
    ]
  }
}

Futures Market Types

Team Futures

Markets related to a specific team (e.g., “Cavs to win Eastern Conference”) have a reference to the competitor directly from the market.

Player Futures

Markets related to a specific player (e.g., “Nikola Jokic Finals MVP”) have a reference to the player directly from the market.

Series Futures

Series futures involving an outcome for each team have references to the relevant competitor directly from each outcome.

Placeholder Events

Some futures exist but have no markets. These are placeholders that will likely be supported in the future.

Understanding Futures Order Book

When looking at orders in futures markets, the same bid logic applies:

Scenario	Interpretation
BID on NO at 0.36 (+178), qty 45000	Someone risks $162 to win $288
Available liquidity	Shows on YES -178, $288 to win $162

A BID order represents what someone wants to BUY, so it appears as available liquidity on the opposite outcome.

Special Events

Olympics

Novig launches special event markets like Olympics Hockey. These use dedicated leagues:

query GetOlympicsHockey {
  event(where: {
    league: { _eq: "Olympics Hockey Men" }
  }) {
    description
    markets {
      description
      outcomes {
        description
      }
    }
  }
}

Olympics events include:

Game events for each head-to-head matchup with MONEY, SPREAD, and TOTAL markets
Futures events with CHAMPIONSHIP_WINNER markets for each country

Best Practices

Filter Explicitly

Always filter by type to separate Game and Future events in your queries.

Handle Empty Markets

Some future events may have no markets - these are placeholders for future support.

Check Competitor/Player References

Use the competitor and player fields on markets and outcomes to properly identify the subject of futures bets.

Monitor New Leagues

Watch for announcements about new leagues and special events being added.

Getting Started

Integration Guides

Overview

Event Types

Filtering by Event Type

Querying Futures

Key Differences from Game Events

Example Futures Response

Futures Market Types

Team Futures

Player Futures

Series Futures

Placeholder Events

Understanding Futures Order Book

Special Events

Olympics

Best Practices

​Overview

​Event Types

​Filtering by Event Type

​Querying Futures

​Key Differences from Game Events

​Example Futures Response

​Futures Market Types

Team Futures

Player Futures

Series Futures

Placeholder Events

​Understanding Futures Order Book

​Special Events

​Olympics

​Best Practices

Overview

Event Types

Filtering by Event Type

Querying Futures

Key Differences from Game Events

Example Futures Response

Futures Market Types

Understanding Futures Order Book

Special Events

Olympics

Best Practices