Outright Fixture

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

[
  {
    "Header": {
      "Type": 37,
      "MsgSeq": 1,
      "MsgGuid": "7b0cadae-0b61-4a3a-a739-718fd0bbce02",
      "CreationDate": "2024-06-25T14:03:24.9538493Z",
      "ServerTimestamp": 1719324204953
    },
    "Body": {
      "Competition": {
        "Id": 11217,
        "Name": "Antepost",
        "Type": 1,
        "Events": [
          {
            "FixtureId": 22751994,
            "OutrightFixture": {
              "Subscription": {
                "Type": 2,
                "Status": 1
              },

              "ExternalFixtureId": "PROVIDER_FIX_001",

              "FixtureName": "Premier League Winner 2024/2025",

              "Season": {
                "Id": 2025,
                "Name": "2024/2025"
              },

              "Sport": {
                "Id": 6046,
                "Name": "Football"
              },

              "Location": {
                "Id": 248,
                "Name": "England"
              },

              "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"
                }
              },

              "StartDate": "2025-06-15T18:30:00Z",
              "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": "WithInPlay",
                  "Value": "false"
                },
                {
                  "Name": "WithLivescore",
                  "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

Events

array

Array of Events

Events

Element

Data Type

Description

FixtureId

int

The unique ID of the fixture.

Livescore

int

Markets

int

Markets

OutrightFixture

object

OutrightFixture

OutrightFixture

Element

Data Type

Description

Subscription

object

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

Season

object

Sport

object

Location

object

Venue

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

ExtraData

array

An array of FixtureExtraData

Subscription

Element

Data Type

Description

Type

enum

Your package type

Status

enum

The current subscription status of the event in your package

Season

Element

Data Type

Description

Id

int

The unique ID of the season

Name

string

The name of the season

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

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

Venues

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?