Outright League Fixture

This documentation describes the complete structure of an Outright League Fixture Update message (Type 38) as delivered by TRADE.

JSON

[
  {
    "Header": {
      "Type": 38,
      "MsgSeq": 1,
      "MsgGuid": "f2e6f2b1-c737-4847-bd8f-c8505daf104f",
      "CreationDate": "2024-06-25T08:18:00.8515215Z",
      "ServerTimestamp": 1719303480851
    },
    "Body": {
      "Competition": {
        "Id": 67,
        "Name": "Premier League",
        "Type": 3,
        "Competitions": [
          {
            "Id": 2029,
            "Name": "2024/2025",
            "Type": 4,
            "Events": [
              {
                "FixtureId": 22751084,
                "OutrightLeague": {
                  "Subscription": {
                    "Type": 2,
                    "Status": 1
                  },
                  "Sport": {
                    "Id": 6046,
                    "Name": "Football"
                  },
                  "Location": {
                    "Id": 248,
                    "Name": "England"
                  },
                  "Season": {
                    "Id": 2025,
                    "Name": "2024/2025"
                  },
                  "FixtureName": "Premier League Winner 2024/2025",
                  "ExternalFixtureId": "PROVIDER_FIX_001",
                  "StartDate": "2025-06-15T18:30:00Z",
                  "EndDate": "2026-05-02T00:00:00",
                  "LastUpdate": "2025-06-15T17:00:00Z",
                  "Status": 2,
                  "Participants": [
                    {
                      "Id": 1001,
                      "Name": "Manchester United",
                      "Position": "1",
                      "RotationId": 1,
                      "IsActive": 1,
                      "Form": "WWDLW",
                      "Formation": "4-3-3",
                      "Gender": 1,
                      "AgeCategory": 1,
                      "Type": 1,
                      "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
                          }
                        }
                      ]
                    },
                    {
                      "Id": 1002,
                      "Name": "Liverpool FC",
                      "Position": "2",
                      "RotationId": 2,
                      "IsActive": 1,
                      "Form": "WLWWW",
                      "Formation": "4-2-3-1",
                      "Gender": 1,
                      "AgeCategory": 1,
                      "Type": 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
                          }
                        }
                      ]
                    }
                  ],
                  "ExtraData": [
                    {
                      "Name": "WithLivescore",
                      "Value": "false"
                    },
                    {
                      "Name": "WithInPlay",
                      "Value": "false"
                    },
                    {
                      "Name": "Attendance",
                      "Value": "85000"
                    },
                    {
                      "Name": "Referee",
                      "Value": "Michael Oliver"
                    },
                    {
                      "Name": "Weather",
                      "Value": "Sunny"
                    }
                  ]
                },
                "Livescore": null,
                "Markets": null
              }
            ]
          }
        ]
      }
    }
  }
]

XML

Model

Competition

Element	Data Type	Description
Id	int	The unique ID of the competition
Name	string	The competition name
Type	enum	Type 3 is League, Type 4 is Season
Competitons	array	Array of Competitons

Competitions

Element	Data Type	Description
Id	int	The unique ID of the competition
Name	string	The competition name
Type	enum	Type 3 is League, Type 4 is Season
Events	array	Array of Events

Events

Element	Data Type	Description
FixtureId	int	The unique ID of the fixture.
OutrightLeague	int	OutrightLeague
Livescore	int	Livescore
Markets	int	Markets

OutrightLeague

Element	Data Type	Description
Subscription	object	Subscription
Sport	object	Sport
Location	object	Location
Season	object	Season
FixtureName	string	fixture name (e.g Premier League)
StartDate	string	The competition start date
EndDate	string	The competition end 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
ExtraData	array	An array of FixtureExtraData
EndDate	String	The fixture end date

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

Season

Element	Data Type	Description
Id	int	The unique ID of the season
Name	string	The name of the season

Participant

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.

Extra Data

Element	Data Type	Description
Value	string	Representing the extra data value
Name	string	The name of extra data field