ProviderMarkets

ProviderMarkets object enhances data granularity by delivering provider-specific odds directly within market messages. This is relevant for Provider Odds or Hybrid clients only.

ProviderMarket

The ProviderMarket object is included in all market and settlement messages for packages of type Provider Odds. These messages provide detailed information about provider-specific odds and include the following message types:

  • Market Update (ID: 3)

  • Settlement (ID: 35)

  • Outright League Market (ID: 40)

  • Outright Market (ID: 41)

  • Outright Settlement (ID: 42)

Bet Structure Consistency

The Bet structure is consistent across both Markets and ProviderMarkets, ensuring a uniform format for odds representation.

Mainline Availability Consistency

The mainline property on the Market object is not supported for Provider Odds packages.

Market Message (ID: 3)

Below is an example of a Market Update message (ID: 3) with all available sections, including both Markets and ProviderMarkets:

{
  "Header": {
    "Type": 3,
    "MsgSeq": 136,
    "MsgGuid": "98d3bdb5-95d4-44fe-ba2b-d2a3b21f0661",
    "CreationDate": "2025-03-18T22:11:12.116Z",
    "ServerTimestamp": 1742335872116
  },
  "Body": {
    "Events": [
      {
        "FixtureId": 15139509,
        "Livescore": null,
        "Markets": [
          {
            "Id": 3,
            "Name": "Asian Handicap",
            "ProviderMarkets": [
              {
                "Id": 8,
                "Name": "Bet365",
                "LastUpdate": "2025-03-18T22:11:11.733Z",
                "Bets": [
                  {
                    "Id": 47610186115139510,
                    "Name": "1",
                    "Line": "-0.75 (0-0)",
                    "BaseLine": "-0.75 (0-0)",
                    "Status": 2,
                    "StartPrice": "1.0",
                    "Price": "4.55",
                    "LastUpdate": "2025-03-18T21:56:35.932Z"
                  },
                  {
                    "Id": 72966680915139500,
                    "Name": "2",
                    "Line": "-0.5 (0-0)",
                    "BaseLine": "0.5 (0-0)",
                    "Status": 1,
                    "StartPrice": "1.0",
                    "Price": "6.4",
                    "LastUpdate": "2025-03-18T22:11:11.733Z"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Event Object

Field

Data Type

Description

FixtureId

string

The unique ID of the event fixture.

Markets

object

Contains market details for the event.

Market Object

Field

Data Type

Description

Id

int

Unique identifier for the market.

Name

string

Name of the market.

ProviderMarkets

array

(Optional) Contains an array of provider odds objects for the market. Available for "Provider Odds" and Hybrid.

ProviderMarkets Object

Field

Data Type

Description

Id

int

Unique identifier for the provider (e.g., 8 for Bet365).

Name

string

Name of the provider offering the odds (e.g., "Bet365").

LastUpdate

DateTime

Timestamp of the last update to the provider odds.

Bets

array

Contains an array of bet objects specific to the provider.

Bet Object

Field

Data Type

Description

Id

string

Unique identifier for the bet within a market and fixture.

Name

string

Name of the bet (e.g., "1", "2").

Status

enum

Current status of the bet (e.g., 1 = Active, 2 = Suspended).

StartPrice

double

Initial price (odds) for the bet. Default value is "1.0".

Price

double

Current price (odds) for the bet.

LastUpdate

DateTime

Timestamp of the last update to the bet.

Probability

double

Probability calculated for the bet. Value ranges between 0 and 1.

SuspensionReason

int

Indicates the reason the bet is suspended.

Settlement message (ID: 35)

{
  "Header": {
    "Type": 35,
    "MsgSeq": 1,
    "MsgGuid": "254d5a64-49e0-4473-b3c4-dca6f2313bd2",
    "CreationDate": "2025-03-18T22:28:45.598Z",
    "ServerTimestamp": 1742336925598
  },
  "Body": {
    "Events": [
      {
        "FixtureId": 15139509,
        "Livescore": null,
        "Markets": [
          {
            "Id": 3,
            "Name": "Asian Handicap",
            "ProviderMarkets": [
              {
                "Id": 8,
                "Name": "Bet365",
                "LastUpdate": "2025-03-18T22:24:35.124Z",
                "Bets": [
                  {
                    "Id": 47610186115139510,
                    "Name": "1",
                    "Line": "-0.75 (0-0)",
                    "BaseLine": "-0.75 (0-0)",
                    "Status": 3,
                    "StartPrice": "1.0",
                    "Price": "4.55",
                    "Settlement": 1,
                    "LastUpdate": "2025-03-18T22:28:45.223Z"
                  },
                  {
                    "Id": 107283749615139500,
                    "Name": "2",
                    "Line": "0.5 (0-0)",
                    "BaseLine": "-0.5 (0-0)",
                    "Status": 3,
                    "StartPrice": "1.0",
                    "Price": "1.1",
                    "Settlement": 2,
                    "LastUpdate": "2025-03-18T22:28:45.223Z"
                  },
                  {
                    "Id": 107294722115139500,
                    "Name": "2",
                    "Line": "0.0 (0-0)",
                    "BaseLine": "0.0 (0-0)",
                    "Status": 3,
                    "StartPrice": "1.0",
                    "Price": "2.375",
                    "Settlement": 3,
                    "LastUpdate": "2025-03-18T22:28:45.223Z"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Event Object

Field

Data Type

Description

FixtureId

string

The unique ID of the event fixture.

Markets

object

Contains market details for the event.

Market Object

Field

Data Type

Description

Id

int

Unique identifier for the market.

Name

string

Name of the market.

ProviderMarkets

array

(Optional) Contains an array of provider odds objects for the market. Available for "Provider Odds" and Hybrid.

ProviderMarkets Object

Field

Data Type

Description

Id

int

Unique identifier for the provider (e.g., 8 for Bet365).

Name

string

Name of the provider offering the odds (e.g., "Bet365").

LastUpdate

DateTime

Timestamp of the last update to the provider odds.

Bets

array

Contains an array of bet objects specific to the provider.

Bet Object

Field

Data Type

Description

Id

string

Unique identifier for the bet within a market and fixture.

Name

string

Name of the bet (e.g., "1", "2").

Status

enum

Current status of the bet (e.g., 1 = Active, 2 = Suspended).

StartPrice

double

Initial price (odds) for the bet. Default value is "1.0".

Price

double

Current price (odds) for the bet.

enum

Represents how the bet was settled (resulted)

LastUpdate

DateTime

Timestamp of the last update to the bet.

Probability

double

Probability calculated for the bet. Value ranges between 0 and 1.

SuspensionReason

int

Indicates the reason the bet is suspended.

OutrightLeague Market message (ID: 40)

{
  "Header": {
    "Type": 40,
    "MsgSeq": 5,
    "MsgGuid": "0f463084-3af4-4bce-980d-284a9e95731c",
    "CreationDate": "2025-03-13T07:53:54.557Z",
    "ServerTimestamp": 1741852434557
  },
  "Body": {
    "Competition": {
      "Id": 1145,
      "Name": "Premier League",
      "Type": 3,
      "Competitions": [
        {
          "Id": 0,
          "Name": null,
          "Type": 4,
          "Events": [
            {
              "FixtureId": 15127859,
              "Livescore": null,
              "Markets": [
                {
                  "Id": 274,
                  "Name": "Outright Winner",
                  "ProviderMarkets": [
                    {
                      "Id": 145,
                      "Name": "1XBet",
                      "LastUpdate": "2025-03-13T07:53:54.243Z",
                      "Bets": [
                        {
                          "Id": 60486908915127860,
                          "Name": "Glentoran",
                          "Status": 1,
                          "StartPrice": "1.0",
                          "Price": "100",
                          "LastUpdate": "2025-03-13T07:53:54.243Z"
                        },
                        {
                          "Id": 139114732215127860,
                          "Name": "Linfield",
                          "Status": 1,
                          "StartPrice": "1.0",
                          "Price": "1.001",
                          "LastUpdate": "2025-03-13T07:53:54.243Z"
                        },
                        {
                          "Id": 147588917115127870,
                          "Name": "Larne",
                          "Status": 1,
                          "StartPrice": "1.0",
                          "Price": "100",
                          "LastUpdate": "2025-03-13T07:53:54.243Z"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

Competition Object

Element

Data Type

Description

Id

int

The Id of the current competition

Name

string

The Name of the current competition

Type

int

The Type of the competition

Events

List of Events

Event Object

Field

Data Type

Description

FixtureId

string

The unique ID of the event fixture.

Markets

object

Contains market details for the event.

Market Object

Field

Data Type

Description

Id

int

Unique identifier for the market.

Name

string

Name of the market.

ProviderMarkets

array

(Optional) Contains an array of provider odds objects for the market. Available for "Provider Odds" and Hybrid.

ProviderMarkets Object

Field

Data Type

Description

Id

int

Unique identifier for the provider (e.g., 8 for Bet365).

Name

string

Name of the provider offering the odds (e.g., "Bet365").

LastUpdate

DateTime

Timestamp of the last update to the provider odds.

Bets

array

Contains an array of bet objects specific to the provider.

Bet Object

Field

Data Type

Description

Id

string

Unique identifier for the bet within a market and fixture.

Name

string

Name of the bet (e.g., "1", "2").

Status

enum

Current status of the bet (e.g., 1 = Active, 2 = Suspended).

StartPrice

double

Initial price (odds) for the bet. Default value is "1.0".

Price

double

Current price (odds) for the bet.

enum

Represents how the bet was settled (resulted)

LastUpdate

DateTime

Timestamp of the last update to the bet.

Probability

double

Probability calculated for the bet. Value ranges between 0 and 1.

SuspensionReason

int

Indicates the reason the bet is suspended.

Outright Market message (ID: 41)

{
   "Message":{
      "Header":{
         "Type":"41",
         "MsgGuid":"01017c9c-beb3-47d0-9f8e-110c22dab96e",
         "ServerTimestamp":"1575369435847"
      },
      "Body":{
         "Competition":{
            "Events":{
               "Event":{
                  "Markets":{
                     "Market":{
                        "Bets":{
                           "Bet":[
                              {
                                 "Id":"1526487835001151",
                                 "Name":"Boston   United",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"35.0",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"14921"
                              },
                              {
                                 "Id":"9855082825001151",
                                 "Name":"Gateshead Fc",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"58.0",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"173955"
                              },
                              {
                                 "Id":"3086359045001151",
                                 "Name":"Brackley Town",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"18.0",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"191097"
                              },
                              {
                                 "Id":"59317895001151",
                                 "Name":"Hereford United",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"131.0",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"85214"
                              },
                              {
                                 "Id":"9146688705001151",
                                 "Name":"Chester Fc",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"6.9",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"15468"
                              },
                              {
                                 "Id":"20421503435001151",
                                 "Name":"Darlington  1883",
                                 "Status":"2",
                                 "StartPrice":"1.0",
                                 "Price":"217.0",
                                 "ProviderBetId":"8",
                                 "LastUpdate":"2019-12-02T09:00:00.913Z",
                                 "ParticipantId":"1026"
                              }
                           ]
                        },
                        "ProviderMarkets":[
                           {
                              "Id":8,
                              "Name":"Bet365",
                              "LastUpdate":"2024-06-30T10:07:21.886Z",
                              "Bets":[
                                 {
                                    "Name":"Boston   United",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"35.0",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"14921"
                                 },
                                 {
                                    "Name":"Gateshead Fc",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"58.0",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"173955"
                                 },
                                 {
                                    "Name":"Brackley Town",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"18.0",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"191097"
                                 },
                                 {
                                    "Name":"Hereford United",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"131.0",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"85214"
                                 },
                                 {
                                    "Name":"Chester Fc",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"6.9",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"15468"
                                 },
                                 {
                                    "Name":"Darlington  1883",
                                    "Status":"2",
                                    "StartPrice":"1.0",
                                    "Price":"217.0",
                                    "LastUpdate":"2019-12-02T09:00:00.913Z",
                                    "ParticipantId":"1026"
                                 }
                              ]
                           }
                        ],
                        "Id":"160",
                        "Name":"Race Winner"
                     }
                  },
                  "FixtureId":"5001151"
               }
            },
            "Id":"3310",
            "Name":"Wolverhampton",
            "Type":"1"
         }
      }
   }
}

Competition Object

Element

Data Type

Description

Id

int

The Id of the current competition

Name

string

The Name of the current competition

Type

int

The Type of the competition

Events

List of Events

Event Object

Field

Data Type

Description

FixtureId

string

The unique ID of the event fixture.

Markets

object

Contains market details for the event.

Market Object

Field

Data Type

Description

Id

int

Unique identifier for the market.

Name

string

Name of the market.

Bets

array

Contains an array of bet objects with calculated odds. Avaliable for "Calculated Odds" and Hybrid.

ProviderMarkets

array

(Optional) Contains an array of provider odds objects for the market. Available for "Provider Odds" and Hybrid.

Bet Object

Field

Data Type

Description

Id

string

Unique identifier for the bet within a market and fixture.

Name

string

Name of the bet (e.g., "1", "2").

Status

enum

Current status of the bet (e.g., 1 = Active, 2 = Suspended).

StartPrice

double

Initial price (odds) for the bet. Default value is "1.0".

Price

double

Current price (odds) for the bet.

enum

Represents how the bet was settled (resulted)

ProviderBetId

string

Identifier for the bet as provided by the provider.

LastUpdate

DateTime

Timestamp of the last update to the bet.

Probability

double

Probability calculated for the bet. Value ranges between 0 and 1.

SuspensionReason

int

Indicates the reason the bet is suspended.

ProviderMarkets Object

Field

Data Type

Description

Id

int

Unique identifier for the provider (e.g., 8 for Bet365).

Name

string

Name of the provider offering the odds (e.g., "Bet365").

LastUpdate

DateTime

Timestamp of the last update to the provider odds.

Bets

array

Contains an array of bet objects specific to the provider.

Last updated

Was this helpful?