This Confluence space describes the technologies available for customers wishing to integrate and consume our Sports Data Services products. It explains both the V3 Integration Service contract and describes what is required to receive messages, how those messages should be interpreted and where to get further help or advice.

...

What can I expect to receive?

For Prematch Manager: Updategrams for events, markets and results. Events and markets will be updated until the Kick-Off time, customer will then remove those markets from being avaialble, and resulting information will follow from Genius Sports once the conditions for a result to be produced have been met.

For Inplay Manager: Updategrams for events, markets and results. Events with coverage will receive continuous updates from Kick-Off until completion. Depending on your service level, also Match and Trading State are provided.

How do we know that match has been finished?

...

How will I receive the information?

After an event has been created, any modifications to the event properties, market creation, market price updates, and favorable conditions for resulting will trigger the posting of an Updategram. Each message will contain information specific to a single event. In the case of market updates, Inplay and Prematch market updates will always be separated into their own Updategrams.

What are Updategrams?

Fixture, MarketSet and ResultSet are mandatory messages for the Prematch service. Inplay also includes additional MatchSummary and MatchDetails Updategrams. Optional message types include Coverage and SportProperties.

1. Fixture contains the fixture details to allow your trading platform to create and update events successfully. You can expect to receive as few as one Fixture message per event, with a possible follow-up update sent in case of Kick-Off changes and so forth.
2. MarketSet create the markets for an event and update those markets if prices for the selections within that market change or the market state itself is updated. Each update to a market will trigger a new MarketSet to be posted to your service end point. Simultaneous updates for a single event will be pooled into one inclusive UpdateGram.
3. ResultSet will result all markets that were created for an event. Depending on the sport and your service that you take from Genius Sports, you will receive a ResultSet either after the event has finished or several ResultSets during gameplay, when winning outcomes for markets have become known. Each ResultSet will provide the resulting data for only one market.
4. MatchSummary, MatchDetails and MultiSportMatchState are message types that carry the Inplay Manager's Match State information. Summary is a quick snapshot of the current situation on the pitch whilst Details, as the name suggests, provides a detailed overview of the event and its history. MSMS carries a limited amount of event information if no in-depth data is available to produce full match state content.
5. Coverage messages are posted after a fixture has been booked on the Inplay Manager service or created through the Prematch Manager after reaching the lead-in time. Included in the Coverage message is the Match and Trading State feed availability information as well as the confirmation that your event booking went through. If either Match or Trading State coverage status changes after the initial creation, a new Coverage command is sent.
6. SportProperties (as an optional element in the Fixture message) will provide detailed information for Inplay Tennis, Basketball and Football events down to factors such as the court surface type for Tennis and how many sets will be played to determine the winner.

What is an event or a fixture?

An event aka fixture is a shell into which markets will be created. When a fixture is booked on the Inplay Manager or set up to create on the Prematch Manager, you will receive a Fixture message containing the parameters of the event when the creation conditions have been met. These details include the event name, the event ID, competitor information, competition information, region information and finally, the event state. An event has two states: Scheduled and Deleted. Scheduled indicates that the event is going to go ahead and start at the specified Kick-Off time whilst Deleted indicates that the event has been either cancelled or altered to such a degree that all markets are to be pushed or voided, thereby returning all bets. Whilst the event itself is identical between Prematch and Inplay services, the markets for these events by default are stand-alone. An optional feature, not compatible with all trading platforms, will allow Prematch markets to transition into Inplay markets when the event phase changes from Prematch to Inplay.

What is a market?

A market, identified by the market name, its ID and its market type ID, is a shell for selections that are traded through the market. We will provide you with a spreadsheet listing all our markets market types with full details available for all sports and services during the integration, available here. A market has several statuses that it goes through during its lifecycle.  Please note that PreMatch markets should no longer be offered once the start time of the event is reached and that Genius will not close the Prematch markets, instead the customer's trading platform is responsible for removing those markets from being available at the designated KO/ExpiryUTC.

What are market statuses?

1. Open - market is open for betting.
2. Suspended - market has been temporarily removed from being available.
3. Closed - market has been closed and is not expected, though can be, opened again.
4. Resulted - market has reached the conclusion of its lifecycle and is resulted. Resulted markets cannot transition back to an earlier lifecycle phase.

Market is only meant to be available for betting during the Open status. Other states can include pricing for selections, however market-level status will always override the selection prices and availability. You should no longer offer a market once we have sent the respective ResultSet message, and PreMatch markets should no longer be offered once the start time of the event is reached.

What are selections?

Markets contain several selections that are entries on which bets can be placed. Selection count and type depends on the market type itself. Details for each market type and its selections are available on the included documentation.

Will all selections for a market be sent through at market creation?

...

What are selection states?

1. Unpriced – the selection has not yet been priced.
2. Trading – the selection is priced and can be offered for betting if the market status is Open.
3. Suspended – the selection has been removed from being available.

What is the availability hierarchy?

Availability of pricing follows the following order: event > market > selection. Please note that selections can be suspended even for a market that is set to trade on an event level when, for instance, the odds of one of the selections has become 1.00 or N/O. That selection is then suspended and the cut-off point for that suspension is fully configurable by your trading team through settings that apply to that market. However, if a market is suspended or closed, and has active selections, then based on the availability hierarchy those selections cannot be offered to customers, as the market's status is always more important than the selection statuses within that market.

What is a result?

ResultSet Updategrams contain the information that will allow you to settle each market on a selection level. Type of the market will determine how many winning and losing selections there are as well as whether the market might be void altogether. A market can be updated to a Resulted status straight from having been in state Open and closure of the market beforehand is not mandatory.

What are selection resulting values?

1. None - no resulting information has been yet sent for the selection/market, but is expected to be sent the future when the event has concluded or when the resulting information has been made available.
2. Winner - the winning selection of the market.
3. Pushed - the selection in question was voided, meaning that the bets on it should be returned. As an example, if a player doesn't take part in a match but was priced up for the Goalscorer markets, their selection will be voided since they did not participate.
4. Loser - as the name applies, all bets placed on this selection have lost.
5. Placed - a winning selection in a multiple winner market. An example would be the Prematch Golf's 'Place Top 10' and other similar markets. Every losing selection is a Loser, however all golfers that were in the Top 10 for the event in question, are resulted as Placed. Depending on the sport and market, there can be more than the expected amount of selections sent through as Placed since several players can Place for the same position.
6. Partial – this type of resulting covers markets such as Asian Handicap and includes additional resulting data to properly result such markets for which the straight outcome win/lose does not apply and percentages come into play instead.

The element <AdditionalResultData> is used convey the data for markets where Placed and Partial resulting values is used.

1. The Place - field will contain the number of selections designated by the market type, e.g. Top 10 usually contains 10 selections. It is of course possible to go over that limit if players tie and you should then apply the dead heat rule on your side for pay-out management.
2. The CountInPlace - field will inform you if there is more than one person on a specific spot. If two people came in as number 3, therefore sharing the podium, then the Place element will be 3 for both (since both players finished on the third place) and the CountInPlace element will be 2 (informing that two players share the spot).
3. For Partial results, the following percentages can apply and a bet can be resulted with lesser combined percentage than 100%, if one half of the bet wins and the other half loses.
   1. If both bets win, the PercentageWin will be 100%
   2. If both bets lose, the market is resulted as lost outright
   3. If half of the bet is correct, then Win will be 50%.
   4. If half of the bet is voided, Void will be 50%

...