Skip to main content

​
Overview

Before fetching data from the Novig API, it’s important to understand how our markets are structured. Novig uses a hierarchical data model with three levels: Events, Markets, and Outcomes.

​
Understanding the Data Model

1

Event

The top-level object representing a game or match, like “KC Chiefs vs BUF Bills - Week 14”. Events contain metadata about the competition including teams, scheduled start time, and league.
2

Market

Each event contains a set of related markets. A market is a specific proposition with a type (e.g., SPREAD, TOTAL, MONEY) and optional strike value. For example, “KC v BUF Total 47.5” is a market.
3

Outcomes

  • Each market contains exactly two mutually exclusive, completely exhaustive outcomes identified by outcomeIds. These represent the two sides of the trade (e.g., Over/Under, Home/Away). Orders are placed on outcomes, not markets.
{
  "id": "abc123-market-uuid",
  "description": "KC v BUF Total",
  "type": "TOTAL",
  "strike": 47.5,
  "outcomeIds": [
    "outcome-uuid-over",
    "outcome-uuid-under"
  ]
}
// Outcome 0: Over 47.5 → -110 odds
// Outcome 1: Under 47.5 → -110 odds

​
Key Concepts

Events

Events typically correspond to real-world games or matches. Each event has a unique eventId and contains information about the teams, league, and scheduled start time.

Markets

Markets define what you’re trading on. Common types include MONEY (moneyline), SPREAD, TOTAL, and player props like PASSING_YARDS.

Outcomes

Outcomes are the tradeable units. When placing an order, you specify an outcomeId, not a market ID. Each market always has exactly two outcomes.

Odds

Novig may display odds in American format (e.g., -110, +150). Internally, prices are stored as decimal probabilities (0.001 to 0.999).
Events, markets, and outcomes may also reference specific players or competitors via optional playerId and competitorId fields.

​
Market Types

Novig supports a variety of market types across different sports:
TypeDescriptionExample
MONEYMoneyline / winnerChiefs -150, Bills +130
SPREADPoint spreadChiefs -2.5 (-110)
TOTALOver/under on combined scoreOver 47.5 (-110)
TEAM_TOTALOver/under on one team’s scoreChiefs Over 24.5
PASSING_YARDSPlayer passing yardsMahomes Over 275.5
RUSHING_YARDSPlayer rushing yardsPacheco Over 65.5
RECEPTIONSPlayer receptionsKelce Over 5.5
For a complete list of market types, see the API Reference.

​
Example: Full Event Structure

Here’s how a typical NFL game is structured in the API: 
{
  "event": {
    "id": "event-uuid-123",
    "description": "KC Chiefs vs BUF Bills - Week 14",
    "type": "REGULAR_SEASON",
    "status": "SCHEDULED",
    "game": {
      "id": "game-uuid-456",
      "league": "NFL",
      "scheduledStart": "2024-12-15T20:00:00Z",
      "homeTeam": {
        "name": "Buffalo Bills",
        "symbol": "BUF"
      },
      "awayTeam": {
        "name": "Kansas City Chiefs",
        "symbol": "KC"
      }
    }
  },
  "markets": [
    {
      "id": "market-uuid-spread",
      "description": "KC v BUF Spread",
      "type": "SPREAD",
      "strike": -2.5,
      "outcomeIds": ["outcome-kc-spread", "outcome-buf-spread"]
    },
    {
      "id": "market-uuid-total",
      "description": "KC v BUF Total",
      "type": "TOTAL",
      "strike": 47.5,
      "outcomeIds": ["outcome-over", "outcome-under"]
    }
  ]
}