Version: 2.0.0

Odds

REQUIREMENT

You'll need a license key to use OddsJam's API. You can get one by emailing us at [email protected].

API Endpoint#

https://api-external.oddsjam.com/api/v2/game-odds

Parameters#

`key` (required)#

Your OddsJam API license key.

NOTE

You can only pass in five or less game_id, player_id, or team_id per request.

NOTE

A game_id, player_id, or team_id is required per request.

A sportsbook is required per request.

`game_id`#

NOTE

You can pass in multiple of this parameter.

The game_id you want to receive odds for (e.g. 13602-17233-23-06)

`team_id`#

NOTE

You can pass in multiple of this parameter.

The team_id you want to receive odds for (e.g. EDF03AD3C346)

`player_id`#

NOTE

You can pass in multiple of this parameter.

The player_id you want to receive odds for (e.g. E61E5ECAC811)

The OddsJam game ID you want to receive odds for (e.g. 39341-78014-2022-01-17)

`sportsbook` (required)#

NOTE

You can pass in multiple of this parameter.

The sportsbook(s) you want to receive odds for. You must pass at least one sportsbook. We support the following:

10bet
5Dimes
888sport
888sport (Canada)
Action 24/7
Bally Bet
bet365
BET99
Bet America
Betano
BetAnySports
Betcris
BetDSI
BetDSI (Retro Book)
BetDSI (Superbook)
Betfair
Betfair Exchange
Betfred
betJACK
Betly
Betly (Ohio)
Betly (Tennessee)
BetMGM
BetNow
BetOnline
BetonUSA
BetOpenly
betPARX
betr (Australia)
Bet Right
BetRivers
BetRivers (New York)
BetRivers (Ontario)
Betsafe
Betsson
Betstar
BetUK
BetUS
BetVictor
Betway
Betway (Arizona)
Betway (Canada)
Betway (Colorado)
Betway (Iowa)
Betway (New Jersey)
Betway (Ohio)
Betway (Virginia)
BetWildwood
BlueBet
Bodog
BookMaker
Bookmaker (Australia)
BoomBet
Boom Fantasy
Borgata
Bovada
bwin
Caesars
Caesars (Ontario)
Caesars (Tennessee)
Casumo
Circa Sports
Circa Vegas
ClutchBet
ComeOn!
Coolbet
Coral
Desert Diamond
DraftKings
DraftKings (Tennessee)
DRF
Elite Sportsbook
ESPN BET
Everygame
Fanatics
FanDuel
FireKeepers
Fliff
Four Winds
FOX Bet
FOX Bet (Michigan)
FOX Bet (Pennsylvania)
GambetDC
Golden Nugget
Golden Nugget (Michigan)
Golden Nugget (New Jersey)
Hard Rock
Hard Rock (Arizona)
Hard Rock (Iowa)
Hard Rock (New Jersey)
Hard Rock (Virginia)
Heritage
HotStreak
Intertops
Jazz Sports
Jock MKT
Kutt
Ladbrokes
Ladbrokes (Australia)
LeoVegas
Looselines
LowVig
MaximBet
Mise-o-jeu
Monkey Knife Fight
Mr Green
MyBookie
Neds
Nitrogen
No House Advantage
NorthStar Bets
OddsJam Algo Odds
Paddy Power
Palmerbet
ParlayPlay (4 Pick)
ParlayPlay (6 Pick)
partypoker
Picklebet
Pinnacle
Pinny
Play Alberta
Play Eagle
Play Maverick
PlayNow
PlayUp
PlayUp (Australia)
PointsBet
PointsBet (Australia)
PointsBet (Colorado)
PointsBet (Illinois)
PointsBet (Indiana)
PointsBet (Iowa)
PointsBet (Kansas)
PointsBet (Louisiana)
PointsBet (Maryland)
PointsBet (Michigan)
PointsBet (New Jersey)
PointsBet (New York)
PointsBet (Ohio)
PointsBet (Ontario)
PointsBet (Pennsylvania)
PointsBet (Virginia)
PointsBet (West Virginia)
PowerPlay
PrizePicks
PrizePicks (5 or 6 Pick Flex)
Proline
Prophet Exchange
Resorts
Resorts World Bet
Rivalry
Royal Panda
SBK
SI
Sky Bet
Sleeper
Smarkets
Spin Sports
Sportsbet
Sportsbetting.ag
SportsBetting.com
Sports Interaction
Sporttrade
Stake
SugarHouse
SuperBook
Suprabets
SX Bet
TAB
TAB (New Zealand)
TABtouch
theScore
ThriveFantasy
Tipico
TonyBet
TwinSpires
Underdog Fantasy
Underdog Fantasy (3 or 5 Pick)
Unibet
Unibet (Australia)
Unibet (United Kingdom)
Westgate
William Hill
William Hill (Europe)
William Hill (United Kingdom)
Wind Creek
WynnBET
WynnBET (Massachusetts)
WynnBET (Michigan)
WynnBET (New Jersey)
WynnBET (New York)
Xbet
YouWager

