Entities

1. When a value in a specific language is requested, a "null" value is returned

• Check whether the HTTP request associated with the entity on which the request was made, failed (review the REST traffic log)

• Is the specified language part of the "desired languages" / "supported languages"?

• Was the language passed to the method used to retrieve the entity higher in the hierarchy tree? e.g. requesting a language for the outcome name from the market that was requested for a different language will return a null outcome name.

• There are cases where the requested entity does not exist on the server. e.g. requesting a tournament schedule for the tournament which currently does not have an associated schedule.

2. When retrieving a property on an entity constructed from data return from the Sports API a null is returned

Some entities (sport hierarchy (sports, categories, tournaments, sport events), market names, outcome names, ....) are constructed from data obtained via an HTTP request (one of the endpoints found on iodocs). A null value will be returned to the associated method call if the request fails. For failed HTTP requests review the REST traffic log. (See: SDK - Error Handling)

3. A SportEvent entity passed to SDK callbacks/events does not contain a method to retrieve information which should be there

A SportEvent entity is a "base" for more specific entities (match, race, tournament, ...). If the SportEvent entity does not contain the required method, the SportEvent entity must be "type-casted" to a more specific type. For more details on the sport event derived types see the diagram in the (See: Java SDK - SportEvent and .Net SDK - SportEvent)

4. How to access the EventTimeline in the context of oddsChange?

The following is the code snippet (java and .net respectively) that can help log the EventTimeline information.

Java

if(oddsChange.getEvent() instanceof Match){
        Match match = (Match) oddsChange.getEvent();
        EventTimeline eventTimeline = match.getEventTimeline(Locale.ENGLISH);
        if (match.getEventTimelineIfPresent(Locale.ENGLISH).isPresent()) {
            logger.info("scoreHistory: ");
            for (TimelineEvent timelineEvent : eventTimeline.getTimelineEvents()) {
                logger.info("scoreHistory Entry (id): " + timelineEvent.getId());
                logger.info("scoreHistory Entry (sequenceNo): --------");
                logger.info("scoreHistory Entry (matchTime): " + timelineEvent.getMatchClock());
                logger.info("scoreHistory Entry (player): " + timelineEvent.getPlayer().getName(Locale.ENGLISH));
                logger.info("scoreHistory Entry (scoringTeam): " + timelineEvent.getTeam());
                logger.info("scoreHistory Entry (Score Home): " + timelineEvent.getHomeScore());
                logger.info("scoreHistory Entry (Score Away): " + timelineEvent.getAwayScore());
                logger.info("scoreHistory Entry (canceled): " + timelineEvent.getMatchStatusCode());
            }
        }
    }

.Net

if (oddsChange.GetOddsChange().Event is IMatch match){
    var eventTimeline = match.GetEventTimelineAsync().GetAwaiter().GetResult();
    if (eventTimeline != null)
    {
        _log.LogInformation("scoreHistory: ");
        foreach (var timelineEvent in eventTimeline.TimelineEvents)
        {
            _log.LogInformation("scoreHistory Entry (id): " + timelineEvent.Id);
            _log.LogInformation("scoreHistory Entry (sequenceNo): --------");
            _log.LogInformation("scoreHistory Entry (matchTime): " + timelineEvent.MatchClock);
            _log.LogInformation("scoreHistory Entry (player): " + timelineEvent.Player.GetName(_defaultCulture));
            _log.LogInformation("scoreHistory Entry (scoringTeam): " + timelineEvent.Team);
            _log.LogInformation("scoreHistory Entry (Score Home): " + timelineEvent.HomeScore);
            _log.LogInformation("scoreHistory Entry (Score Away): " + timelineEvent.AwayScore);
            _log.LogInformation("scoreHistory Entry (canceled): " + timelineEvent.MatchStatusCode);
        }
    }
}

5. How to get Soccer Statistics from SoccerEvent in context of oddsChange?

You should add the following code snippet to your EventListener implementation.

