Skip to main content

​
Overview

Our read-only GraphQL API is available for odds screening platforms to display Novig prices. This allows you to show your users real-time Novig odds alongside other sportsbooks.

​
API Endpoint

https://api.novig.us/v1/graphql

​
Basic Price Query

Get all prices currently offered for a specific league: 
query GetMLBPrices {
  event(where: {
    _and: [
      { _or: [
        { status: { _eq: "OPEN_PREGAME" } },
        { status: { _eq: "OPEN_INGAME" } }
      ]},
      { game: { league: { _eq: "MLB" } } }
    ]
  }) {
    description
    id
    game {
      scheduled_start
    }
    markets {
      description
      outcomes(where: {
        _or: [
          { last: { _is_null: false } },
          { available: { _is_null: false } }
        ]
      }) {
        description
        last
        available
      }
    }
  }
}

​
Understanding Price Fields

FieldDescription
availableThe price we are currently offering
lastThe last traded price (shown when we pull the available price, e.g., overnight)

​
Querying Order Book Liquidity

To get specific liquidity for all markets in a league, query the orders on each outcome. All orders are stored as bids (what people are willing to buy). 
query GetMLBLiquidity {
  event(where: {
    _and: [
      { _or: [
        { status: { _eq: "OPEN_PREGAME" } },
        { status: { _eq: "OPEN_INGAME" } }
      ]},
      { game: { league: { _eq: "MLB" } } }
    ]
  }) {
    description
    id
    game {
      scheduled_start
    }
    markets {
      description
      outcomes(where: {
        _or: [
          { last: { _is_null: false } },
          { available: { _is_null: false } }
        ]
      }) {
        description
        orders(where: {
          status: { _eq: "OPEN" },
          currency: { _eq: "CASH" }
        }) {
          status
          qty
          price
        }
      }
    }
  }
}

​
Example Response

{
  "data": {
    "event": [
      {
        "description": "Chicago White Sox @ Baltimore Orioles",
        "id": "abc123-event-uuid",
        "game": {
          "scheduled_start": "2029-09-03T22:35:00+00:00"
        },
        "markets": [
          {
            "description": "CWS @ BAL t7.5",
            "outcomes": [
              {
                "description": "Under 7.5",
                "orders": [
                  {
                    "status": "OPEN",
                    "qty": 45000,
                    "price": 0.36
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

​
Interpreting Order Data

Orders are stored as bids (what people want to buy), which translates to available liquidity on the opposite side.
Using the example above:
FieldValueMeaning
price0.36Probability price (+178 American odds)
qty45000Total ticket value in cents ($450)
Calculation:
  • Someone is willing to pay 0.36 (+178) for a $450 total ticket
  • They risk $162 to win $288
  • This shows as available liquidity on Over 7.5 -178 for $288 to win $162
The BID is what they want to BUY, so it appears as available liquidity on the opposite outcome.

​
Optimized Query Pattern

For large queries that run slowly, fetch event IDs first, then query each event individually:

​
Step 1: Get Active Event IDs

query GetActiveEvents {
  event(where: {
    status: { _in: ["OPEN_PREGAME", "OPEN_INGAME"] },
    game: { league: { _eq: "NBA" } }
  }) {
    id
    description
  }
}

​
Step 2: Query Orders by Event ID

query GetEventOrders {
  event(where: { id: { _eq: "abc123-event-uuid" } }) {
    markets {
      outcomes(where: {
        _or: [
          { last: { _is_null: false } },
          { available: { _is_null: false } }
        ]
      }) {
        description
        orders(where: {
          status: { _eq: "OPEN" },
          currency: { _eq: "CASH" }
        }) {
          status
          qty
          price
        }
      }
    }
  }
}
This two-step approach results in more queries but each individual query runs faster, which can improve overall performance for your integration.

​
Supported Leagues

The API supports all leagues available on Novig, including:
  • NFL, NBA, MLB, NHL
  • NCAAF, NCAAB
  • Soccer (various leagues)
  • Tennis
  • Golf
  • And more