To pass multiple sportsbooks, you pass it like this: &sportsbook=FanDuel&sportsbook=DraftKings

OddsJam Proprietary No-Vig Odds#

Please contact us for access to OddsJam proprietary no-vig odds.

If access is granted, use OddsJam Algo Odds as the sportsbook in your query.

`market_name`#

NOTE

You can pass in multiple of this parameter.

The market you want to receive odds for (e.g. Moneyline)

`is_main`#

Flag to filter for odds for main lines (supports values true, yes, t, 1). This parameter indicates whether a line is the "main" or "given" line for a market. For example, the +/- 6 Point Spread and the Over/Under 46.5 Total Points lines are the "main" lines for the DraftKings game below:

`odds_format`#

The format of the odd price. Options are AMERICAN|PROBABILITY|DECIMAL. We default to american prices.

`include_mobile_deep_link_url`#

Please contact us for access to deep link urls.

This will cause deep_link_url to be in the form:

deep_link_url: {"mobile": "...", "desktop": "..."}

`include_team_ids`#

Whether or not to include the team_id field on the odds returned, if there is no matching team id, this will default to null.

`include_grouping_keys`#

This is an optional field, and if it is set to true, it will add a grouping_key field to each odd that you can use to group odds across bet points. This is useful for cases when you have a spread market with these bet names: ["Home -1", "Away +1", "Home +1", "Away -1"], it is not straightforward how to know which home/away pair makeup the same market. The grouping_key will be unique for a given market and should faciliate this.

Example Response#

