└── README.md
/README.md:
--------------------------------------------------------------------------------
1 | # TheSpread.io API
2 |
3 | An API that aggregates sports betting odds/lines.
4 |
5 | This API is **FREE** and designed for readability and easy integration.
6 |
7 |
8 | # Requests
9 |
10 | This API is currently in beta. The two available endpoints are:
11 |
12 | - https://thespread.azureedge.net/odds/nfl.json
13 | - https://thespread.azureedge.net/odds/college-football.json
14 |
15 | This API will eventually be hosted at api.thespread.io
16 |
17 | # Response
18 |
19 | The structure of an odds json response is similar to the following:
20 |
21 | ```
22 | [
23 | {
24 | "Event": "Bears at Buffalo",
25 | "Date": "2018-11-04T18:00:00+00:00",
26 | "Odds": [
27 | {
28 | "Source": "Unibet",
29 | "Team1Spread": "CHI -10 (-111)",
30 | "Team1Money": "CHI -500",
31 | "Team2Spread": "BUF +10 (-109)",
32 | "Team2Money": "BUF +360",
33 | "OverUnder": "37.5 -111/-109"
34 | },
35 | {
36 | "Source": "Westgate",
37 | "Team1Spread": "CHI -10 (-110)",
38 | "Team1Money": "CHI -550",
39 | "Team2Spread": "BUF +10 (-110)",
40 | "Team2Money": "BUF +400",
41 | "OverUnder": "38 -110/-110"
42 | }
43 | ]
44 | },
45 | {
46 | "Event": "Tampa Bay at Carolina",
47 | "Date": "2018-11-04T18:00:00+00:00",
48 | "Odds": [
49 | {
50 | "Source": "Unibet",
51 | "Team1Spread": "TB +6.5 (-110)",
52 | "Team1Money": "TB +245",
53 | "Team2Spread": "CAR -6.5 (-110)",
54 | "Team2Money": "CAR -312",
55 | "OverUnder": "54.5 -115/-105"
56 | },
57 | {
58 | "Source": "Westgate",
59 | "Team1Spread": "TB +6 (-110)",
60 | "Team1Money": "TB +230",
61 | "Team2Spread": "CAR -6 (-110)",
62 | "Team2Money": "CAR -280",
63 | "OverUnder": "56 -110/-110"
64 | }
65 | ]
66 | }
67 | ]
68 | ```
69 |
70 | Notes:
71 | - Response contains Events within the past 48 hours, and known future events.
72 | - Spread, Money Line, and O/U values may contain `null`.
73 | - Not all Sources will exist for every Event.
74 | - Not all Events will always be listed.
75 |
76 | ## How to read the odds:
77 |
78 |
79 |
80 | **Spread**: "`[TeamAbbreviation] [PointSpread] ([Vigorish])`"
81 |
82 | | Value Part | Description |
83 | | --- | --- |
84 | | TeamAbbreviation | Shortened Team Name/Identifier. |
85 | | 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. |
86 | | 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. |
87 |
88 |
89 |
90 | **MoneyLine**: "`[TeamAbbreviation] [MoneyLine]`"
91 |
92 | | Value Part | Description |
93 | | --- | --- |
94 | | TeamAbbreviation | Shortened Team Name/Identifier. |
95 | | 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. |
96 |
97 |
98 |
99 | **OverUnder**: "`[TotalPoints] [OverLine]/[UnderLine]`"
100 |
101 | | Value Part | Description |
102 | | --- | --- |
103 | | 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. |
104 | | 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. |
105 | | 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. |
106 |
107 |
108 |
109 |
110 | # Data Source
111 |
112 | The Odds Sources that are currently available within each file/for each event:
113 | - Caesar's
114 | - Unibet
115 | - Westgate
116 | - William Hill
117 | - Wynn
118 |
119 | Note: there is no guarantee of accuracy at this time.
120 |
121 |
122 | # Roadmap
123 |
124 | Short roadmap of future enhancements:
125 | - Include 'open' values
126 | - Include 'last change date' values and previous value
127 | - Include local event time in addition to UTC time
128 | - Include complete history of lines for a single event
129 |
130 | # Questions/Comments
131 |
132 | Please feel free to open issues with any questions you may have.
133 |
134 |
--------------------------------------------------------------------------------