Fixture
This documentation describes the complete structure of a Fixture Update message (Type 1) as delivered by TRADE.
{
"Header": {
"Type": 1,
"MsgSeq": 2,
"MsgGuid": "ea1da91b-fd6b-45ba-a2b2-14e3d771a070",
"CreationDate": "2024-04-01T18:15:27.3452921Z",
"ServerTimestamp": 1711995327345
},
"Body": {
"Events": [
{
"FixtureId": 16861271,
"Fixture": {
"Subscription": {
"Type": 1,
"Status": 1
},
"Sport": {
"Id": 6046,
"Name": "Football"
},
"Location": {
"Id": 248,
"Name": "England"
},
"League": {
"Id": 36,
"Name": "Premier League",
"Tour": {
"Id": 100,
"Name": "Matchday 15"
},
"AgeCategory": 1,
"Gender": 1,
"Type": 1,
"NumberOfPeriods": 2,
"SportCategory": {
"Id": 1,
"Name": "Men's Football"
}
},
"StartDate": "2025-06-15T18:30:00Z",
"LastUpdate": "2025-06-15T17:00:00Z",
"Status": 2,
"Participants": [
{
"Id": 1001,
"Name": "Manchester United",
"Position": "1",
"RotationId": 1,
"Form": "WWDLW",
"Formation": "4-3-3",
"FixturePlayers": [
{
"PlayerId": 50001,
"ShirtNumber": "1",
"IsCaptain": true,
"IsStartingLineup": true,
"Position": {
"Id": 1,
"Name": "Goalkeeper"
},
"State": {
"Id": 1,
"Name": "Active"
},
"Player": {
"Id": 50001,
"Name": "David de Gea",
"TeamId": 1001,
"NationalityId": 34,
"BirthDate": "1990-11-07T00:00:00",
"Type": 1,
"NationalityTeamId": 34
}
},
{
"PlayerId": 50002,
"ShirtNumber": "7",
"IsCaptain": false,
"IsStartingLineup": true,
"Position": {
"Id": 4,
"Name": "Forward"
},
"State": {
"Id": 1,
"Name": "Active"
},
"Player": {
"Id": 50002,
"Name": "Marcus Rashford",
"TeamId": 1001,
"NationalityId": 44,
"BirthDate": "1997-10-31T00:00:00",
"Type": 1,
"NationalityTeamId": 44
}
}
],
"Gender": 1,
"AgeCategory": 1,
"Type": 1
},
{
"Id": 1002,
"Name": "Liverpool FC",
"Position": "2",
"RotationId": 2,
"Form": "WLWWW",
"Formation": "4-2-3-1",
"FixturePlayers": [
{
"PlayerId": 60001,
"ShirtNumber": "1",
"IsCaptain": false,
"IsStartingLineup": true,
"Position": {
"Id": 1,
"Name": "Goalkeeper"
},
"State": {
"Id": 1,
"Name": "Active"
},
"Player": {
"Id": 60001,
"Name": "Alisson Becker",
"TeamId": 1002,
"NationalityId": 55,
"BirthDate": "1992-10-02T00:00:00",
"Type": 1,
"NationalityTeamId": 55
}
}
],
"Gender": 1,
"AgeCategory": 1,
"Type": 1
}
],
"FixtureExtraData": [
{
"Name": "Attendance",
"Value": "85000"
},
{
"Name": "Referee",
"Value": "Michael Oliver"
},
{
"Name": "Weather",
"Value": "Sunny"
},
{
"Name": "NumberOfPeriods",
"Value": "2"
},
{
"Name": "TourId",
"Value": "100"
},
{
"Name": "TourName",
"Value": "Matchday 15"
}
],
"ExternalFixtureId": "PROVIDER_FIX_001",
"Venue": {
"Id": 100,
"Name": "Wembley Stadium",
"Capacity": 90000,
"Attendance": 85234,
"CourtSurfaceType": 0,
"Environment": 1,
"Assignment": 0,
"State": {
"Id": 10,
"Name": "Greater London"
},
"City": {
"Id": 1,
"Name": "London"
}
},
"Season": {
"Id": 2025,
"Name": "2024/2025"
},
"FixtureName": "Team A vs Team B"
}
}
]
}
}Model
Events
Fixture
Element
Data Type
Description
StartDate
string
The fixture start date
LastUpdate
string
ISO timestamp of the last update to the provider odds
ExternalFixtureId
string
Use to map fixtures to an external provider; to enable this feature, please contact your CSM.
FixtureName
string
fixture name (e.g. Team A vs Team B).
Subscription
Element
Data Type
Description
Type
enum
Your package type
Status
enum
The current subscription status of the event in your package
Sport
Element
Data Type
Description
Id
int
The unique ID of the sport
Name
string
The name of the sport
Location
Element
Data Type
Description
Id
int
The unique ID of the location
Name
string
The name of the location
League
Element
Data Type
Description
Id
int
The unique ID of the league
Name
string
The name of the league
Tour
object
The tour associated with the league.
AgeCategory
int
Values:
0 = Regular
1 = Youth
2 = Reserves
Gender
int
Values:
1 = Men
2 = Women
3 = Mix
Type
int
Values:
1 = Club
2 = National
3 = Individual
4 = Virtual
5 = Esports
6 = VirtuReal
7 = Doubles
NumberOfPeriods
int
Number of periods in the competition.
SportCategory
object
The sport category associated with the league.
Tour
Element
Data Type
Description
Id
int
The unique ID of the tour
Name
string
The name of the tour
Sport Category
Element
Data Type
Description
Id
int
The unique ID of the sport category.
Name
string
The name of the sport category.
Participants
Element
Data Type
Description
Id
int
The unique ID of the participant
Name
string
The unique ID of the participant
Position
string
In 2-participant events the positions will be 1 (home) or 2 (away)
IsActive
bool
Will only show in outright events.
Form
string
Recent form of the participant (e.g. WWDLW).
Formation
string
Tactical formation used by the participant (e.g. 4-3-3).
FixturePlayers
array
Lineup / roster information for the participant.
FixturePlayers
Element
Data Type
Description
PlayerId
int
Unique player identifier.
ShirtNumber
string
Player shirt number.
IsCaptain
bool
Indicates if the player is team captain.
IsStartingLineup
bool
Indicates if the player is in the starting lineup.
Position
object
Player position metadata.
State
object
Player state (e.g. Active, Injured).
Player
object
Full player profile information.
Player Position
Element
Data Type
Description
Id
int
The unique ID of the position
Name
string
The name of the position
Player State
Element
Data Type
Description
Id
int
The unique ID of the state
Name
string
The name of the state
Player
Element
Data Type
Description
Id
int
The unique ID of the player
Name
string
The name of the player
TeamId
int
Associated team identifier.
NationalityId
int
Player nationality ID.
BirthDate
string
Player date of birth (ISO format).
Type
int
Player type.
NationalityTeamId
int
National team identifier.
ExtraData
Element
Data Type
Description
Value
string
Representing the extra data value
Name
string
The name of extra data field
FixtureExtraData
Element
Data Type
Description
Value
string
Representing the extra data value
Name
string
The name of extra data field
Venue
Element
Data Type
Description
Id
string
The unique identifier of the venue where the fixture is held
Name
string
The official name of the venue where the fixture is held
Capacity
int
The maximum number of spectators that the venue can accommodate.
Attendance
int
The number of spectators present at the fixture.
CourtSurfaceType
string
The surface type for sports like tennis. Example: Grass, Clay, Hardcourt
Environment
string
Indicates if the venue is indoors or outdoors.
Assignment
string
Specifies whether the venue is assigned as Home, Away, or Neutral
State
object
Contains the state or region details if applicable.
City
object
Contains the city details where the venue is located.
Country
Element
Data Type
Description
ID
int
Country unique identifier.
Name
string
Country name.
State
Element
Data Type
Description
ID
int
State unique identifier.
Name
string
State name.
City
Element
Data Type
Description
ID
int
City unique identifier.
Name
string
City name.
Stage
Element
Data Type
Description
ID
int
Unique identifier representing the competition stage.
Name
string
The name of the competition phase.
Round
Element
Data Type
Description
ID
int
Unique identifier representing the round within a competition.
Name
string
The official name of the round.
Season
Element
Data Type
Description
Id
int
The unique ID of the season
Name
string
The name of the season
Last updated
Was this helpful?