Click or drag to resize

ILiveOdds Interface

Live odds client interface.

Namespace: Sportradar.SDK.FeedProviders.LiveOdds.LiveOdds
Assembly: LiveOddsFeedProvider (in LiveOddsFeedProvider.dll) Version: 2.28.0.0
Syntax
C#
public interface ILiveOdds : ILiveOddsCommon, 
	ILiveOddsCommonBase, ILiveFeeds, IStartable

The ILiveOdds type exposes the following members.

Properties
 NameDescription
Public propertyAvailableTranslations Language codes of the currently available translations.
(Inherited from ILiveFeeds)
Public propertyIsConnectionStable Is the current connection stable enough to accept bets safely?
(Inherited from ILiveOddsCommonBase)
Public propertyLastAliveMessage Get time when the last alive message from the server was received.
(Inherited from ILiveFeeds)
Public propertyLastServerMessage Get time when the last message from the server was received. This includes alive messages that are periodically sent.
(Inherited from ILiveFeeds)
Public propertyServerTime Get approximate server time.
(Inherited from ILiveFeeds)
Public propertySubscribedEvents All event ids we are currently subscribed to.
(Inherited from ILiveFeeds)
Public propertyTestManager Manages replay on test server. Only available if Test=true and the feed support replay.
Top
Methods
 NameDescription
Public methodBookEvents Book the specified events. Booked events cannot be cancelled through this interface.
(Inherited from ILiveFeeds)
Public methodClearState

Clears complete state for this provider, that can otherwise be used in case of feed error recovery which can occur after every feed server reconnect or at initial SDK startup.


(Inherited from ILiveFeeds)
Public methodGetAllBetTypes Returns all available bet types.
Public methodGetBetType Returns detailed bet type information for the specified type.
Public methodGetEventList(IEnumerableInt64) Request meta-information about the events(matches, races) specified by it's ids The response message includes teams playing, match date and time, TV channel names and sport/category/tournament for every match.
(Inherited from ILiveOddsCommonBase)
Public methodGetEventList(NullableDateTime, NullableDateTime, Boolean) Request meta-information about all events(matches, races, outcomes, ...) in a given interval. The maximum interval is 10 days. If no date is specified, all events started 24 hours in the past, and 7 days in the future are returned. The response message includes teams playing, event date and time, TV channel names and sport/category/tournament for every event.
(Inherited from ILiveOddsCommonBase)
Public methodGetEventMessages Request exact match messages ("error" server request).
(Inherited from ILiveOddsCommonBase)
Public methodGetEventsStatus Requests the match statuses for a given time ("current" server request). This includes odds, activation of odds and match status for the matches requested, current bet status and all bet clearing messages before the timestamp.
(Inherited from ILiveOddsCommonBase)
Public methodGetEventStatus Requests the match status for a given time ("current" server request). This includes odds, activation of odds and match status for the match requested, current bet status and all bet clearing messages before the timestamp.
(Inherited from ILiveOddsCommonBase)
Public methodGetScoreAndCardSummary Requests a list of all cards and scores for a match.
Public methodRegisterBetTypes Register specific bet types within the given match. This gives the opportunity to activate specific odd types for a match.
Public methodStart Start component.
(Inherited from IStartable)
Public methodStop Stop / shutdown component.
(Inherited from IStartable)
Public methodSubscribe Subscribe to specified events.
(Inherited from ILiveFeeds)
Public methodUnregisterBetTypes Unregister from specific bet types within the given match. This gives the opportunity to deactivate specific odd types for a match.
Public methodUnsubscribe Unsubscribe from the specified events. After this no more events associated with these event ids will be sent.
(Inherited from ILiveFeeds)
Top
Events
 NameDescription
