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

Element

Data Type

Description

FixtureId

int

The unique ID of the fixture.

Fixture

object

Livescore

object

Markets

array

An array of Markets

Fixture

Element

Data Type

Description

Subscription

object

Sport

object

Location

object

League

object

StartDate

string

The fixture start date

LastUpdate

string

ISO timestamp of the last update to the provider odds

Status

enum

The current status of the fixture

Participants

array

An array of Participants

FixtureExtraData

array

An array of FixtureExtraData

ExternalFixtureId

string

Use to map fixtures to an external provider; to enable this feature, please contact your CSM.

Venue

object

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, 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 2-participant events the positions will be 1 (home) or 2 (away)

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, 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).

FixturePlayers

array

OPTIONAL: Lineup / roster information for the participant. See FixturePlayers.

ShirtColor

string

OPTIONAL: Primary shirt color of the participant.

GoalKeeperShirtColor

string

OPTIONAL: Goalkeeper shirt color of the participant.

ExtraData

array

Array of data ExtraData

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

State

object

Player's current match state. See Player State for all values.

Player

object

Full player profile. See Player.

Player State

Element

Data Type

Description

Id

int

Player state identifier. See Player State for all values.

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

Country

object

Contains the country details where the venue is located. Same values as Location

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?