Java

if(oddsChange.getEvent() instanceof SoccerEvent){
            SoccerEvent soccerEvent1 = (SoccerEvent) oddsChange.getEvent();
            SoccerStatus soccerStatus = soccerEvent1.getStatus();
            SoccerStatistics soccerStatusStatistics = soccerStatus.getStatistics();
            List<PeriodStatistics> periodStatistics = soccerStatusStatistics.getPeriodStatistics ();
            List<TeamStatistics> totalStatistics = soccerStatusStatistics.getTotalStatistics();
}

.Net

if (oddsChange.GetOddsChange().Event is ISoccerEvent soccerEvent){
    var soccerStatus = soccerEvent.GetStatusAsync().GetAwaiter().GetResult();
    var soccerStatusStatistics = soccerStatus.Statistics;
    var periodStatistics = soccerStatusStatistics.PeriodStatistics;
    var totalStatistics = soccerStatusStatistics.TotalStatistics;
}

6. How to access the fixtureChange API endpoint via the SDK and get fixtureChanges?

Inorder to access and get fixtureChanges, use the following

Java

SportsInfoManager sportsInfoManager = oddsFeed.getSportsInfoManager();
 
List<FixtureChange> fixtureChanges = sportsInfoManager.getFixtureChanges();
for (FixtureChange fixtureChange : fixtureChanges){
 
    Urn sportEventId = fixtureChange.getSportEventId();
    Date updateTime = fixtureChange.getUpdateTime();
    Competition competition = sportsInfoManager.getCompetition(sportEventId);
 
    if(competition instanceof Match){
        Match match = (Match) competition;
 
        Fixture fixture = match.getFixture();
        MatchStatus status = match.getStatus();
 
    }
}

.Net

var sportDataProvider = uofSdk.SportDataProvider;
 
var fixtureChanges = sportDataProvider.GetFixtureChangesAsync().GetAwaiter().GetResult();
foreach (IFixtureChange fixtureChange in fixtureChanges)
{
    var sportEventId = fixtureChange.SportEventId;
    var updateTime = fixtureChange.UpdateTime;
    var competition = sportDataProvider.GetCompetition(sportEventId);
 
    if (competition is IMatch match){
        var fixture = match.GetFixtureAsync().GetAwaiter().GetResult();
        var status = match.GetStatusAsync().GetAwaiter().GetResult();
    }
}

7. How to get an event score via feed message (e.g. odds_change)?

The following depicts the code snippet to get the event score via odds_change messages. You can use this as a base to write code to get the same via other feed messages.

Java

if(oddsChanges.getEvent() instanceof Match) {
    Match match = (Match)oddsChanges.getEvent();
    MatchStatus matchStatus = match.getStatus();
    BigDecimal awayScore = matchStatus.getAwayScore();
    BigDecimal homeScore = matchStatus.getHomeScore();
    List<PeriodScore> periodScores = matchStatus.getPeriodScores();
}

.Net

var baseEntity = oddsChangeEventArgs.GetOddsChange();
var sportEvent = baseEntity.Event;
IMatch match = null;
  
if(sportEvent is IMatch)
{
    match = sportEvent as IMatch;
    var matchStatus = match.GetStatusAsync().Result;
    var awayScore = matchStatus.AwayScore;
    var homeScore = matchStatus.HomeScore;
    var periodScores = matchStatus.PeriodScores;
}

8. How to get match status?

Java

LocalizedNamedValue matchStatus = match.getStatus().getMatchStatus();

.Net

var matchEventStatus = match.GetStatusAsync().GetAwaiter().GetResult();
var matchStatus = matchEventStatus.GetMatchStatusAsync(configuration.DefaultLanguage).GetAwaiter().GetResult();

9. How to get current_server?

Most common properties recieved in the sport event status are directly exposed on the status object via a dedicated method. All others can be obtained through properties list. You can refer this - Java / .Net

Java

match.getStatus().getPropertyValue("CurrentServer")

