Fixture
This documentation describes the complete structure of a Fixture Update message (Type 1) as delivered by TRADE.
{
"CorrelationId": "c653c8fa-04c4-4eba-a169-6ef83ce74255",
"FixtureId": 18704967,
"FixtureTypeId": 1,
"Content": {
"Name": "Shenzhen 2028 VS Jiangxi Liansheng",
"Sport": {
"Id": 6046,
"Name": "Football"
},
"Tournament": {
"Id": 12519,
"Name": "League Two",
"TournamentTypeId": 1,
"IsOutright": false,
"AgeCategory": 0,
"Gender": 1,
"Type": 1
},
"Location": {
"Id": 196,
"Name": "China"
},
"Participants": [
{
"Id": 53692068,
"Name": "Shenzhen 2028",
"Position": "1",
"IsActive": true,
"Form": "win-win-win-draw-lost",
"Formation": "4-2-3-1",
"FixturePlayers": [
{
"PlayerId": 681570,
"ShirtNumber": "55",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 681570,
"Name": "Keqi Huang",
"TeamId": 53692068,
"NationalityId": 196,
"BirthDate": "2005-11-21T10:00:00",
"Type": 0
}
}
],
"Gender": 1,
"AgeCategory": 0,
"Type": 1
},
{
"Id": 52328154,
"Name": "Jiangxi Liansheng",
"Position": "2",
"IsActive": true,
"Form": "lost-win-win-lost-draw",
"Formation": "3-4-3",
"FixturePlayers": [
{
"PlayerId": 296287,
"ShirtNumber": "17",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 296287,
"Name": "Chenguang Li",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1990-01-12T00:00:00",
"Type": 0
}
},
{
"PlayerId": 298845,
"ShirtNumber": "10",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 298845,
"Name": "Sabit Abdusalam",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1994-03-26T00:00:00",
"Type": 0
}
},
{
"PlayerId": 484197,
"ShirtNumber": "18",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 484197,
"Name": "Pengju Yang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2000-06-06T00:00:00",
"Type": 0
}
},
{
"PlayerId": 682706,
"ShirtNumber": "2",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 682706,
"Name": "Quan He",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2004-09-30T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767581,
"ShirtNumber": "11",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 767581,
"Name": "Zijian Bai",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1992-10-16T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767582,
"ShirtNumber": "8",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 767582,
"Name": "Enze Cao",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2002-10-23T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767591,
"ShirtNumber": "33",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767591,
"Name": "Song Guo",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1993-01-22T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767592,
"ShirtNumber": "19",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 767592,
"Name": "Hang Jiang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2001-06-20T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767593,
"ShirtNumber": "12",
"IsCaptain": true,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767593,
"Name": "Chen Li",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1996-11-25T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767595,
"ShirtNumber": "22",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767595,
"Name": "Jiahao Li",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2001-11-01T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767604,
"ShirtNumber": "1",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 767604,
"Name": "Junjie Liang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2001-02-13T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767607,
"ShirtNumber": "6",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767607,
"Name": "Guoqiang Liu",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2006-06-23T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767611,
"ShirtNumber": "26",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767611,
"Name": "Pi Ziyang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2004-03-28T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767612,
"ShirtNumber": "5",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767612,
"Name": "Jiwei Shi",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1995-05-07T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767614,
"ShirtNumber": "7",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767614,
"Name": "Yue Sun",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1992-12-13T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767616,
"ShirtNumber": "3",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767616,
"Name": "Hongbin Wang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2002-03-12T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767619,
"ShirtNumber": "4",
"IsCaptain": false,
"IsStartingLineup": false,
"State": {
"Id": 1,
"Name": "Benched"
},
"Player": {
"Id": 767619,
"Name": "Geeryi Zhang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "2008-02-18T10:00:00",
"Type": 0
}
},
{
"PlayerId": 767622,
"ShirtNumber": "27",
"IsCaptain": false,
"IsStartingLineup": true,
"State": {
"Id": 2,
"Name": "Playing"
},
"Player": {
"Id": 767622,
"Name": "Yanjun Zhang",
"TeamId": 52328154,
"NationalityId": 196,
"BirthDate": "1993-02-07T10:00:00",
"Type": 0
}
}
],
"Gender": 1,
"AgeCategory": 0,
"Type": 1
}
],
"StatusId": 1,
"StartDate": "2026-05-05T08:00:00",
"LastUpdate": "2026-05-05T07:34:08.0607310",
"ExtraData": [
{
"Key": "WithLivescore",
"Value": {
"Name": "WithLivescore",
"Value": "true"
}
},
{
"Key": "WithInPlay",
"Value": {
"Name": "WithInPlay",
"Value": "true"
}
}
],
"Season": {
"Id": 2032,
"Name": "2026"
},
"Round": {
"Id": 19,
"Name": "7"
}
}
}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.
Season
object
Season
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
OPTIONAL: Tour or stage within the league (Id, Name)
AgeCategory
int
OPTIONAL: Age category of the league. 0 = Regular, 1 = Youth, 2 = Reserves
Gender
int
OPTIONAL: Gender of the league. 1 = Men, 2 = Women, 3 = Mix
Type
int
OPTIONAL: League type. 1 = Club, 2 = National, 3 = Individual, 4 = Virtual, 5 = Esports, 6 = VirtuReal (deprecated — no longer issued), 7 = Doubles
NumberOfPeriods
int
OPTIONAL: Number of match periods in this league
SportCategory
object
OPTIONAL: Sport category classification (Id, Name)
Participants
Element
Data Type
Description
Id
int
The unique ID of the participant
Name
string
The name of the participant
Position
string
In standard fixtures: 1 = home, 2 = away. In outright events: sequential draw or programme number assigned to each participant.
RotationId
int
OPTIONAL: Rotation identifier for the participant
IsActive
bool
Will only show in outright events.
Gender
int
OPTIONAL: Gender of the participant. 1 = Men, 2 = Women, 3 = Mix
AgeCategory
int
OPTIONAL: Age category of the participant. 0 = Regular, 1 = Youth, 2 = Reserves
Type
int
OPTIONAL: Participant type. 1 = Club, 2 = National, 3 = Individual, 4 = Virtual, 5 = Esports, 6 = VirtuReal (deprecated — no longer issued), 7 = Doubles
Form
string
OPTIONAL: Recent form of the participant (e.g. WWDLW).
Formation
string
OPTIONAL: Tactical formation used by the participant (e.g. 4-3-3).
ShirtColor
string
OPTIONAL: Primary shirt color of the participant.
GoalKeeperShirtColor
string
OPTIONAL: Goalkeeper shirt color of the participant.
ExtraData
Element
Data Type
Description
Value
string
Representing the extra data value
Name
string
The name of extra data field
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 (Id, Name).
Player State
Element
Data Type
Description
Name
string
Player state name.
Player
Element
Data Type
Description
Id
int
Unique player identifier
Name
string
Player name
TeamId
int
ID of the player's team
NationalityId
int
Nationality identifier
BirthDate
string
Player birth date (ISO format)
Type
int
Participant type: 0 = Player, 1 = Other (non-player, non-coach), 2 = Coach
NationalityTeamId
int
National team identifier
FixtureExtraData
Element
Data Type
Description
Value
string
Representing the extra data value
Name
string
The name of extra data field
Common Name values include:
Name
Description
Attendance
Number of spectators at the fixture
Referee
Name of the match referee
Weather
Weather conditions at the fixture
NumberOfPeriods
Number of periods in the match
TourId
Identifier of the tour/round
TourName
Name of the tour/round (e.g. Matchday 15)
WithLivescore
Whether livescore data is available
WithInPlay
Whether in-play markets are available
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.
Last updated
Was this helpful?