{
    "data": [
        {
            "id": "39506-40644-2023-08-13-09",
            "start_date": "2023-08-13T12:05:00-04:00",
            "home_team": "Boston Red Sox",
            "away_team": "Detroit Tigers",
            "is_live": false,
            "is_popular": true,
            "tournament": null,
            "status": "unplayed",
            "sport": "baseball",
            "league": "MLB",
            "odds": [
                {
                    "id": "39506-40644-2023-08-13-09:draftkings:player_strikeouts:eduardo_rodriguez_over_5_5",
                    "sports_book_name": "DraftKings",
                    "name": "Eduardo Rodriguez Over 5.5",
                    "price": -135,
                    "timestamp": 1691932813.2485504,
                    "bet_points": 5.5,
                    "is_main": true,
                    "is_live": false,
                    "market_name": "Player Strikeouts",
                    "market": "player_strikeouts",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": "1703DC89B0A0",
                    "selection": "Eduardo Rodriguez",
                    "normalized_selection": "eduardo_rodriguez",
                    "selection_line": "over",
                    "selection_points": 5.5
                },
                {
                    "id": "39506-40644-2023-08-13-09:draftkings:run_line:boston_red_sox_+1_5",
                    "sports_book_name": "DraftKings",
                    "name": "Boston Red Sox +1.5",
                    "price": -215,
                    "timestamp": 1691906920.9585743,
                    "bet_points": 1.5,
                    "is_main": false,
                    "is_live": false,
                    "market_name": "Run Line",
                    "market": "run_line",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": null,
                    "selection": "Boston Red Sox",
                    "normalized_selection": "boston_red_sox",
                    "selection_line": null,
                    "selection_points": 1.5
                },
                {
                    "id": "39506-40644-2023-08-13-09:draftkings:run_line:boston_red_sox_-1_5",
                    "sports_book_name": "DraftKings",
                    "name": "Boston Red Sox -1.5",
                    "price": 154,
                    "timestamp": 1691899249.0454822,
                    "bet_points": -1.5,
                    "is_main": true,
                    "is_live": false,
                    "market_name": "Run Line",
                    "market": "run_line",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": null,
                    "selection": "Boston Red Sox",
                    "normalized_selection": "boston_red_sox",
                    "selection_line": null,
                    "selection_points": -1.5
                },
                {
                    "id": "757CD7617965",
                    "sports_book_name": "Caesars",
                    "name": "Boston Red Sox",
                    "price": -130,
                    "timestamp": 1691929868.4992077,
                    "bet_points": null,
                    "is_main": true,
                    "is_live": false,
                    "market_name": "Moneyline",
                    "market": "moneyline",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": null,
                    "selection": "Boston Red Sox",
                    "normalized_selection": "boston_red_sox",
                    "selection_line": null,
                    "selection_points": null
                },
                {
                    "id": "470BBEE6141F",
                    "sports_book_name": "Caesars",
                    "name": "Over 9.5",
                    "price": 100,
                    "timestamp": 1691932202.0163093,
                    "bet_points": 9.5,
                    "is_main": true,
                    "is_live": false,
                    "market_name": "Total Runs",
                    "market": "total_runs",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": null,
                    "selection": "",
                    "normalized_selection": "",
                    "selection_line": "over",
                    "selection_points": 9.5
                },
                {
                    "id": "39506-40644-2023-08-13-09:fanduel:team_total:boston_red_sox_over_4_5",
                    "sports_book_name": "FanDuel",
                    "name": "Boston Red Sox Over 4.5",
                    "price": -128,
                    "timestamp": 1691932509.6268106,
                    "bet_points": 4.5,
                    "is_main": true,
                    "is_live": false,
                    "market_name": "Team Total",
                    "market": "team_total",
                    "home_rotation_number": null,
                    "away_rotation_number": null,
                    "deep_link_url": null,
                    "player_id": null,
                    "selection": "Boston Red Sox",
                    "normalized_selection": "boston_red_sox",
                    "selection_line": "over",
                    "selection_points": 4.5
                },
                ...
            ]
        }
    ]
}

Notes#

id#

The ID that we return for each odd object is not guaranteed to be of any specific format and is subject to change. Note that using this id will also not allow you to track line changes or historical movements because of the availability of alternate lines.

All Lines:#

If you store and keep track of multiple sportsbooks for the same game / market combination, we would recommend constructing your own id using the following format: <game_id>:<sportsbook>:<market>:<name>:<player_id>.

If you store and keep track of a single sportsbook for the same game / market combination, we would recommend constructing your own id using the following format: <game_id>:<market>:<name>:<player_id>.

Main Lines Only:#

If you want to track line changes for the main (is_main=True) lines of a market, we would recommend constructing your own id using the following format: <game_id>:<sportsbook>:<market>:<selection>:<selection_line>:<player_id>.

Some examples below:

Moneyline: 39506-40644-2023-08-13-09:DraftKings:Moneyline:Boston Red Sox:null:null
Run Line: 39506-40644-2023-08-13-09:Caesars:Boston Red Sox:null:null
Total Runs: 39506-40644-2023-08-13-09:Caesars::over:null
Player Strikeouts: 39506-40644-2023-08-13-09:DraftKings:Player Strikeouts:Eduardo Rodriguez:over:AHF3454FEF
Team Total: 39506-40644-2023-08-13-09:Fanduel:Team Total:Boston Red Sox:over:null

REQUIREMENT

API Endpoint#

Parameters#

key (required)#

NOTE

NOTE

game_id#

NOTE

team_id#

NOTE

player_id#

NOTE

sportsbook (required)#

NOTE

OddsJam Proprietary No-Vig Odds#

market_name#

NOTE

is_main#

odds_format#

include_mobile_deep_link_url#

include_team_ids#

include_grouping_keys#

Example Response#

Notes#

id#

All Lines:#

Main Lines Only:#

`key` (required)#

`game_id`#

`team_id`#

`player_id`#

`sportsbook` (required)#

`market_name`#

`is_main`#

`odds_format`#

`include_mobile_deep_link_url`#

`include_team_ids`#

`include_grouping_keys`#