Public eventOnAlive Alive message is transmitted every 10 seconds and contains status, timestamp in UTC and match header info for the matches that we supply LiveOdds for at the time given. It also contains current bet status information for every match (started or stopped). Score indicates the current score in the match.
(Inherited from ILiveOddsCommon)
Public eventOnBetCancel Signals that odds type for a match should be cancelled due to some reason. All bets accepted on the odds with that Id should be cancelled and cashed out with an odd of 1,0 (stakes returned). If the starttime and endtime are also specified, then only bets accepted in this interval should be cancelled. The starttime and endtime are timestamps in UTC.
(Inherited from ILiveOddsCommonBase)
Public eventOnBetCancelUndo Signals that an odds type has been cancelled due to some reason when it actually shouldnt have been. This can be undone. The Odds element should match the Odds element in the corresponding OnCancelBet event. The same goes for the starttime and endtime - they should match the values in the OnCancelBet event.
(Inherited from ILiveOddsCommonBase)
Public eventOnBetClear

Signals that situation occurred during the match so that a bet can be decided. Timestamp - time indicates the time at which the bet clear event happened. The event also contains the cleared score with an Odds element indicating the odds type, and this again with each EventOddsField, and the status of the outcomes (true/false).

Id in the Odds element corresponds to the Odds elements in one of the previous OnOddsChange events. Evaluation of the bet outcomes is the responsibility of the client system.


(Inherited from ILiveOddsCommonBase)
Public eventOnBetClearRollback Signals that there was some wrong information sent out about bet clearing. Notification includes the Odds element that rollback is targeted to. The clearedscore contains the cleared score of the original bet clearing. The time for the original bet clearing is timestamp – time seconds. The Odds element includes a list of EventOddsField elements to indicate what field was cleared in the original bet clearing. The Client system is responsible to handle this accordingly.
(Inherited from ILiveOddsCommonBase)
Public eventOnBetStart Signals that bets for a specific match can open again after they have been stopped.
(Inherited from ILiveOddsCommonBase)
Public eventOnBetStop Signals that a bet stop situation occurred for a specific match. OnBetStart event is triggered when the bets can open again.
(Inherited from ILiveOddsCommonBase)
Public eventOnConnectionStable Signals that the initial sync is complete and the connection to the server is stable.
(Inherited from ILiveOddsCommonBase)
Public eventOnConnectionUnstable Signals that the connection is unstable.
(Inherited from ILiveOddsCommonBase)
Public eventOnEventMessages Signals that all of the requested match messages were received.
(Inherited from ILiveOddsCommonBase)
Public eventOnEventStatus Signals that a requested match status was received.
(Inherited from ILiveOddsCommonBase)
Public eventOnFeedError Signals that a feed error has occurred (e.g. we got disconnected from the feed server, XML message parsing error occurred).
(Inherited from ILiveFeeds)
Public eventOnMetaInfo Event contains information like the date and time of the match, sport, category, tournament, teams and what TV-channels a match is broadcasted on. When a match is removed, Active is set to false for the match with an optional textual reason why the match has been removed. Active flag can also set to false if the client has unregistered a match. The message element will include the text unregistered in such cases. Match meta-information will also be broadcasted when a match is added to the system, or when a match has been cancelled.
(Inherited from ILiveOddsCommonBase)
Public eventOnOddsChange Signals that an odds change has occurred, specifying all odds types for a particular match. Odds types that are active will contain odds fields, while inactive odds types will not. Each odds type also has a Changed flag indicating whether this odds type has been changed or not. Score indicates the current score in the match.
(Inherited from ILiveOddsCommonBase)
Public eventOnScoreCardSummary

This event can be used for two types of information - live reporting of results/cards and final results (fulltime/halftime). Event is triggered as soon as a score/card is detected during a match and includes the timestamp of the actual event. The Id uniquely identifies each score and card. In addition, the scoring team and the player causing the event are both specified.

The same card and the same score can be sent several times; this is used to update information, for example player or time. When no time is known it is set to “-1", and the player attribute is empty. Cancelled indicates whether the score or card is cancelled or not. If cancelled then a new message with the correct score will be sent for score cancelling.

There is also live score information available during a match. After the match is ended, results with time=T, and type: halftime(ht), fulltime(ft), after overtime(ao), after penalties(pen) or score(when the goal happened) are indicated. T is the match time in minutes when the goal occurred. Here all cards registered during the match are sent. For the score types ht, ft, ot and pen there is no Id attribute. Score indicates the current score in the match. Evaluation of the bet outcomes is the responsibility of the Client system.

Top
Remarks
Usually there is no need to call any methods, just handle the events.
See Also