.Net

var matchEventStatus = match.GetStatusAsync().GetAwaiter().GetResult();
var currentServer = matchEventStatus.GetPropertyValue("CurrentServer");

10. How to check if a match is Pre-match only or Live?

To check if a match is pre-match only or live, you'll need to consider the bookingStatus availability

Java

BookingStatus bookingStatus = match.getBookingStatus();
if(bookingStatus.equals(BookingStatus.Unavailable)) {
    // this match is pre-match only (at least for now)
}
else {
    // this match will be covered by live
}

.Net

var book = match.GetBookingStatusAsync().GetAwaiter().GetResult();
if(book.Equals(BookingStatus.Unavailable))
{
    // this match is pre-match only (at least for now)
}
else
{
    // this match will be covered in live
}

11. How do I book live events for the following hour?

Java

SportDataProvider sportDataProvider = uofSdk.getSportsDataProvider();
BookingManager bookingManager = uofSdk.getBookingManager();
 
Date today = new Date();
List<Competition> competitionsToday = sportDataProvider.getCompetitionsFor(today);
for (Competition competition : competitionsToday) {
    Date scheduledTime = competition.getScheduledTime();
    Instant scheduledTimeInstant = scheduledTime.toInstant();
 
    // if difference is negative, the event is scheduled before now
    long hoursDifference = Duration.between(Instant.now(), scheduledTimeInstant).toHours();
 
    if(hoursDifference <= 1 && hoursDifference > -1) {
        boolean booked = bookingManager.bookLiveOddsEvent(competition.getId());
        if(booked) {
            logger.info(competition.getId().toString() + "Scheduled at: " + scheduledTime.toString());
        }
    }
}

.Net

var sportDataProvider = uofSdk.SportDataProvider;
var bookingManager = uofSdk.BookingManager;
 
var today = DateTime.Now;
var competitionsToday = sportDataProvider.GetSportEventsByDateAsync(today).GetAwaiter().GetResult();
foreach (ICompetition competition in competitionsToday)
{
    var scheduledTime = competition.GetScheduledTimeAsync().GetAwaiter().GetResult();
                 
    if (scheduledTime > DateTime.Now.AddHours(-1))
    {
        var booked = bookingManager.BookLiveOddsEvent(competition.Id);
        if (booked)
        {
            _log.LogInformation(competition.Id + "Scheduled at: " + scheduledTime.ToString(CultureInfo.InvariantCulture));
        }
    }
}

12. How to get referenceIDs for events and competitors (e.g. AAMS id)?

Java

SportDataProvider sportDataProvider = uofSdk.SportDataProvider();
 
Competition comp = sportDataProvider.getCompetition(Urn.parse("sr:match:15160287"));
if(comp instanceof Match) {
    Match match = (Match) comp;
    Fixture fixture = match.getFixture();
    Reference fixtureReferences = fixture.getReferences();
    Integer fixtureAamsId = fixtureReferences.getAamsId();
 
    TeamCompetitor homeCompetitor = match.getHomeCompetitor();
    Reference homeCompetitorReferences = homeCompetitor.getReferences();
    Integer homeCompetitorsAamsId = homeCompetitorReferences.getAamsId();
}

.Net

var sportDataProvider = uofSdk.SportDataProvider;
 
var sportEvent = sportDataProvider.GetCompetition(Urn.Parse("sr:match:15160287"), Urn.Parse("sr:match:1"));
if(sportEvent is IMatch)
{
    var match = sportEvent as IMatch;
    var fixture = match.GetFixtureAsync().GetAwaiter().GetResult();
    var matchReferences = (IReference)fixture.References;
    var matchAamsId = matchReferences.AamsId;
  
    var homeCompetitor = match.GetHomeCompetitorAsync().GetAwaiter().GetResult();
    var competitorReferences = (IReference)homeCompetitor.References;
    var homeCompetitorAamsId = competitorReferences.AamsId;
  
}