Odds Push Feed API Documentation

Requirement

You need an Enterprise plan to use the OddsBlaze push feed.

Description

This endpoint streams real-time odds data by SSE push feed.

API Endpoint

https://stream.oddsblaze.com/

Parameters

key (required)

Your OddsBlaze API key.

sportsbook

The sportsbook id (e.g., draftkings or hard-rock). Separate multiple sportsbooks with commas (e.g., draftkings,hard-rock,betmgm).

league

The league id (e.g., nfl or mlb). Separate multiple leagues with commas (e.g., nfl,ncaaf,nba).

Last-Event-ID

When reconnecting, provide the Last-Event-ID header (or last-event-id URL parameter) with the most recent event id (e.g., 1758600171703-0). This ensures the feed resumes from the point where the connection was interrupted, preventing missed updates.

Connections

A single connection can stream all sportsbooks for one league or all leagues for one sportsbook. If your request includes too many league or sportsbook parameters, the server will return an error:

{"message": "Missing league or sportsbook"}

{"message": "Too many leagues or sportsbooks"}

{"message": "Too many leagues"}

{"message": "Too many sportsbooks"}

{"message": "Too many connections"}

Example URLs

SSE push feed, DraftKings sportsbook, all leagues:

https://stream.oddsblaze.com/?key=your_key&sportsbook=draftkings

SSE push feed, all sportsbooks, NFL league:

https://stream.oddsblaze.com/?key=your_key&league=nfl

SSE push feed, DraftKings and BetMGM sportsbooks, MLB league:

https://stream.oddsblaze.com/?key=your_key&sportsbook=draftkings,betmgm&league=mlb

SSE push feed, Caesars sportsbook, NFL and NCAAF leagues:

https://stream.oddsblaze.com/?key=your_key&sportsbook=caesars&league=nfl,ncaaf

Example Events

Connected

event: connected
retry: 5000
data: connected

Ping

event: ping
retry: 5000
data: 2025-09-23T04:36:27.143Z

Snapshot

Initial snapshot of all odds on connection:

event: snapshot
retry: 5000
data: {
    "updated": "2025-09-23T03:31:41.768Z",
    "league": {
        "id": "mlb",
        "name": "MLB",
        "sport": "Baseball"
    },
    "sportsbook": {
        "id": "draftkings",
        "name": "DraftKings"
    },
    "events": [
        {
            "id": "de73b045-eed4-550e-9a29-f8cbbaf3da86",
            "teams": {
                "away": {
                    "id": "bfc5756a-a687-58df-b27a-557e6aa926e4",
                    "name": "St. Louis Cardinals",
                    "abbreviation": "STL"
                },
                "home": {
                    "id": "c9feeac3-f9db-5701-81df-5b5518035c2b",
                    "name": "San Francisco Giants",
                    "abbreviation": "SF"
                }
            },
            "date": "2025-09-23T01:45:00.000Z",
            "live": true,
            "odds": [
                {
                    "id": "DraftKings#de73b045-eed4-550e-9a29-f8cbbaf3da86#Player Hits#Jordan Walker Over 1.5#00fb6432-902a-5b17-909e-decc54ba3444",
                    "market": "Player Hits",
                    "name": "Jordan Walker Over 1.5",
                    "price": "+1600",
                    "main": false,
                    "links": {
                        "desktop": "https://sportsbook.draftkings.com/event/32815920?outcomes=0QA278693132%23349216440_13L84240Q1-1669458125Q20"
                    },
                    "sgp": null,
                    "selection": {
                        "name": "Jordan Walker",
                        "side": "Over",
                        "line": 1.5
                    },
                    "player": {
                        "id": "00fb6432-902a-5b17-909e-decc54ba3444",
                        "name": "Jordan Walker",
                        "position": "RF",
                        "number": "18",
                        "team": {
                            "id": "bfc5756a-a687-58df-b27a-557e6aa926e4",
                            "name": "St. Louis Cardinals",
                            "abbreviation": "STL"
                        }
                    }
                }
            ]
        }
    ]
}

Locked

All odds for a sportsbook/league locked:

event: locked
id: 1758600171703-0
retry: 5000
data: {
    "league": {
        "id": "nfl",
        "name": "NFL",
        "sport": "Football"
    },
    "sportsbook": {
        "id": "draftkings",
        "name": "DraftKings"
    }
}

Odds

Odds changed and/or locked:

event: odds
id: 1758598049832-0
retry: 5000
data: {
    "updated": "2025-09-23T03:31:41.768Z",
    "league": {
        "id": "mlb",
        "name": "MLB",
        "sport": "Baseball"
    },
    "sportsbook": {
        "id": "draftkings",
        "name": "DraftKings"
    },
    "events": [
        {
            "id": "de73b045-eed4-550e-9a29-f8cbbaf3da86",
            "teams": {
                "away": {
                    "id": "bfc5756a-a687-58df-b27a-557e6aa926e4",
                    "name": "St. Louis Cardinals",
                    "abbreviation": "STL"
                },
                "home": {
                    "id": "c9feeac3-f9db-5701-81df-5b5518035c2b",
                    "name": "San Francisco Giants",
                    "abbreviation": "SF"
                }
            },
            "date": "2025-09-23T01:45:00.000Z",
            "live": true,
            "odds": [
                {
                    "id": "DraftKings#de73b045-eed4-550e-9a29-f8cbbaf3da86#Player Hits#Jordan Walker Over 1.5#00fb6432-902a-5b17-909e-decc54ba3444",
                    "market": "Player Hits",
                    "name": "Jordan Walker Over 1.5",
                    "price": "+1600",
                    "main": false,
                    "links": {
                        "desktop": "https://sportsbook.draftkings.com/event/32815920?outcomes=0QA278693132%23349216440_13L84240Q1-1669458125Q20"
                    },
                    "sgp": null,
                    "selection": {
                        "name": "Jordan Walker",
                        "side": "Over",
                        "line": 1.5
                    },
                    "player": {
                        "id": "00fb6432-902a-5b17-909e-decc54ba3444",
                        "name": "Jordan Walker",
                        "position": "RF",
                        "number": "18",
                        "team": {
                            "id": "bfc5756a-a687-58df-b27a-557e6aa926e4",
                            "name": "St. Louis Cardinals",
                            "abbreviation": "STL"
                        }
                    }
                },
                {
                    "id": "DraftKings#de73b045-eed4-550e-9a29-f8cbbaf3da86#Player Total Bases#Jordan Walker Over 3.5#00fb6432-902a-5b17-909e-decc54ba3444",
                    "locked": true
                }
            ]
        }
    ]
}