Bet slips are pulled from a bettor's sportsbook account on refresh. Once in the SharpSports database, bet slips can be requested using any of our betSlip
endpoints / queries. A BetSlip resource represents a wager placed by a bettor with their sportsbook. A bet slip can have multiple bets attached in the case of a parlay, teaser or other multiple outcome wager type.
{
"id": "SLIP_b2d0fded980345b39ca728e0240e45d4",
"bettor": "BTTR_4a8ff3b74a394bb3a928b9ca53147faf",
"book": {
"id": "BOOK_nhLZ9l5DRs6w6KcE2n7vnw",
"name": "DraftKings",
"abbr": "dk"
},
"bettorAccount": "BACT_44c71c332f4d4c61a90440eaff473bd1",
"bookRef": "637779508179321312",
"timePlaced": "2022-01-16T17:26:57Z",
"type": "parlay",
"subtype": null,
"oddsAmerican": 13000,
"atRisk": 500,
"toWin": 65000,
"status": "completed",
"outcome": "loss",
"refreshResponse": "RRES_da3df19bc3a74975a2d76113b761eac2",
"incomplete": true,
"netProfit": -500,
"dateClosed": "2022-01-16",
"typeSpecial": null,
"bets": [
{
"id": "BET_b71653bf80ca4ba69e8913904e817582",
"type": null,
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": null,
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": null,
"line": null,
"oddsAmerican": null,
"status": "completed",
"outcome": "loss",
"live": false,
"incomplete": true,
"bookDescription": "PHI Eagles @ TB Buccaneers - 1st Touchdown Scorer - 1st Half - Mike Evans",
"marketSelection": null,
"propDetails": null
},
{
"id": "BET_f92a6c26dccc427c86ccfcb26ef07112",
"type": "straight",
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": "total",
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": "Under",
"line": 57.5,
"oddsAmerican": null,
"status": "completed",
"outcome": "win",
"live": false,
"incomplete": false,
"bookDescription": "PHI Eagles @ TB Buccaneers - Alternate Total Points - Under 57.5",
"marketSelection": null,
"propDetails": null
},
{
"id": "BET_0f9c662b736a420fb369dc2de6f6ac81",
"type": "prop",
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": "total",
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": "Over",
"line": 2.5,
"oddsAmerican": null,
"status": "completed",
"outcome": "loss",
"live": false,
"incomplete": false,
"bookDescription": "PHI Eagles @ TB Buccaneers - Tom Brady Passing Touchdowns - 3+",
"marketSelection": null,
"propDetails": {
"future": false,
"player": "Tom Brady",
"playerId": null,
"team": null,
"teamId": null,
"matchupSpecial": null,
"metricSpecial": "Passing Touchdowns",
"metricSpecialId": "METR_passtds"
}
},
{
"id": "BET_76e1c9f659ed47b798f03d1aa6b4f21d",
"type": "prop",
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": "total",
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": "Over",
"line": 49.5,
"oddsAmerican": null,
"status": "completed",
"outcome": "loss",
"live": false,
"incomplete": false,
"bookDescription": "PHI Eagles @ TB Buccaneers - Jalen Hurts Rushing Yards - Over 49.5",
"marketSelection": null,
"propDetails": {
"future": false,
"player": "Jalen Hurts",
"playerId": "PLYR_d469c8dee6bf40fe93b2a6b966cb97aa",
"team": null,
"teamId": null,
"matchupSpecial": null,
"metricSpecial": "Rushing Yards",
"metricSpecialId": "METR_rushyds"
}
},
{
"id": "BET_4277054b4b714b35930a7c6b83dbd5d2",
"type": "prop",
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": "total",
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": "Over",
"line": 4.5,
"oddsAmerican": null,
"status": "completed",
"outcome": "win",
"live": false,
"incomplete": false,
"bookDescription": "PHI Eagles @ TB Buccaneers - Dallas Goedert Receptions - 5+",
"marketSelection": null,
"propDetails": {
"future": false,
"player": "Dallas Goedert",
"playerId": "PLYR_cf39dc0ae919475c807720d73642815f",
"team": null,
"teamId": null,
"matchupSpecial": null,
"metricSpecial": "Receptions",
"metricSpecialId": "METRI_receptions"
}
},
{
"id": "BET_15225680b00c424f9354ff7b82d85b33",
"type": "straight",
"event": {
"id": "EVNT_aa034faf62bd434fa8046ab9200e6e32",
"sportsdataioId": "17981",
"sportradarId": "130c05e4-aade-4bbe-a654-b9f14812f963",
"oddsjamId": "17233-42288-2022-01-16",
"league": "NFL",
"sport": "Football",
"name": "Philadelphia Eagles @ Tampa Bay Buccaneers",
"nameSpecial": null,
"startTime": "2022-01-16T18:00:00Z",
"startDate": "2022-01-16",
"leagueId": "LGUE_nfl",
"sportId": "SPRT_americanfootball",
"contestantAway": {
"id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
"fullName": "Philadelphia Eagles",
},
"contestantHome": {
"id": "TEAM_6279f243420342e0860707fc914860b8",
"fullName": "Tampa Bay Buccaneers"
},
"neutralVenue": false
},
"proposition": "spread",
"segment": null,
"segmentDetail": null,
"segmentId": "SEGM_M",
"position": "Philadelphia Eagles",
"line": 10.5,
"oddsAmerican": null,
"status": "completed",
"outcome": "loss",
"live": false,
"incomplete": false,
"bookDescription": "PHI Eagles @ TB Buccaneers - Alternate Spread - PHI Eagles +10.5",
"marketSelection": null,
"propDetails": null
}
],
"adjusted": {
"odds": false,
"line": null,
"atRisk": null
}
}
Endpoints
id (string)
A unique identifier representing the betSlip. Each betSlipID will start with the unique character set SLIP_
refreshResponse (hash)
An object representing the refreshResponse that is associated with the betSlip. This attribute corresponds to the most recent refreshResponse that has created or updated this bet object.
bettor (hash)
An object representing the associated bettor. The BettorID can be used to store the bet with the correct bettor.
book (hash)
An object representing the book where the bet was placed. If you want to organize your bets by where they were placed you can use the book object which includes an ID and multiple string descriptors.
bettorAccount (hash)
A object representing the bettorAccount where the bet was made. If you'd like to associate the bet with the specific bettor / sportsbook combination, you can utilize the bettorAccountID.
bookRef (string)
The book's unique identifier for this particular betslip. Each sportsbook has their own system for identifying specific bets. This can be used for support, or for deeper integrations with sports books.
timePlaced (datetime)
The date and time the bet was placed. This field will be null if the sportsbook does not provide this information.
type (string)
A bet slip can be one of the following types:
value | description |
---|---|
single | this is a betslip that contains one single "bet" or wager |
parlay | any betslip that contains multiple combined "bets" |
subtype (string)
Some combination bets have traits that distinguish them from standard parlays. This standardized string provides additional information about the type of the bet, and can be one of the following:
round robin
teaser
typeSpecial (string)
This field can contain an unstandardized string that describes the bet further. For example, By 3's
for some round robin bets or Can't Lose Parlay
for a specially named boosted bet.
oddsAmerican (integer)
Represents the American odds agreed on by the bettor and sportsbook for this bet. If the bet is a parlay, then the odds for each individual bet will differ.
status (string)
Status of the bet slip as of the most recent refresh - completed
or pending
. At the current state, we rely on the sportsbooks for the bet status. You'll need to run frequent refreshes and/or calculate results to have the most up to date status.
atRisk (integer)
Represents the amount of money (in cents) put up by the bettor in the betslip. This is the amount they will lose if the outcome is loss
.
toWin (integer)
Represents the max amount of profit (in cents) that will be paid out to the bettor if the outcome is win
. This is calculated based on the amount atRisk
and the odds set by the sportsbook. If the bet is a parlay this will be calculated using the parlay odds. This value never changes over the lifetime of a betSlip; for example if the bet is a parlay and one leg is a push the updated winnings/payout will be represented in the netProfit field.
netProfit (integer)
Represents the profit generated by the wager (in cents). Typically this field is equal to the toWin
field if the bet has outcome win
and is negative atRisk
if the outcome is loss
. However, in the case of a multi-leg bet with variable winnings you can use this field as the source of truth for how much the wager paid out once it was completed. You can also determine how much money was refunded in the case of outcome = cashout
.
outcome (string)
A string descriptor of the bet outcome. This value will be null until status = completed
.
value | description |
---|---|
win | |
loss | |
push | |
void | |
cashout | |
halfwin | |
halfloss |
incomplete (boolean)
A betSlip is incomplete if any of the attached bets are incomplete.
dateClosed (date)
The date when the wager status changed from pending
-> completed
. This field will be null if the sportsbook does not provide this information.
bets (list)
A list of serialized which determine bet slip outcome. See bet section for details.
adjusted (hash)
adjusted is an object that contains all necessary information to determine whether info on the BetSlip object has been adjusted by a promotion from the sportsbook.
odds (boolean)
This field will be true if the odds of a slip have been adjusted from their original value. This can happen due to various promotions provided by the sportsbooks (i.e. odds boosts, profit boosts, etc.).
atRisk (integer)
This field represents the actual stake at risk to the bettor if it has been adjusted. For example, in the case of a free bet this value will be 0.
line (boolean)
This field will be true if the line on a slip has been adjusted from its original value due to a promotion from the sportsbook.