A wrapper server connects to the sports feed and proxies the data using TCP sockets and json messages. Clients can connect to this proxy to consume the feed.

The feed stream consists of a series of insert, update and delete messages. Clients can apply these messages sequentially to obtain a current snapshot of the feed. This API documents the various messages that are sent between the wrapper server and a client. Messages are transmitted in Json string unless stated otherwise.

Insert Match

Inserts one or more new matches into the snapshot

Message Attributes

Example

The following message inserts a single soccer match.

{
  "type": "MATCH_INSERT",
  "match": [
    {
      "sportType": "SOCCER",
      "id": "60256d4996201811",
      "league": "English National League North",
      "host": "Gainsborough Trinity",
      "guest": "Brackley Town",
      "startTime": 1520970300
    }
  ]
}

Update Match

Updates one or more existing matches in the snapshot

Message Attributes

Delete Match

Removes one or more existing matches from the snapshot

Message Attributes

Insert Event

Inserts one or more new events into the snapshot

Message Attributes

Update Event

Updates one or more existing events in the snapshot

Message Attributes

Example

The following message updates a single event. The event is a main betting event with live odd records.

This event also contains state from 2 separate sportbook sources. Note how the different sportbooks can publish different states.

{
  "type": "EVENT_UPDATE",
  "event": [
    {
      "eventType": "NONE",
      "id": "60256d4996201811",
      "matchId": "60256d4996201811",
      "eventStates": [
        {
          "source": "SBO",
          "duration": 31,
          "hostScore": 1,
          "guestScore": 0,
          "hostCard": 0,
          "guestCard": 0,
          "segment": "LIVE"
        },
        {
          "source": "CROWN",
          "duration": 30,
          "hostScore": 1,
          "guestScore": 0,
          "hostCard": 0,
          "guestCard": 0,
          "segment": "LIVE"
        }
      ]
    }
  ]
}

Delete Event

Removes one or more existing events from the snapshot

Message Attributes

Insert Odd

Inserts one or more new odd records into the snapshot

Message Attributes

Example

The following message inserts a single odd record. This odd is offered by Crown.

{
  "type": "ODD_INSERT",
  "record": [
    {
      "source": "CROWN",
      "matchId": "60256d4996201811",
      "eventId": "60256d4996201811",
      "id": 33554570,
      "oddType": "EARLY",
      "oddFormat": "HK",
      "lbType": "BACK",
      "timeType": "HT",
      "pivotValue": 0,
      "pivotBias": "NEUTRAL",
      "pivotType": "ONE_TWO",
      "isSwapped": false,
      "rateOver": 4.5,
      "rateUnder": 2.32,
      "rateEqual": 2.15
    }
  ]
}

Update Odd

Updates one or more existing odd records in the snapshot

Message Attributes

Delete Odd

Removes one or more existing odd records from the snapshot

Message Attributes

Reset

Removes all records that belong to the sport, source and odd type.

Special care must be taken when deleting odd records. source and oddType attributes can be compared against the odd record directly. In order to obtain sportType, the parent event and match containers must be referenced. Clients must traverse up the container event and match hierarchy and find the match which odd record belongs to. Upon finding the container, the sportType attribute can be compared against the match record.

Refresh

Indicator to show that the client is still connected to a particular partition. Client will receive the refresh message when the partition has no updates. A partition consist of source , oddType and sportType

Match

SoccerMatch

TennisMatch

BasketballMatch

Event

A single betting event is a grouping of odds that are related. For example, soccer odds that bet on the score are grouped under a single main event. Odds that bet on the number of corners are grouped into a separate event. Each event belongs to exactly one match.

Events come with an optional event state. An event state structure stores match related statistics. In a soccer match, this includes information such as the current number of goals or the total number of corners taken. The exact statistic published depends on the nature of the event type.

Different sportbooks may each publish a different state. The list of event states contains information from various sportbooks. Each record can be distinguished by their source attribute.

SoccerEvent

SoccerEventState

TennisEvent

TennisEventState

TennisStats

Note that: X is either 1 or 2

BasketballEvent

BasketballEventState

BasketballStats

Note that: X is either 1 or 2

Odd

TimeType

SoccerTimeType

A string of either FT or HT

TennisTimeType

BasketballTimeType

A string of any FT, H1, H2, Q1, Q2, Q3 or Q4

PartitionKey