Description

This endpoint provides an alternative to polling the /fixtures/odds endpoint and allows you to passively listen for updates. This endpoint leverages the SSE responses of the http protocol.

Specific Parameter Information

include_fixture_updates

This will return any status or start date changes for fixtures that meet the criteria of the passing in data.

Best Practices

While our endpoint supports passing multiple leagues and game ids, we recommend grouping up to 10 leagues per connection.

Example Requests

Python

Requirements

Python 3.10.2
requests==2.31.0
sseclient-py==1.8.0 | Need to use this sseclient dependency: https://pypi.org/project/sseclient-py/

import requests
from requests.exceptions import ChunkedEncodingError
import json
import sseclient # pip install sseclient-py

last_entry_id: str | None = None
while True:
    try:
        params = {
            "key": "1234-5678-124",
            "sportsbook": ["DraftKings", "FanDuel", "Hard Rock"],
            "market": ["Moneyline"],
            "league": ["NCAAB"],
            # "is_main": True,
        }
        if last_entry_id:
          params["last_entry_id"] = last_entry_id
      
        r = requests.get(
            "https://api.opticodds.com/api/v3/stream/odds/basketball",
            params=params,
            stream=True,
        )
        client = sseclient.SSEClient(r)
        for event in client.events():
            if event.event == "odds":
                data = json.loads(event.data)
                last_entry_id = data.get("entry_id")
                print("odds data", ":", data)
            elif event.event == "locked-odds":
                data = json.loads(event.data)
                last_entry_id = data.get("entry_id")
                print("locked-odds data", ":", data)
            else:
                print(event.event, ":", event.data)
    except ChunkedEncodingError as ex:
        print("Disconnected, attempting to reconnect...")
    except Exception as e:
        print("Error:", r.status_code, r.text)
        break

Node.js

const EventSource = require("eventsource");  // npm install eventsource

const url = "https://api.opticodds.com/api/v3/stream/odds/basketball";
const params = {
  key: "1234-5678-124",
  sportsbook: ["DraftKings", "FanDuel", "Hard Rock"],
  market: ["Moneyline"],
  league: ["NCAAB"],
};
const lastEntryId = null;

function connectToStream() {
  // Construct the query string with repeated parameters
  const queryString = new URLSearchParams();
  queryString.append("key", params.key);
  params.sportsbook.forEach((sportsbook) =>
    queryString.append("sportsbook", sportsbook)
  );
  params.market.forEach((market) => queryString.append("market", market));
  params.league.forEach((league) => queryString.append("league", league));
  if (lastEntryId) {
    queryString.append("last_entry_id", lastEntryId);
  }

  console.log(`${url}?${queryString.toString()}`);

  const eventSource = new EventSource(`${url}?${queryString.toString()}`);

  eventSource.onmessage = function (event) {
    try {
      const data = JSON.parse(event.data);
      console.log("message data:", data);
    } catch (e) {
      console.log("Error parsing message data:", e);
    }
  };

  eventSource.addEventListener("odds", function (event) {
    const data = JSON.parse(event.data);
    lastEntryId = data.entry_id;
    console.log("odds data:", data);
  });

  eventSource.addEventListener("locked-odds", function (event) {
    const data = JSON.parse(event.data);
    lastEntryId = data.entry_id;
    console.log("locked-odds data:", data);
  });

  eventSource.onerror = function (event) {
    console.error("EventSource failed:", event);
    eventSource.close();
    setTimeout(connectToStream, 1000); // Attempt to reconnect after 1 second
  };
}

connectToStream()

Example Events

Connected Event

event: connected
retry: 5000
data: ok go

Ping Event

event: ping
retry: 5000
data: 2024-08-28T18:57:49Z

Odds Event

When an odd gets unsuspended or posted for the first time.

