An API that aggregates sports betting odds/lines.
This API is FREE and designed for readability and easy integration.
This API is currently in beta. The two available endpoints are:
- https://thespread.azureedge.net/odds/nfl.json
- https://thespread.azureedge.net/odds/college-football.json
This API will eventually be hosted at api.thespread.io
The structure of an odds json response is similar to the following:
[
{
"Event": "Bears at Buffalo",
"Date": "2018-11-04T18:00:00+00:00",
"Odds": [
{
"Source": "Unibet",
"Team1Spread": "CHI -10 (-111)",
"Team1Money": "CHI -500",
"Team2Spread": "BUF +10 (-109)",
"Team2Money": "BUF +360",
"OverUnder": "37.5 -111/-109"
},
{
"Source": "Westgate",
"Team1Spread": "CHI -10 (-110)",
"Team1Money": "CHI -550",
"Team2Spread": "BUF +10 (-110)",
"Team2Money": "BUF +400",
"OverUnder": "38 -110/-110"
}
]
},
{
"Event": "Tampa Bay at Carolina",
"Date": "2018-11-04T18:00:00+00:00",
"Odds": [
{
"Source": "Unibet",
"Team1Spread": "TB +6.5 (-110)",
"Team1Money": "TB +245",
"Team2Spread": "CAR -6.5 (-110)",
"Team2Money": "CAR -312",
"OverUnder": "54.5 -115/-105"
},
{
"Source": "Westgate",
"Team1Spread": "TB +6 (-110)",
"Team1Money": "TB +230",
"Team2Spread": "CAR -6 (-110)",
"Team2Money": "CAR -280",
"OverUnder": "56 -110/-110"
}
]
}
]
Notes:
- Response contains Events within the past 48 hours, and known future events.
- Spread, Money Line, and O/U values may contain
null. - Not all Sources will exist for every Event.
- Not all Events will always be listed.
Spread: "[TeamAbbreviation] [PointSpread] ([Vigorish])"
| Value Part | Description |
|---|---|
| TeamAbbreviation | Shortened Team Name/Identifier. |
| PointSpread | The point spread that should be applied to that team's final score. ex: A value of -5 would mean that team needs to win by more than 5 points.ex: A value of +10 would mean that team needs to lose by less than 10 points. |
| Vigorish | aka: Juice, Vig, Cut, Take. The amount of money to risk/lay for a $100 bet. ex: A value of -110 means a better would need to lay $110 to win $100. |
MoneyLine: "[TeamAbbreviation] [MoneyLine]"
| Value Part | Description |
|---|---|
| TeamAbbreviation | Shortened Team Name/Identifier. |
| MoneyLine | The amount of money to risk/lay for a $100 bet. ex: A value of -500 means a better would need to lay $500 to win $100.ex: A value of +360 means a better would need to lay $100 to win $360.note: Unlike a Point Spread bet, the team needs to win outright. |
OverUnder: "[TotalPoints] [OverLine]/[UnderLine]"
| Value Part | Description |
|---|---|
| TotalPoints | A value that represents the estimated combined final scores of both teams. The total points scored during the Event. This is the value the better is betting against, will the combined final score be over or under this value. |
| OverLine | The amount of money to risk/lay for a $100 bet if the better believes the total points scored will be over/more than the TotalPoints value. ex: A value of -110 means a better would need to lay $110 to win $100. |
| UnderLine | The amount of money to risk/lay for a $100 bet if the better believes the total points scored will be under/less than the TotalPoints value. ex: A value of -110 means a better would need to lay $110 to win $100. |
The Odds Sources that are currently available within each file/for each event:
- Caesar's
- Unibet
- Westgate
- William Hill
- Wynn
Note: there is no guarantee of accuracy at this time.
Short roadmap of future enhancements:
- Include 'open' values
- Include 'last change date' values and previous value
- Include local event time in addition to UTC time
- Include complete history of lines for a single event
Please feel free to open issues with any questions you may have.