๐Ÿ“‹ Displaying Bets

Understanding the Bet Structure

SharpSports represents all bets in the same format, regardless of what sportsbook they come from. It's important to understand the ๐Ÿ’ฐ BetSlip and ๐Ÿ“ƒ Bet structure to decide how you'd like to present the bets to bettors.

Utilize Pre-Built Data Mapping Integrations

SharpSports supports integrations with multiple data providers that can be helpful when looking to map the SharpSports ๐Ÿ’ฐ BetSlipand ๐Ÿ“ƒ Bet data with other sources.

Event Ids

You'll find mapped ๐ŸŽŸ๏ธ event ids to various data providers on the event object, which is included in both ๐Ÿท๏ธ MarketSelection and ๐Ÿ“ƒ Bet objects.

Use this mapping to show users scores, stats and other pieces of information alongside their tracked bets.

Market Ids

You'll find mapped market ids to various data providers on the ๐Ÿท๏ธ MarketSelection and ๐Ÿ“ƒ Bet object. Different data providers define markets differently, so make sure to understand what the market corresponds to.

Use this mapping to show live odds, closing line value, and other relevant data points.

Player and Team Ids

You'll find mapped player and team ids to various data providers on the โ›น๏ธโ€โ™‚๏ธ Player, ๐ŸŽฝ Team, ๐Ÿท๏ธ MarketSelection and ๐Ÿ“ƒ Bet objects.

Use this mapping to show headshots, logos, and various stats related to those specific players and teams.

Complete vs Incomplete Bets

You'll notice that ๐Ÿ“ƒ Bet and ๐Ÿ’ฐ BetSlip objects have an incomplete attribute. When incomplete=true, that means that particular bet or betslip has not been fully parsed into all the relevant qualitative features.

All the attributes related to the accounting of the ๐Ÿ’ฐ BetSlip (atRisk,toWin,odds, status) and the bookDescription will always be displayed but the specific event, player, team, proposition, position, etc. may not be included on the object.

When the bet is incomplete SharpSports recommends only using those fields when displaying the bet to the user. You won't be able to filter or query by all the fields used on a complete bet, but the bettor will always recognize the bookDescription since it is the string representation of what they saw when they placed the bet.


The vast majority of bets are complete, and SharpSports is working towards a 100% complete rate but there are always edge cases and new types of bets that will be incomplete for some period of time.