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.
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.
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.
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?