📅
Get events
Returns all events and their respective markets and orderbooks
This endpoint will return every event which is currently open for betting at Purebet.
The response contains sports, sports contain leagues, leagues contain events, events contain markets, markets contain market sides
Each event contains the following attributes.
- event: string, the name of the event
- highlight: boolean, whether or not this event is highlighted on the Purebet website
- homeTeam: string, the name of the home team in this event
- awayTeam: string, the name of the away team in this event
- startDate: number, seconds since January 1st 1970, UTC (unix format), of the starting time of this event
- moneyline or full_time_result: object, information for the moneyline or full_time_result market of this event. Note: the attribute full_time_result only appears for soccer events, and is an object with 3 attributes: home, away, and draw. Each of these points to a market.
- over_under: array of market objects, information for different totals lines of this event
Each market contains the following attributes.
- id1: number, needed to place a bet on this market through the Purebet API
- id2: number, also needed to place a bet on this market through the Purebet API
- (line: number, the value of the over_under line. Not shown in moneyline or full_time_result markets)
- home or over or Back: object, contains information about the home or over or Back market side.
- away or under or Lay: object, contains information about the away or under or Lay market side.
- sport: string, the sport to which this event belongs, at the time of writing will be one of soccer, americanfootball, tennis, esports, basketball, hockey, cryptocurrency, politics
Each market side contains the following attributes.
- highestOdds: number, the highest odds on this market side
- stakeAtHighestOdds: number, the amount in USDC that can be risked at these odds and matched
- secondHighestOdds: number, the second highest odds on this market side
- stakeAt2ndHighestOdds: number, the amount in USDC that can be risked at these odds and matched. Note that this number does not include stakeAtHighestOdds.
- thirdHighestOdds: number, the third highest odds on this market side
- stakeAt3rdHighestOdds: number, the amount in USDC that can be risked at these odds and matched. Note that this number does not include stakeAtHighestOdds nor stakeAt2ndHighestOdds.
"basketball": {
"USA NBA": [
{
"highlight": false,
"startDate": 1680741600,
"over_under": [
{
"line": 243.5,
"id1": 62,
"id2": 215,
"over": {
"highestOdds": 2.0,
"stakeAtHighestOdds": 400.0,
"secondHighestOdds": 0,
"stakeAt2ndHighestOdds": 0,
"thirdHighestOdds": 0,
"stakeAt3rdHighestOdds": 0
},
"under": {
"highestOdds": 1.84,
"stakeAtHighestOdds": 400.0,
"secondHighestOdds": 0,
"stakeAt2ndHighestOdds": 0,
"thirdHighestOdds": 0,
"stakeAt3rdHighestOdds": 0
}
}
],
"handicaps": [
{
"line": -5.5,
"id1": 62,
"id2": 216,
"home": {
"highestOdds": 1.84,
"stakeAtHighestOdds": 400.0,
"secondHighestOdds": 0,
"stakeAt2ndHighestOdds": 0,
"thirdHighestOdds": 0,
"stakeAt3rdHighestOdds": 0
},
"away": {
"highestOdds": 2.0,
"stakeAtHighestOdds": 400.0,
"secondHighestOdds": 0,
"stakeAt2ndHighestOdds": 0,
"thirdHighestOdds": 0,
"stakeAt3rdHighestOdds": 0
}
}
],
"homeTeam": "Dallas Mavericks",
"awayTeam": "Sacramento Kings",
"moneyline": {
"id1": 62,
"id2": 214,
"home": {
"highestOdds": 1.46,
"stakeAtHighestOdds": 46.96,
"secondHighestOdds": 1.43,
"stakeAt2ndHighestOdds": 220.45,
"thirdHighestOdds": 1.42,
"stakeAt3rdHighestOdds": 431.96
},
"away": {
"highestOdds": 2.96,
"stakeAtHighestOdds": 67.56,
"secondHighestOdds": 2.94,
"stakeAt2ndHighestOdds": 467.56,
"thirdHighestOdds": 2.92,
"stakeAt3rdHighestOdds": 34.93
}
},
"sport": "basketball",
"event": "Dallas Mavericks vs. Sacramento Kings"
}
For Lay market sides, all odds are in backer's odds, and all stakes are denoted in the risk of the lay bettor, not the stake placed by the back bettor.
Also note that full_time_result markets return 3 different id pairs, each for the home, draw, and away markets.
The response can be filtered by adding optional parameters to the query URL.
Returning only events for a particular sport by using the
sport
parameter:- sport: string, a sport name from the list of available sports. The full list can be found by calling the getSports endpoint (https://api.purebet.io/pbapi?getSports)
When this optional parameters is present, the API response returns leagues from that sport which contain events which contain markets. Note: only events within 24 hours are returned. For events further in the future, use filtering by league.
Returning only events for a particular league by using the
league
parameter:- league: string, a league abbreviation from the list of available abbreviations. The full list can be found by calling the getLeaguesFor endpoint followed by the sport parameter. e.g.: https://api.purebet.io/pbapi?getLeaguesFor=basketball
When this optional parameters is present, the API response is a list of events from that league which contain markets.
Returning only markets for a particular event or market ID by using the
filterBy
parameter:- filterBy: string, either "market" or "event", get a specific event or market. If filterBy is set to "event", then given any id1 and id2 combination of a market within that event, the API will return all markets of that event.
- id1: number, id1 of the market
- id2: number, id2 of the market
When these optional parameters are present, the API response is an Event or Market object, depending on filterBy.
Last modified 3mo ago