Outright League Fixture

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

[
  {
    "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
              }
            ]
          }
        ]
      }
    }
  }
]

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

Markets

int

Markets

OutrightLeague

Element

Data Type

Description

Subscription

object

Sport

object

Location

object

Season

object

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

Last updated

Was this helpful?