Skip to main content

​
Overview

When working with the Novig API, it’s important to understand how outcomes are organized. The order of outcomes in an array does not determine their meaning—the index field does.

​
The Index Field

Each outcome object contains an index field that identifies which side of the market it represents:
Do not rely on array position to determine outcome meaning. Always use the index field.

​
Example

Consider this response from the API:
In this example:
  • The first item in the outcomes array (14e8323b-...) has index: 1, making it the Away/No side
  • The second item in the outcomes array (c84fa737-...) has index: 0, making it the Home/Yes side
Always filter or find outcomes by their index field rather than assuming array order.

​
Market Type Mapping

The meaning of index: 0 depends on the market type:
For game-level markets (MONEY, SPREAD), index 0 always corresponds to the home team. For totals and player props, index 0 corresponds to the Over or Yes side.

​
Three-Way Moneylines

Some competitions that can end in a draw (e.g. soccer / the FIFA World Cup) use MONEYLINE_3_WAY_WIN markets. Unlike a standard two-sided moneyline, a three-way moneyline is not a single Home/Away market. Instead, each possible result is its own independent Yes / No market: Within each of these markets the index follows the Yes/No convention:
Do not treat the No side of a three-way moneyline as the “Away” team. Because a match can end in a draw, No means any other outcome (the other team winning or a draw), not a specific opponent. Each result is a separate Yes/No market — always resolve sidedness with the index field.
In some responses the outcome type field for these markets may surface as Over / Under rather than Yes / No. This is the same Yes/No semantics described above — index: 0 is always the Yes side. Rely on index, not on type, to determine the side.