event: odds
id: 1730079534820-2
retry: 5000
data: {"data":[{"deep_link":{"android":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all","desktop":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all","ios":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all"},"fixture_id":"A69FA4D64518","game_id":"28265-17233-24-44","grouping_key":"default","id":"28265-17233-24-44:pinnacle:1st_half_moneyline:philadelphia_eagles","is_live":false,"is_main":true,"league":"NFL","limits":{"max_stake":1000},"market":"1st Half Moneyline","name":"Philadelphia Eagles","player_id":"","points":null,"price":-230,"selection":"Philadelphia Eagles","selection_line":"","selection_points":null,"sport":"football","sportsbook":"Pinnacle","team_id":"EDCC2866B795","timestamp":1730079534.7125728},{"deep_link":{"android":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all","desktop":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all","ios":"https://www.pinnacle.com/en/football/nfl/jacksonville-jaguars-vs-philadelphia-eagles/1599745256/#all"},"fixture_id":"A69FA4D64518","game_id":"28265-17233-24-44","grouping_key":"default","id":"28265-17233-24-44:pinnacle:1st_half_moneyline:jacksonville_jaguars","is_live":false,"is_main":true,"league":"NFL","limits":{"max_stake":1000},"market":"1st Half Moneyline","name":"Jacksonville Jaguars","player_id":"","points":null,"price":198,"selection":"Jacksonville Jaguars","selection_line":"","selection_points":null,"sport":"football","sportsbook":"Pinnacle","team_id":"9CCE4CA64CF2","timestamp":1730079534.7125728}],"entry_id":"1730079534820-2","type":"odds"}

Locked Odds Event

When an odd gets suspended or taken off the board.

event: locked-odds
id: 1730079527180-0
retry: 5000
data: {"data":[{"deep_link":{"android":"dksb://sb/addbet/0QA219503604%2374975813_13L88808Q11169437916Q20","desktop":"https://sportsbook.draftkings.com/event/30568741?outcomes=0QA219503604%2374975813_13L88808Q11169437916Q20","ios":"dksb://sb/addbet/0QA219503604%2374975813_13L88808Q11169437916Q20"},"fixture_id":"8BDC2E0FF301","game_id":"11434-13184-24-43","grouping_key":"dak_prescott:247.5","id":"11434-13184-24-43:draftkings:player_passing_yards:dak_prescott_over_247_5","is_live":true,"is_main":true,"league":"NFL","limits":null,"market":"Player Passing Yards","name":"Dak Prescott Over 247.5","player_id":"4E18B0FEC4C5","points":247.5,"price":-115,"selection":"Dak Prescott","selection_line":"over","selection_points":247.5,"sport":"football","sportsbook":"DraftKings","team_id":"","timestamp":1730079527.1784158},{"deep_link":{"android":"dksb://sb/addbet/0QA219503604%2374975814_15L88808Q1-422942275Q20","desktop":"https://sportsbook.draftkings.com/event/30568741?outcomes=0QA219503604%2374975814_15L88808Q1-422942275Q20","ios":"dksb://sb/addbet/0QA219503604%2374975814_15L88808Q1-422942275Q20"},"fixture_id":"8BDC2E0FF301","game_id":"11434-13184-24-43","grouping_key":"dak_prescott:247.5","id":"11434-13184-24-43:draftkings:player_passing_yards:dak_prescott_under_247_5","is_live":true,"is_main":true,"league":"NFL","limits":null,"market":"Player Passing Yards","name":"Dak Prescott Under 247.5","player_id":"4E18B0FEC4C5","points":247.5,"price":-115,"selection":"Dak Prescott","selection_line":"under","selection_points":247.5,"sport":"football","sportsbook":"DraftKings","team_id":"","timestamp":1730079527.1784158}],"entry_id":"1730079527180-0","type":"locked-odds"}

Fixture Status Updates (Game Time Change)

This will only be sent if you have include_fixture_updates=true

event: fixture-status
id: 1724871720243-0
retry: 5000
data: {"data":{"fixture":{"away_team_display":"Lorenzo Musetti","game_id":"88067-26534-2024-35","home_team_display":"Miomir Kecmanovic","id":"FB0D30DCDD6C","start_date":"2024-08-28T20:30:00+00:00"},"fixture_id":"FB0D30DCDD6C","game_id":"88067-26534-2024-35","league":"ATP","new_start_date":"2024-08-28T20:30:00+00:00","new_status":null,"old_start_date":"2024-08-28T20:20:00+00:00","old_status":null,"sport":"tennis","timestamp":1724871720.2406485},"entry_id":"1724871720243-0"}

Fixture Status Updates (Status Change)

This will only be sent if you have include_fixture_updates=true

event: fixture-status
id: 1724871720243-0
retry: 5000
data: { "data": { "fixture": { "away_team_display": "Saisai Zheng", "game_id": "30697-79652-2024-35", "home_team_display": "Jessika Ponchet", "id": "E145B23767E0", "start_date": "2024-08-27T15:00:00+00:00" }, "fixture_id": "E145B23767E0", "game_id": "30697-79652-2024-35", "league": "WTA", "new_start_date": null, "new_status": "cancelled", "old_start_date": null, "old_status": "unplayed", "sport": "tennis", "timestamp": 1724761586.2172334 }, "entry_id": "1724761586216-0" }

Notes

Choosing a good key to store the data.

If you are tracking multiple sportsbooks for a Game / Market combination. We would recommend making a key of (Fixture ID + Sportsbook + Market + Name).

If you are tracking a single sportsbook for a Game / Market combination. We would recommend making a key of (Fixture Id + Market + Name).

Common Cases

Case 1: Sportsbook moves main line and DOES NOT have any alternate lines

Original Lines:

Over 5.5 | -110 | is_main=True
Under 5.5 | +110 | is_main=True

Sportsbook changes lines:

Over 5.5 | -110 | is_main=True ----> Over 6.5 | -110 | is_main=True
Under 5.5 | +110 | is_main=True ----> Under 6.5 | +110 | is_main=True

Filter is_main=True:

The events you will receive are:

{event: "locked-odds", data: {"data":[{"bet_name": "Over 5.5", "is_main": True, "bet_price": -110, ....}
{event: "locked-odds", data: {"data":[{"bet_name": "Under 5.5", "is_main": True, "bet_price": +110, ....}
{event: "odds", data: {"data":[{"bet_name": "Over 6.5", "is_main": True, "bet_price": -110, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 6.5", "is_main": True, "bet_price": +110, ....}

Filter is_main=False:

You will not receive any events.

Filter is_main is not set

The events you will receive are:

{event: "locked-odds", data: {"data":[{"bet_name": "Over 5.5", "is_main": True, "bet_price": -110, ....}
{event: "locked-odds", data: {"data":[{"bet_name": "Under 5.5", "is_main": True, "bet_price": +110, ....}
{event: "odds", data: {"data":[{"bet_name": "Over 6.5", "is_main": True, "bet_price": -110, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 6.5", "is_main": True, "bet_price": +110, ....}

Case 2: Sportsbook moves main line and DOES HAVE alternate lines.

Original Lines:

Over 5.5 | -110 | is_main=True
Under 5.5 | +110 | is_main=True
Over 6.5 | +120 | is_main=False
Under 6.5 | -120 | is_main=False

Sportsbook changes lines:

Over 5.5 | -110 | is_main=True ----> Over 5.5 | -120 | is_main=False
Under 5.5 | +110 | is_main=True ----> Under 5.5 | +120 | is_main=False
Over 6.5 | +120 | is_main=False ----> Over 6.5 | -110 | is_main=True
Under 6.5 | -120 | is_main=False ----> Under 6.5 | +110 | is_main=True

Filter is_main=True:

The events you will receive are:

{event: "odds", data: {"data":[{"bet_name": "Over 6.5", "is_main": True, "bet_price": -110, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 6.5", "is_main": True, "bet_price": +110, ....}

Note that we WILL NOT send any locked events for:

Over 5.5 | -110 | is_main=True
Under 5.5 | +110 | is_main=True

Filter is_main=False:

The events you will receive are:

{event: "odds", data: {"data":[{"bet_name": "Over 5.5", "is_main": False, "bet_price": -120, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 5.5", "is_main": False, "bet_price": +120, ....}

Note that we WILL NOT send any locked events for:

Over 6.5 | +120 | is_main=False
Under 6.5 | -120 | is_main=False

Filter is_main is not set

The events you will receive are:

{event: "odds", data: {"data":[{"bet_name": "Over 5.5", "is_main": False, "bet_price": -120, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 5.5", "is_main": False, "bet_price": +120, ....}
{event: "odds", data: {"data":[{"bet_name": "Over 6.5", "is_main": True, "bet_price": -110, ....}
{event: "odds", data: {"data":[{"bet_name": "Under 6.5", "is_main": True, "bet_price": +110, ....}

Note that we WILL NOT send any locked events for:

Over 5.5 | -110 | is_main=True
Under 5.5 | +110 | is_main=True
Over 6.5 | +120 | is_main=False
Under 6.5 | -120 | is_main=False