Skip to main content

​
Overview

Novig offers futures markets for NBA, MLB, NHL, WNBA, Tennis, and special events like the Olympics. A futures market settles on a season or a tournament, not a single game. You read futures from the same REST catalog as game markets. Odds Screens shows how to get a key, sign a request, and turn an order book into prices.

​
Tell futures apart from game markets

The catalog lists futures and game markets together. A market’s marketType says which one it is. Read the full list of market types from GET /v3/types/markets.
Filter on marketType when you list a league’s markets, so futures don’t show up next to your game lines.

​
List a league’s futures

Pass the futures market types you support in marketType, comma-separated.
To list game lines only, pass the game market types instead, like marketType=MONEY,SPREAD,TOTAL.

​
How futures differ from game markets

  • A futures event never goes live. It never reaches OPEN_INGAME, so you can show its prices until the market closes.
  • A futures market can carry a fee on every fill. On an eligible league, fee.charged is ALWAYS, with a coefficient of 0.06 and a maker credit of 0.7. See Trading fees.
  • Some futures events have no markets yet. These are placeholders, so skip an event with no markets.

​
Futures market shapes

Team futures

One market per team, like “Dodgers to win the World Series”, with Yes and No outcomes.

Player futures

One market per player, like “Nikola Jokic Finals MVP”, with Yes and No outcomes.

Series futures

One market per series, with one outcome for each team.

Placeholder events

A futures event with no markets yet. Skip it until markets appear.
The market’s description names the team or player, and each outcome’s name names the answer. Build on marketId and outcomeId, not on description, because the text can change.

​
Read a futures order book

A futures order book works like a game market’s. A bid on one outcome shows as available liquidity on the opposite outcome. Odds Screens shows how to turn the book into displayable prices.

​
Special events

Special events like the Olympics use their own leagues, such as Olympics Hockey Men. Read the current league names from GET /v3/types/leagues. An Olympics league has game markets for each matchup, like MONEY, SPREAD and TOTAL, and a CHAMPIONSHIP_WINNER futures market for each country.

​
Best practices

1

Filter explicitly

Always pass marketType, so futures and game lines stay separate.
2

Handle empty events

Skip a futures event that has no markets yet.
3

Cache IDs

Cache each market’s marketId and outcomeIds, and match on them, not on description.
4

Watch for new leagues

Re-read GET /v3/types/leagues to pick up new leagues and special events.